Sady rozšíření Azure Functions

Tento článek vysvětluje, jak sady rozšíření umožňují kódu funkce používat všechny triggery a vazby, které Azure Functions podporuje. Dozvíte se také o úrovních a zásadách podpory pro vaše aplikace, když používáte sady rozšíření.

Tento článek se týká jenom vývojářů Azure Functions, kteří používají non-.NET jazyky. Informace o tom, jak přidat rozšíření vazeb přímo do funkčních aplikací v jazyce C#, najdete v části Registrace rozšíření vazeb Azure Functions.

Overview

Sady rozšíření přidávají do aplikace funkcí předdefinovanou sadu kompatibilních rozšíření vazeb. Sada obsahuje všechna rozšíření vazeb aktuálně podporovaná službou Functions. Sady rozšíření jsou verze. Každá verze obsahuje určitou sadu verzí rozšíření vazeb, které jsou ověřené tak, aby spolupracovaly.

Pokud je to možné, měli byste ve své aplikaci vždy používat nejnovější verzi sady.

Při vytváření projektu Azure Functions ze šablony non-.NET jsou v souboru aplikace host.json už povolené sady rozšíření.

Definovat odkaz na balík rozšíření

Odkaz na sadu rozšíření definujete v host.json souboru projektu přidáním oddílu extensionBundle , jak je znázorněno v tomto příkladu:

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

V tomto příkladu version hodnota [4.0.0, 5.0.0) dává hostiteli Functions pokyn, aby používal verzi sady, která je alespoň 4.0.0 , ale menší než 5.0.0, která zahrnuje všechny potenciální verze 4.x. Tato notace efektivně udržuje vaši aplikaci na nejnovější dostupné podverzi sady rozšíření v4.x.

V objektu extensionBundle jsou k dispozici následující vlastnosti:

Property	Description
id	Obor názvů pro sady rozšíření Azure Functions.
version	Rozsah verzí sady, která se má nainstalovat. Modul runtime Azure Functions vždy zvolí maximální povolenou verzi, kterou definuje rozsah verzí nebo interval. Například version rozsah [4.0.0, 5.0.0) hodnot umožňuje všechny verze sady od 4.0.0 do (ale ne včetně) 5.0.0. Další informace najdete v části věnované zápisu intervalů pro zadávání rozsahů verzí.

Návod

Můžete také vidět rozsah verzí definovaný ve vašem host.json jako [4.*, 5.0.0), který je interpretován stejně jako [4.0.0, 5.0.0).

Verze sady prostředků

Tato tabulka uvádí všechny Microsoft.Azure.Functions.ExtensionBundle verze a aktuální stav podpory:

Verze sady prostředků	Verze v host.json	Stav podpory*
4.x	[4.0.0, 5.0.0) [4.*, 5.0.0)	Active
3.x	[3.3.0, 4.0.0)	Nedoporučované
2.x	[2.*, 3.0.0)	Nedoporučované
1.x	[1.*, 2.0.0)	Nedoporučované

^* Zastaralé verze sady prostředků můžou obsahovat zastaralé verze rozšíření vazeb. Pokud chcete zajistit optimální podporu a spolehlivost, měli byste upgradovat na sadu verzí 4.x.

Ve výchozím nastavení jsou sady rozšíření definovány prostřednictvím rozsahů verzí, což zaručuje, že se používá nejnovější podverze sady. Výběrem odkazu na verzi v tabulce zkontrolujte extensions.json soubor, který definuje nejnovější sadu pro danou hlavní verzi.

Důležité informace o sadách rozšíření

Při práci se sadami rozšíření mějte na paměti tyto aspekty:

• Pokud je to možné, měli byste nastavit version hodnotu host.json rozsahu z předchozí tabulky, například [4.0.0, 5.0.0)místo definování vlastní oblasti.
• Pomocí nejnovějšího rozsahu verzí získáte optimální výkon aplikace a přístup k nejnovějším funkcím.
• V nepravděpodobném případě, že nemůžete použít sadu rozšíření, musíte místo toho explicitně nainstalovat rozšíření.
• Při aktualizaci rozšíření používaných nasazenou aplikací služba Functions stáhne nové verze rozšíření z koncového cdn.functions.azure.com bodu. Aby aktualizace rozšíření proběhly úspěšně, koncový bod cdn.functions.azure.com musí být přístupný vaší funkční aplikaci.

Upgrade balíčky rozšíření

Je důležité udržovat verzi vašeho balíčku aktuální, aby vaše aplikace mohly i nadále splňovat podmínky pro nové funkce, bezpečnostní záplaty a optimalizace výkonu.

Pokud chcete aplikaci upgradovat na nejnovější sadu, upravte soubor host.json v kořenovém adresáři projektu aplikace. Nastavte hodnotu na extensionBundle.versionhodnotu [4.0.0,5.0.0) , která by měla v souboru host.json vypadat takto:

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

Při upgradu verze sady rozšíření používané vaší aplikací mějte na paměti tyto aspekty:

