Compartilhar via

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

O Azure Functions Runtime executa nativamente gatilhos HTTP e temporizador. Os comportamentos dos outros gatilhos e associações compatíveis são implementados em pacotes de extensão separados.

Os projetos que usam uma biblioteca de classes do .NET usam extensões de associação instaladas no projeto como pacotes NuGet.

Os pacotes de extensão permitem que aplicativos não .NET utilizem extensões de associação sem precisar interagir com a infraestrutura .NET.

Extension bundles

Os pacotes de extensões adicionam um conjunto predefinido de extensões de associação compatíveis ao seu 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 do Azure Functions a partir de um modelo de non-.NET, os pacotes de extensão já estão habilitados no arquivo do host.json aplicativo.

Quando possível, use o intervalo de versões mais recente para obter o desempenho ideal do aplicativo e o acesso aos recursos mais recentes. Para saber mais sobre pacotes de extensão, consulte os pacotes de extensão do Azure Functions.

No caso improvável de não poder usar um pacote de extensão, você deve instalar explicitamente as extensões.

Instalar extensões explicitamente

Para projetos que usam uma biblioteca de classes C# compilada, instale os pacotes NuGet para as extensões necessárias como faria normalmente em seus aplicativos. Para obter mais informações, consulte o guia do desenvolvedor do Visual Studio Code ou o guia do desenvolvedor do Visual Studio.

Certifique-se de obter o pacote correto, pois o namespace é diferente dependendo do modelo de execução:

Execution model Namespace
Processo de trabalho isolado Microsoft.Azure.Functions.Worker.Extensions.*
In-process Microsoft.Azure.WebJobs.Extensions.*

O Azure Functions fornece pacotes de extensão para projetos non-.NET. Esses pacotes contêm um conjunto completo de extensões de associação que são verificadas como compatíveis. Se você estiver tendo problemas de compatibilidade entre duas ou mais extensões de associação, examine combinações compatíveis de versões de extensão. Para obter combinações suportadas de extensões de vinculação, consulte a página de lançamento para pacotes de extensão.

Há casos em que você não pode usar pacotes de extensão, como quando você precisa usar uma versão de pré-lançamento específica de uma extensão específica. Nesses casos raros, você deve instalar manualmente todas as extensões de associação necessárias em um arquivo de projeto C# que faça referência às extensões específicas necessárias ao aplicativo.

Para instalar manualmente extensões de associação:

  1. Remova a referência do pacote de extensão do arquivo host.json.

  2. Use o func extensions install comando nas Ferramentas Principais do Azure Functions para gerar o arquivo necessário extensions.csproj na raiz do projeto local.

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

  3. Edite o extensions.csproj arquivo adicionando explicitamente um PackageReference elemento para cada extensão e versão de associação específicas que seu aplicativo requer.

  4. Valide a funcionalidade do aplicativo localmente e reimplante seu projeto, incluindo extensions.csproj, para seu aplicativo de funções no Azure.

Assim que possível, você deve mudar seu aplicativo de volta para usar o pacote de extensão mais recente com suporte.

Related content

  • Last updated on