Rejestrowanie rozszerzeń powiązań usługi Azure Functions

Środowisko uruchomieniowe usługi Azure Functions natywnie uruchamia wyzwalacze HTTP i czasomierza. Zachowania innych obsługiwanych wyzwalaczy i powiązań są implementowane w oddzielnych pakietach rozszerzeń.

Projekty bibliotek klas platformy .NET używają rozszerzeń powiązań zainstalowanych w projekcie jako pakietów NuGet.

Pakiety rozszerzeń umożliwiają non-.NET aplikacjom korzystanie z rozszerzeń powiązań bez konieczności interakcji z infrastrukturą platformy .NET.

Pakiety rozszerzeń

Pakiety rozszerzeń dodają wstępnie zdefiniowany zestaw zgodnych rozszerzeń powiązań do aplikacji funkcji. Pakiety rozszerzeń są wersjonowane. Każda wersja zawiera określony zestaw rozszerzeń powiązań, które są weryfikowane do współpracy. Wybierz wersję pakietu na podstawie potrzebnych rozszerzeń w aplikacji.

Podczas tworzenia projektu usługi Azure Functions na podstawie szablonu non-.NET pakiety rozszerzeń są już włączone w pliku host.json aplikacji.

Jeśli to możliwe, użyj najnowszego zakresu wersji, aby uzyskać optymalną wydajność aplikacji i dostęp do najnowszych funkcji. Aby dowiedzieć się więcej o pakietach rozszerzeń, zobacz Pakiety rozszerzeń usługi Azure Functions.

W mało prawdopodobnym przypadku nie można użyć pakietu rozszerzeń, zamiast tego należy jawnie zainstalować rozszerzenia.

Jawne instalowanie rozszerzeń

W przypadku skompilowanych projektów bibliotek klas języka C# należy zainstalować pakiety NuGet dla potrzebnych rozszerzeń, jak zwykle w aplikacjach. Aby uzyskać więcej informacji, zobacz przewodnik dla deweloperów programu Visual Studio Code lub przewodnik dla deweloperów programu Visual Studio.

Upewnij się, że uzyskasz prawidłowy pakiet, ponieważ przestrzeń nazw różni się w zależności od modelu wykonywania:

Model wykonania	Namespace
Izolowany proces roboczy	Microsoft.Azure.Functions.Worker.Extensions.*
W trakcie	Microsoft.Azure.WebJobs.Extensions.*

Funkcje udostępniają pakiety rozszerzeń dla projektów non-.NET, które zawierają pełny zestaw rozszerzeń powiązań, które są weryfikowane jako zgodne. Jeśli występują problemy ze zgodnością między co najmniej dwoma rozszerzeniami powiązań, sprawdź zgodne kombinacje wersji rozszerzeń. Aby uzyskać informacje o obsługiwanych kombinacjach rozszerzeń powiązań, zobacz stronę wydania pakietów rozszerzeń.

Istnieją przypadki, w których nie można używać pakietów rozszerzeń, takich jak w przypadku konieczności użycia określonej wersji wstępnej określonego rozszerzenia. W tych rzadkich przypadkach należy ręcznie zainstalować wszystkie wymagane rozszerzenia powiązania w pliku projektu języka C#, który odwołuje się do określonych rozszerzeń wymaganych przez aplikację. Aby ręcznie zainstalować rozszerzenia powiązań:

1. Usuń odwołanie do pakietu rozszerzeń z pliku host.json .

2. Użyj polecenia func extensions install w Azure Functions Core Tools, aby wygenerować wymagany plik extensions.csproj w katalogu głównym lokalnego projektu.

   W przypadku programowania tylko w portalu należy ręcznie utworzyć plik extensions.csproj w katalogu głównym aplikacji funkcji na platformie Azure. Aby dowiedzieć się więcej, zobacz Ręczne instalowanie rozszerzeń.

3. Edytuj plik extensions.csproj , jawnie dodając PackageReference element dla każdego określonego rozszerzenia powiązania i wersji wymaganej przez aplikację.

4. Zweryfikuj funkcje aplikacji lokalnie, a następnie ponownie wdróż projekt, w tym extensions.csproj, do aplikacji funkcji na platformie Azure.

Jak najszybciej należy przełączyć aplikację z powrotem na najnowszą obsługiwaną wersję pakietu rozszerzeń.

Następne kroki

Przykład wyzwalacza i powiązania funkcji platformy Azure