Sdílet prostřednictvím

Registrace rozšíření vazeb Azure Functions

Modul runtime Azure Functions nativně spouští triggery HTTP a časovače. Chování ostatních podporovaných triggerů a vazeb se implementuje v samostatných balíčcích rozšíření.

Projekty, které používají knihovnu tříd .NET, používají rozšíření vazeb, která jsou v projektu nainstalována jako balíčky NuGet.

Sady rozšíření umožňují non-.NET aplikacím používat rozšíření vazeb bez nutnosti pracovat s infrastrukturou .NET.

Extension bundles

Sady rozšíření přidávají do aplikace funkcí předdefinovanou 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.

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

Pokud je to možné, získejte optimální výkon aplikace a přístup k nejnovějším funkcím pomocí nejnovějšího rozsahu verzí. Další informace o sadách rozšíření najdete v tématu Sady rozšíření Azure Functions.

V nepravděpodobném případě, že nemůžete použít sadu rozšíření, musíte místo toho explicitně nainstalovat rozšíření.

Explicitní instalace rozšíření

Pro projekty, které používají kompilovanou knihovnu tříd jazyka C#, nainstalujete balíčky NuGet pro rozšíření, která potřebujete, jak byste normálně používali ve svých aplikacích. Další informace 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.

Ujistěte se, že získáte správný balíček, protože obor názvů se liší v závislosti na modelu spuštění:

Execution model Namespace
Izolovaný pracovní proces Microsoft.Azure.Functions.Worker.Extensions.*
In-process Microsoft.Azure.WebJobs.Extensions.*

Azure Functions poskytuje sady rozšíření pro non-.NET projekty. Tyto sady obsahují úplnou sadu rozšíření vazeb, která mají ověřenou kompatibilitu. Pokud máte problémy s kompatibilitou mezi dvěma nebo více rozšířeními vazeb, zkontrolujte kompatibilní kombinace verzí rozšíření. Podporované kombinace rozšíření vazeb najdete na stránce verze rozšíření.

Existují případy, kdy nemůžete použít sady rozšíření, například když potřebujete použít konkrétní předběžnou verzi konkrétního rozšíření. V těchto výjimečných případech musíte ručně nainstalovat všechna požadovaná rozšíření vazeb do souboru projektu jazyka C#, která odkazují na konkrétní rozšíření, která vaše aplikace vyžaduje.

Ruční instalace vazebních rozšíření:

  1. Odeberte odkaz na sadu rozšíření ze souboru host.json.

  2. func extensions install Pomocí příkazu v Azure Functions Core Tools vygenerujte požadovaný extensions.csproj soubor v kořenovém adresáři místního projektu.

    Pro vývoj jenom na portálu je potřeba ručně vytvořit extensions.csproj soubor v kořenovém adresáři aplikace funkcí v Azure. Další informace najdete v tématu Ruční instalace rozšíření.

  3. Upravte soubor extensions.csproj tak, že explicitně přidáte prvek PackageReference pro každé konkrétní rozšíření a verzi vazeb, které vaše aplikace vyžaduje.

  4. Ověřte funkčnost aplikace místně a pak projekt znovu nasaďte, včetně extensions.csproj, do aplikace funkcí v Azure.

Co nejdříve byste měli aplikaci přepnout zpátky na používání nejnovější podporované sady rozšíření.

Related content

  • Last updated on