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

Począwszy od usługi Azure Functions w wersji 2.x, środowisko uruchomieniowe funkcji domyślnie obejmuje tylko wyzwalacze HTTP i czasomierza. Inne wyzwalacze i powiązania są dostępne jako oddzielne pakiety.

Aplikacje biblioteki klas platformy .NET używają powiązań zainstalowanych w projekcie jako pakietów NuGet. Pakiety rozszerzeń umożliwiają aplikacjom funkcji non-.NET używanie tych samych powiązań bez konieczności obsługi infrastruktury platformy .NET.

Poniższa tabela wskazuje, kiedy i jak rejestrujesz powiązania.

Środowisko projektowe	Rejestracja w usłudze Functions 1.x	Rejestracja w usłudze Functions w wersji 2.x lub nowszej
Azure Portal	Automatyczne	Automatyczne*
języki Non-.NET	Automatyczne	Używanie pakietów rozszerzeń (zalecane) lub jawne instalowanie rozszerzeń
Biblioteka klas języka C# korzystająca z programu Visual Studio	Korzystanie z narzędzi NuGet	Korzystanie z narzędzi NuGet
Biblioteka klas języka C# korzystająca z programu Visual Studio Code	Nie dotyczy	Korzystanie z interfejsu wiersza polecenia platformy .NET Core Korzystanie z zestawu deweloperskiego języka C#

^* Portal używa pakietów rozszerzeń, w tym skryptu języka C#.

Pakiety rozszerzeń

Domyślnie pakiety rozszerzeń zapewniają obsługę powiązań dla funkcji w następujących językach:

• Java
• JavaScript
• PowerShell
• Python
• Skrypt języka C#
• Inne (niestandardowe programy obsługi)

W rzadkich przypadkach, w których nie można używać pakietów rozszerzeń, można jawnie zainstalować rozszerzenia powiązania w projekcie aplikacji funkcji. Pakiety rozszerzeń są obsługiwane w wersji 2.x i nowszej środowiska uruchomieniowego usługi Functions.

Pakiety rozszerzeń to sposób dodawania wstępnie zdefiniowanego zestawu 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 non-.NET Functions na podstawie narzędzi lub w portalu pakiety rozszerzeń są już włączone w pliku host.json aplikacji.

Odwołanie do pakietu rozszerzeń jest definiowane przez sekcję extensionBundle w host.json w następujący sposób:

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

W zbiorze extensionBundlesą dostępne następujące właściwości:

Właściwości	opis
id	Przestrzeń nazw zbiorów rozszerzeń usługi Microsoft Azure Functions.
version	Zakres wersji pakietu do zainstalowania. Środowisko uruchomieniowe usługi Functions zawsze wybiera maksymalnie dozwoloną wersję zdefiniowaną przez zakres wersji lub interwał. Na przykład version zakres [4.0.0, 5.0.0) wartości zezwala na wszystkie wersje pakietu z wersji 4.0.0 do 5.0.0. Aby uzyskać więcej informacji, zapoznaj się z notacją interwału na potrzeby określania zakresów wersji.

W poniższej tabeli wymieniono obecnie dostępne zakresy wersji domyślnych pakietów Microsoft.Azure.Functions.ExtensionBundle i linki do uwzględnionych rozszerzeń.

Wersja pakietu	Wersja w host.json	Dołączone rozszerzenia
1.x	[1.*, 2.0.0)	Zobacz extensions.json używane do generowania pakietu.
2.x	[2.*, 3.0.0)	Zobacz extensions.json używane do generowania pakietu.
3.x	[3.3.0, 4.0.0)	Zobacz extensions.json używane do generowania pakietu.
4.x	[4.0.0, 5.0.0)	Zobacz extensions.json używane do generowania pakietu.

Uwaga

Mimo że host.json obsługuje niestandardowe zakresy dla versionprogramu , należy użyć wartości zakresu wersji z tej tabeli, takiej jak [4.0.0, 5.0.0). Aby uzyskać pełną listę wersji pakietów rozszerzeń i wersji rozszerzeń w każdej wersji, zobacz stronę wydania pakietów rozszerzeń.

Jawne instalowanie rozszerzeń

W przypadku skompilowanych projektów bibliotek klas języka C# (proces procesów roboczych izolowanych) należy zainstalować pakiety NuGet dla potrzebnych rozszerzeń, tak jak zwykle. Przykłady można znaleźć w przewodniku dla deweloperów programu Visual Studio Code lub przewodniku dla deweloperów programu Visual Studio. Zobacz stronę wydania pakietów rozszerzeń, aby przejrzeć kombinacje wersji rozszerzeń, które są zweryfikowane zgodne.

W przypadku języków non-.NET i skryptu języka C#, jeśli nie można używać pakietów rozszerzeń, należy ręcznie zainstalować wymagane rozszerzenia powiązań w projekcie lokalnym. Najprostszym sposobem jest użycie narzędzi Azure Functions Core Tools. Aby uzyskać więcej informacji, zobacz instalowanie rozszerzeń func.

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

Następne kroki

Przykład wyzwalacza i powiązania funkcji platformy Azure