• Obsah nejnovější sady 4.x najdete vždy na této stránce verze v úložišti.
• Projděte si referenční dokumentaci pro všechna rozšíření používaná vaší aplikací a vyhledejte případné zásadní změny mezi verzemi. Seznam verzí rozšíření zahrnutých ve výchozí sadě najdete v extension.json souboru projektu propojeném z této tabulky. Na stránce vydaných verzí sady v úložišti sad můžete zkontrolovat konkrétní značky verzí sady.
• Po upgradu verze sady prostředků vždy ověřte aplikaci místně, abyste zajistili kompatibilitu s aktualizovanými rozšířeními. K místnímu spuštění aplikace funkcí můžete použít příkaz func start v Azure Functions Core Tools nebo F5 v sadě Visual Studio nebo Visual Studio Code.
• Způsob, jakým aktivujete aktualizaci rozšíření na základě změn verze sady v souboru host.json, závisí na prostředí vaší aplikace:
  • Místní projekt: Rozšíření se aktualizují místně při spuštění nástrojů Core Tools, a to buď z func start příkazu, nebo při ladění ve vývojových nástrojích.
  • Aplikace funkcí: Rozšíření se aktualizují při nasazení aktualizovaného souboru host.json do aplikace funkcí v Azure.

Zásady podpory sad rozšíření

K vydání hlavní verze sady rozšíření může dojít, když dojde k zásadním změnám v některé z rozšíření vazby obsažených. Tyto zásadní změny rozšíření vyžadují, aby aktualizace sady SDK zůstaly kompatibilní se základními sadami AZURE SDK. Upgradem sady zajistíte, že vaše aplikace budou dál dostávat nové funkce, vylepšení výkonu a plnou podporu produktů.

Poznámka:

Vzhledem k tomu, že aktualizace sad rozšíření jsou řízené aktualizacemi v podkladových sadách Azure SDK, cyklus podpory pro sady rozšíření se obecně řídí zásadami podpory základních sad Azure SDK.

Microsoft vás upozorní, když je sada rozšíření nebo verze rozšíření vazby zastaralá. Tato oznámení se můžou zobrazovat v různých částech prostředí služby Functions, například v protokolech hostitelů, tabulkách Application Insights nebo na webu Azure Portal. Když narazíte na tato oznámení, musíte zahájit proces plánování a upgradu aplikací funkcí na nejnovější podporovanou verzi sady rozšíření.

Cyklus podpory sad rozšíření se řídí těmito odlišnými fázemi:

Phase	Description
Preview	Předběžné verze konkrétních rozšíření vazeb se udržují v sadě rozšíření preview (Microsoft.Azure.Functions.ExtensionBundle.Preview). Tuto sadu předběžných rozšíření můžete použít, abyste mohli využít předběžná rozšíření a nové chování existujících rozšíření, než se stanou obecně dostupnými (GA). Další informace najdete v tématu Práce se sadami rozšíření Preview.
Aktivní	Nejnovější hlavní verze sad rozšíření se považuje za aktivní verzi. Tuto verzi doporučujeme pro vaše aplikace funkcí.
Zavrhování	Verze sady je nahrazena novější verzí a je nyní zastaralá. Jakmile je sada zastaralá, obdrží pouze kritické opravy chyb a aktualizace zabezpečení po omezenou dobu překrytí. To se obvykle překrývají nejméně 12 měsíců, což vám dává čas naplánovat, otestovat a upgradovat aplikace na nejnovější verzi sady. Aplikace funkcí, které nadále používají zastaralou sadu, se stále můžou spouštět na platformě. Pokud ale chcete zajistit přístup k novým funkcím, vylepšením výkonu, opravám zabezpečení a úplné podpoře, musíte upgradovat aplikace funkcí na podporovanou verzi sady.

Verze sad rozšíření a jejich zahrnutá rozšíření můžete zobrazit v úložišti sad rozšíření Azure Functions. Můžete si také prohlédnout stránku vydaných verzí sady Azure SDK pro inventář všech rozšíření Functions. Jednotlivé balíčky .NET najdete na NuGet.org.

Práce se sadami rozšíření preview

Mějte na paměti tyto aspekty, když se rozhodnete použít sadu rozšíření, která není obecně dostupná:

• Sady Preview můžou zahrnovat funkce, které jsou stále ve vývoji a ještě nejsou připravené pro produkční použití. Jsou určené k vyhodnocení a testování v neprodukčních prostředích.
• Mezi verzemi Preview dochází k zásadním změnám bez předchozího upozornění. Můžou zahrnovat změny v:
  • Definice spouštěčů a vazeb
  • Rozšíření zahrnutá ve verzi Preview.
  • Charakteristiky výkonu a stabilita.
• Aktualizace zabezpečení můžou vyžadovat upgrade verzí.
• V neprodukčních prostředích musíte zcela otestovat sady Preview a vyhnout se používání sad Preview v produkčním prostředí. Pokud musíte v produkčním prostředí použít sadu Preview, proveďte tato další opatření:
  • Připněte sadu na konkrétní dobře otestovanou verzi sady místo na rozsah. Připnutí zabraňuje automatickému upgradu verze sady, než budete mít možnost ověřit aktualizaci v neprodukčním prostředí.
  • Jakmile bude funkce dostupná v plně podporované verzi sady prostředků, přesuňte aplikaci na verzi sady GA.
• Pokud chcete mít přehled o aktualizacích balíčků, včetně přechodu z verze Preview na obecně dostupnou verzi, měli byste:
  • Sledujte vydání verzí sad náhledů na stránce s vydáními pro sady rozšíření.
  • Monitorování referenční dokumentace specifické pro rozšíření
  • Zkontrolujte verze balíčků NuGet konkrétních rozšíření preview, která používáte.
  • Sledujte významné aktualizace nebo změny v protokolech změn publikovaných na NuGet.org pro každé rozšíření Preview.

Související obsah

• Další informace o rozšířeních vazeb najdete v tématu Registrace rozšíření vazeb Azure Functions.