Compartilhar via

Registrar extensões de associação do Azure Functions

  • Artigo

Começando com Azure Functions versão 2.x, o tempo de execução do Functions inclui apenas gatilhos HTTP e Timer por padrão. Outros gatilhos e associações estão disponíveis como pacotes separados.

Os aplicativos de funções da biblioteca de classes .NET usam associações que estão instaladas no projeto como pacotes NuGet. Os pacotes de extensão permitem que os aplicativos de funções não .NET usem as mesmas associações sem a necessidade de lidar com a infraestrutura do .NET.

A tabela a seguir indica quando e como registrar as associações.

Ambiente de desenvolvimento Registro
em funções de 1. x		 Registro
no Functions 2.x ou posterior
Portal do Azure Automática Automática*
Linguagens não .NET Automática Usar pacotes de extensão (recomendado) ou instalar extensões explicitamente
Biblioteca de classes C# usando o Visual Studio Usar as ferramentas do NuGet Usar as ferramentas do NuGet
Biblioteca de classes C# usando o código do Visual Studio N/D Use o .NET Core CLI
Usar o Kit de Desenvolvimento C#

* O Portal usa pacotes de extensão, incluindo o script C#.

pacotes de extensão

Por padrão, os pacotes de extensão fornecem suporte de associação para funções nestas linguagens:

  • Java
  • JavaScript
  • PowerShell
  • Python
  • Script C#
  • Outros (manipuladores personalizados)

Em casos raros em que os pacotes de extensão não podem ser usados, você pode instalar explicitamente extensões de associação com seu projeto de aplicativo de funções. Há suporte para pacotes de extensão para a versão 2.x e posterior do runtime do Functions.

Os pacotes de extensão permitem que você adicione um conjunto predefinido de extensões de associação compatíveis ao aplicativo de funções. Os pacotes de extensão têm controle de versão. Cada versão contém um conjunto específico de extensões de ligação que são verificadas para funcionar em conjunto. Selecione uma versão de pacote com base nas extensões que você precisa em seu aplicativo.

Quando você cria um projeto non-.NET Functions a partir de ferramentas ou no portal, os pacotes de extensão já estão habilitados no arquivo host.json do aplicativo.

Uma referência de pacote de extensão é definida pela seção extensionBundle em um host.json da seguinte maneira:

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

As propriedades a seguir estão disponíveis em extensionBundle:

Propriedade Descrição
id O namespace dos pacotes de extensão do Microsoft Azure Functions.
version O intervalo de versão do pacote a ser instalado. O runtime do Functions sempre escolhe a versão máxima permitida definida pelo intervalo de versões. Por exemplo, um intervalo de valores version de [4.0.0, 5.0.0) permite todas as versões de pacote de 4.0.0 até antes de 5.0.0. Para obter mais informações, confira a notação de intervalo para especificar intervalos de versões.

A tabela a seguir lista os intervalos de versão disponíveis no momento do pacote Padrão Microsoft.Azure.Functions.ExtensionBundle e links para as extensões que elas incluem.

Versão do pacote Versão no host.json Extensões incluídas
1.x [1.*, 2.0.0) Consulte extensions.json usado para gerar o pacote.
2. x [2.*, 3.0.0) Consulte extensions.json usado para gerar o pacote.
3.x [3.3.0, 4.0.0) Consulte extensions.json usado para gerar o pacote.
4.x [4.0.0, 5.0.0) Consulte extensions.json usado para gerar o pacote.

Observação

Mesmo que o host.json dê suporte a intervalos personalizados para version, você deve usar um valor de intervalo de versão dessa tabela, como [4.0.0, 5.0.0). Para obter uma lista completa de versões de pacotes de extensão e versões de extensão em cada versão, consulte a página de versão de pacotes de extensão.

Instalar extensões explicitamente

Para projetos de biblioteca de classes C# compilados (em processo e processo de trabalho isolado), instale os pacotes de NuGet para as extensões de que você precisa normalmente. Para obter exemplos, consulte o Guia do desenvolvedor do Visual Studio Code ou o Guia do desenvolvedor do Visual Studio. Consulte a página de lançamento de pacotes de extensão para revisar as combinações de versões de extensão que são verificadas como compatíveis.

Para non-.NET idiomas e script C#, quando você não pode usar pacotes de extensão, instale manualmente as extensões de associação necessárias no projeto local. A maneira mais fácil é usar o Azure Functions Core Tools. Para obter mais informações, consulte func extensions install.

Para desenvolvimento somente portal, você precisa criar manualmente um arquivo extensions.csproj na raiz do aplicativo de funções. Para saber mais, consulte Instalar extensões manualmente.

Próximas etapas

Exemplo de gatilho e associação do Azure Functions