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

Projetos que usam uma biblioteca de classes .NET usam extensões de vinculação que são instaladas no projeto como pacotes NuGet.

Os pacotes de extensões permitem que non-.NET aplicativos usem extensões de vinculação sem precisar interagir com a infraestrutura .NET.

Extension bundles

Os pacotes de extensões adicionam um conjunto predefinido de extensões de vinculação compatíveis ao seu aplicativo de função. Os pacotes de extensão são versionados. Cada versão contém um conjunto específico de extensões de vinculação que são verificadas para funcionar em conjunto. Selecione uma versão do 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.

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

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

Para projetos que usam uma biblioteca de classes C# compilada, instale os pacotes NuGet para as extensões de que precisa 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, porque o namespace difere dependendo do modelo de execução:

O Azure Functions fornece pacotes de extensão para non-.NET projetos. Esses pacotes contêm um conjunto completo de extensões de vinculação que são verificadas como compatíveis. Se estiver a ter problemas de compatibilidade entre duas ou mais extensões de ligação, reveja as combinações compatíveis de versões de extensão. Para obter as combinações suportadas de extensões de ligaçã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 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 vinculação necessárias em um arquivo de projeto C# que faça referência às extensões específicas que seu aplicativo exige.

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

1. Remova a referência ao 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 seu projeto local.

   Para desenvolvimento somente de portal, você precisa criar manualmente um extensions.csproj arquivo na raiz do seu aplicativo de função 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 de associação específica e versão que seu aplicativo exige.

4. Valide a funcionalidade do seu aplicativo localmente e, em seguida, reimplante seu projeto, incluindo extensions.csproj, em seu aplicativo de função no Azure.

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