Udostępnij za pomocą

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 korzystające z biblioteki 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.

Extension bundles

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 aplikacji host.json .

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, w którym nie można użyć pakietu rozszerzeń, należy jawnie zainstalować rozszerzenia.

Jawne instalowanie rozszerzeń

W przypadku projektów korzystających z skompilowanej biblioteki klas języka C# należy zainstalować pakiety NuGet dla potrzebnych rozszerzeń, tak 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:

Execution model Namespace
Izolowany proces roboczy Microsoft.Azure.Functions.Worker.Extensions.*
In-process Microsoft.Azure.WebJobs.Extensions.*

Usługa Azure Functions udostępnia pakiety rozszerzeń dla projektów non-.NET. Te pakiety 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ć obsługiwane kombinacje rozszerzeń powiązań, zobacz stronę wydania dla 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 takich 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 narzędziach Azure Functions Core Tools, aby w katalogu głównym swojego lokalnego projektu wygenerować wymagany plik extensions.csproj.

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

  3. Edytuj plik extensions.csproj poprzez jawne dodanie elementu PackageReference dla każdej określonej wersji i rozszerzenia powiązania, które są wymagane 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ń.

Related content

  • Last updated on