Registrace rozšíření vazeb Azure Functions
Počínaje službou Azure Functions verze 2.x modul runtime functions ve výchozím nastavení zahrnuje pouze triggery HTTP a časovače. Další triggery a vazby jsou k dispozici jako samostatné balíčky.
Aplikace funkcí knihovny tříd .NET používají vazby nainstalované v projektu jako balíčky NuGet. Sady rozšíření umožňují non-.NET aplikacím functions používat stejné vazby bez nutnosti zabývat se infrastrukturou .NET.
Následující tabulka uvádí, kdy a jak registrovat vazby.
| Vývojové prostředí | Registrace in Functions 1.x |
Registrace ve funkcích 2.x nebo novějších |
|---|---|---|
| portál Azure | Automatic (Automaticky) | Automatický* |
| jazyky Non-.NET | Automatic (Automaticky) | Použití sad rozšíření (doporučeno) nebo explicitní instalace rozšíření |
| Knihovna tříd jazyka C# pomocí sady Visual Studio | Použití nástrojů NuGet | Použití nástrojů NuGet |
| Knihovna tříd jazyka C# pomocí editoru Visual Studio Code | – | Použití .NET Core CLI Použití sady C# Dev Kit |
* Portál používá sady rozšíření, včetně skriptu jazyka C#.
Sady rozšíření
Sady rozšíření ve výchozím nastavení poskytují podporu vazeb pro funkce v těchto jazycích:
- Java
- JavaScript
- PowerShell
- Python
- Skript jazyka C#
- Jiné (vlastní obslužné rutiny)
Ve výjimečných případech, kdy se sady rozšíření nedají použít, můžete explicitně nainstalovat rozšíření vazeb pomocí projektu aplikace funkcí. Sady rozšíření jsou podporované pro verzi 2.x a novější verzi modulu runtime Functions.
Sady rozšíření představují způsob, jak do aplikace funkcí přidat předem definovanou sadu kompatibilních rozšíření vazeb. Sady rozšíření jsou verze. Každá verze obsahuje určitou sadu rozšíření vazeb, která jsou ověřená tak, aby spolupracovala. Vyberte verzi sady prostředků na základě rozšíření, která potřebujete v aplikaci.
Když vytvoříte projekt non-.NET Functions z nástrojů nebo na portálu, sady rozšíření jsou už povolené v souboru host.json aplikace.
Odkaz na sadu rozšíření je definován oddílem extensionBundle v host.json následujícím způsobem:
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle",
"version": "[4.0.0, 5.0.0)"
}
}
V objektu extensionBundle jsou k dispozici následující vlastnosti:
| Vlastnost | Popis |
|---|---|
id |
Obor názvů pro sady rozšíření Microsoft Azure Functions |
version |
Rozsah verzí sady, která se má nainstalovat. Modul runtime služby Functions vždy vybere maximální přípustnou verzi definovanou rozsahem nebo intervalem verzí. Například version rozsah [4.0.0, 5.0.0) hodnot umožňuje všechny verze sady z verze 4.0.0 až do 5.0.0, ale nezahrnuje 5.0.0. Další informace najdete v části věnované zápisu intervalů pro zadávání rozsahů verzí. |
Následující tabulka uvádí aktuálně dostupné rozsahy verzí výchozích sad Microsoft.Azure.Functions.ExtensionBundle a odkazy na rozšíření, která zahrnují.
| Verze sady prostředků | Verze v host.json | Zahrnutá rozšíření |
|---|---|---|
| 1.x | [1.*, 2.0.0) |
Viz extensions.json použité k vygenerování sady. |
| 2.x | [2.*, 3.0.0) |
Viz extensions.json použité k vygenerování sady. |
| 3.x | [3.3.0, 4.0.0) |
Viz extensions.json použité k vygenerování sady. |
| 4.x | [4.0.0, 5.0.0) |
Viz extensions.json použité k vygenerování sady. |
Poznámka:
I když host.json podporuje vlastní rozsahy version, měli byste použít hodnotu rozsahu verzí z této tabulky, například [4.0.0, 5.0.0). Úplný seznam verzí sady rozšíření a verzí rozšíření v jednotlivých verzích najdete na stránce verze sady rozšíření.
Explicitní instalace rozšíření
Pro zkompilované projekty knihovny tříd jazyka C# (proces v procesu a izolovaný pracovní proces) nainstalujete balíčky NuGet pro rozšíření, která potřebujete normálně. Příklady najdete v příručce pro vývojáře editoru Visual Studio Code nebo v příručce pro vývojáře sady Visual Studio. Podívejte se na stránku vydané verze sady rozšíření a zkontrolujte kombinace verzí rozšíření, které jsou ověřené kompatibilní.
Pokud pro non-.NET jazyky a skript jazyka C# nemůžete použít sady rozšíření, musíte do místního projektu ručně nainstalovat požadovaná rozšíření vazeb. Nejjednodušším způsobem je použít Azure Functions Core Tools. Další informace najdete v tématu instalace rozšíření func.
Pro vývoj jenom na portálu je potřeba ručně vytvořit soubor extensions.csproj v kořenovém adresáři aplikace funkcí. Další informace najdete v tématu Ruční instalace rozšíření.