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 |
* Portal używa pakietów rozszerzeń, w tym skryptu języka C#.
Pakiety rozszerzeń
Domyślnie pakiety rozszerzeń są używane przez aplikacje java, JavaScript, PowerShell, Python, C# i Niestandardowe funkcje obsługi do pracy z rozszerzeniami powiązań. W przypadkach, gdy nie można używać pakietów rozszerzeń, można jawnie zainstalować rozszerzenia powiązań 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ę extensionBundlew 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).
Jawne instalowanie rozszerzeń
W przypadku skompilowanych projektów bibliotek klas języka C# (proces procesów roboczychizolowanych) 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.
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ń.