Příručka pro vývojáře Azure Functions

Ve Azure Functions všechny funkce sdílejí některé základní technické koncepty a komponenty bez ohledu na preferovaný jazyk nebo vývojové prostředí. Tento článek je specifický pro jazyk. V horní části článku zvolte preferovaný jazyk.

Tento článek předpokládá, že jste již četli přehled Azure Functions.

Pokud chcete rovnou začít, můžete absolvovat rychlý úvodní kurz pomocí Visual Studio, Visual Studio Code nebo z příkazové výzvy.

Pokud chcete rovnou začít, můžete absolvovat rychlý úvodní kurz pomocí Maven (příkazový řádek), Eclipse, IntelliJ IDEA, Gradle, Quarkus, Spring Cloud, nebo Visual Studio Code.

Pokud chcete rovnou začít, můžete absolvovat rychlý úvodní kurz pomocí Visual Studio Code nebo z příkazové výzvy.

Pokud chcete rovnou začít, můžete absolvovat rychlý úvodní kurz pomocí Visual Studio Code nebo z příkazové výzvy.

Pokud chcete rovnou začít, můžete absolvovat rychlý úvodní kurz pomocí Visual Studio Code nebo z příkazové výzvy.

Pokud chcete rovnou začít, můžete absolvovat rychlý úvodní kurz pomocí Visual Studio Code nebo z příkazové výzvy.

Projekt kódu

Jádrem Azure Functions je projekt kódu specifický pro jazyk, který implementuje jednu nebo více jednotek provádění kódu, které se nazývají functions. Funkce jsou jednoduše metody, které běží v cloudu Azure na základě událostí, v reakci na požadavky HTTP nebo podle plánu. Projekt kódu Azure Functions si můžete představit jako mechanismus pro uspořádání, nasazování a souhrnnou správu jednotlivých funkcí v projektu, když běží v Azure. Další informace najdete v tématu Uspořádání funkcí.

Způsob, jakým rozložíte projekt kódu a jak určíte, které metody v projektu jsou funkcemi, závisí na vývojovém jazyce projektu. Podrobné pokyny pro konkrétní jazyk najdete v příručce pro vývojáře v jazyce C#.

Způsob, jakým rozložíte projekt kódu a jak určíte, které metody v projektu jsou funkcemi, závisí na vývojovém jazyce projektu. Pokyny pro konkrétní jazyk najdete v příručce pro vývojáře Java.

Způsob, jakým rozložíte projekt kódu a jak určíte, které metody v projektu jsou funkcemi, závisí na vývojovém jazyce projektu. Pokyny pro konkrétní jazyk najdete v průvodci Node.js vývojáři.

Způsob, jakým rozložíte projekt kódu a jak určíte, které metody v projektu jsou funkcemi, závisí na vývojovém jazyce projektu. Pokyny pro konkrétní jazyk najdete v příručce pro vývojáře PowerShellu.

Způsob, jakým rozložíte projekt kódu a jak určíte, které metody v projektu jsou funkcemi, závisí na vývojovém jazyce projektu. Pokyny pro konkrétní jazyk najdete v příručce pro vývojáře Python.

Způsob, jakým rozložíte projekt kódu a jak určíte, které metody v projektu jsou funkcemi, závisí na vývojovém jazyce projektu. Pro pokyny specifické pro jazyk viz průvodce pro vývojáře Go.

Všechny funkce musí mít aktivační událost, která definuje, jak se funkce spustí, a může funkci poskytnout vstup. Funkce můžou volitelně definovat vstupní a výstupní vazby. Tyto vazby zjednodušují připojení k jiným službám, aniž byste museli pracovat s klientskými sadami SDK. Další informace najdete v tématu Azure Functions koncepty triggerů a vazeb.

Azure Functions poskytuje sadu šablon projektů a funkcí specifických pro jazyk, které usnadňují vytváření nových projektů kódu a přidávání funkcí do projektu. K vygenerování nových aplikací a funkcí pomocí těchto šablon můžete použít kterýkoli z nástrojů, které podporují vývoj Azure Functions.

Vývojářské nástroje

Následující nástroje poskytují lokální a integrovaný zážitek z vývoje a publikování pro Azure Functions ve vašem preferovaném jazyce:

Tyto nástroje se integrují s nástroji Azure Functions Core Tools, abyste mohli spouštět a ladit na místním počítači pomocí modulu runtime služby Functions. Další informace najdete v tématu Code a místní testování Azure Functions.

V Azure portálu je také editor, kterým můžete přímo v portálu aktualizovat svůj kód a soubor function.json definice. Tento editor používejte pouze pro drobné změny nebo vytváření funkcí důkazu konceptu. Vždy rozvíjejte své funkce lokálně, pokud to jde. Další informace najdete v tématu Vytvoření první funkce na portálu Azure.

Úpravy portálu se podporují jenom pro Node.js verze 3, která používá soubor function.json.

Nasazení

Při publikování projektu kódu do Azure v podstatě nasazujete projekt do existujícího prostředku aplikace funkcí. Aplikace funkcí poskytuje kontext spuštění v Azure, ve kterém vaše funkce běží. Proto se jedná o jednotku nasazení a správy vašich funkcí. Z pohledu Azure Prostředek je aplikace funkcí ekvivalentní prostředku webu (Microsoft.Web/sites) v Azure App Service, což odpovídá webové aplikaci.

Funkční aplikace se skládá z jedné nebo více jednotlivých funkcí, které spravujete, nasazujete a škálujete společně. Všechny funkce v aplikaci funkcí sdílejí stejný cenový plán, metodu nasazení a verzi modulu runtime. Další informace najdete v tématu Správa aplikace funkcí.

Když funkční aplikace a další potřebné zdroje v Azure ještě neexistují, musíte tyto zdroje vytvořit před nasazením projektových souborů. Tyto prostředky můžete vytvořit jedním z těchto způsobů:

Kromě publikování založeného na nástrojích podporuje Functions další technologie pro nasazení zdrojového kódu do existující aplikace funkcí. Další informace najdete v tématu Odployment technologie v Azure Functions.

Připojení ke službám

Hlavním požadavkem jakékoli cloudové výpočetní služby je čtení dat z jiných cloudových služeb a zápis dat do jiných cloudových služeb. Funkce poskytují rozsáhlou sadu vazeb, které usnadňují připojení ke službám bez nutnosti pracovat s klientskými sadami SDK.

Ať už používáte vazební rozšíření poskytovaná Functions, nebo pracujete přímo s klientskými SDK, bezpečně ukládáte data o připojení a nezahrnujete je do svého kódu.

Výchozí hostitelské úložiště

Azure Functions při vytváření instance aplikace funkcí vyžaduje účet služby Azure Storage. Tento výchozí úložný účet je interně používán hostitelem Functions a některými vazbovými rozšířeními.

Chcete-li se dozvědět, jak bezpečně definovat připojení k výchozímu úložnému účtu, viz Definovat připojení.

Vazby

Functions poskytuje vazby pro mnoho služeb Azure a několik služeb třetích stran, které jsou implementované jako rozšíření. Další informace najdete v úplném seznamu podporovaných vazeb.

Rozšíření vazeb můžou podporovat vstupy i výstupy a mnoho triggerů také funguje jako vstupní vazby. Vazby umožňují nakonfigurovat připojení ke službám, aby hostitel služby Functions mohl zpracovávat přístup k datům za vás. Další informace najdete v tématu Azure Functions koncepty triggerů a vazeb.

Pokud máte problémy s chybami pocházejícími z vazeb, přečtěte si dokumentaci k Azure Functions kódy chyb vazby. Chcete-li se dozvědět, jak bezpečně definovat spojení ve vazbách na vzdálené služby, viz Definovat spojení.

Běžné vlastnosti pro připojení založená na identitě

Připojení založená na identitách pro Azure Functions používají spravované identity pro autentizaci. Systémově přiřazená identita se používá ve výchozím nastavení, ale můžete nastavit uživatelem přiřazenou identitu pomocí vlastností credential a clientId . Pro úplné podrobnosti o konfiguraci připojení založených na identitě, včetně požadovaných nastavení aplikace a oprávnění RBAC, viz Definujte spojení spravovaných identit.

Místní vývoj s využitím připojení založených na identitách

Při lokálním spuštění používají identity založená spojení vaši vývojářskou identitu (například přihlášení do Azure CLI) místo spravované identity. Nemusíte stavět credentialclientId nebo nemovitosti během místního rozvoje. Další informace najdete v tématu Místní vývoj s využitím připojení založených na identitě.

Klientské sady SDK

Zatímco Functions poskytuje vazby pro zjednodušení přístupu k datům ve vašem kódu funkce, můžete také použít klientské SDK ve vašem projektu pro přímý přístup k dané službě. Možná budete muset používat klientské SDK přímo, pokud vaše funkce vyžadují funkcionalitu základního SDK, kterou rozšíření binding nepodporuje. Kód funkcí nemá přístup ke základním klientům používaným vašimi vazbovými rozšířeními. Musíte nezávisle vytvářet a spravovat všechny klientské instance, které potřebujete ve svých funkcích používat.

Při vytváření a používání klientských SDK ve vašem funkčním kódu zvažte tyto otázky:

  • Použijte stejný proces pro ukládání a přístup k spojovacím řetězcům, jaký používají vazby rozšíření. Pro více informací viz Definujte spojení.

  • Když hostujete svou aplikaci v rámci plánu Consumption, existuje limit na celkový počet odchozích připojení napříč všemi instancemi. Tento limit znamená, že musíte být opatrní, abyste se vyhnuli vyčerpání přístavu. Pro více informací viz Správa připojení ke SDK klientům.

  • Když vytvoříte instanci SDK klienta ve svých funkcích, získejte informace o připojení požadované klientem z proměnných prostředí.
  • Když vytvoříte instanci SDK klienta ve svých funkcích, získejte informace o připojení požadované klientem z proměnných prostředí.
  • Když vytvoříte instanci SDK klienta ve svých funkcích, získejte informace o připojení požadované klientem z proměnných prostředí.
  • Když vytvoříte instanci SDK klienta ve svých funkcích, získejte informace o připojení požadované klientem z proměnných prostředí.
  • Když vytvoříte instanci SDK klienta ve svých funkcích, získejte informace o připojení požadované klientem z proměnných prostředí.

Hlášení problémů

Položka Popis Odkaz
Šablona běhového prostředí Hostitel skriptů, aktivační události a vazby, podpora jazyka Soubor problém
Šablony Problémy s kódem při vytváření šablony Soubor problém

Open source úložiště

Kód pro Azure Functions je open source. Klíčové komponenty najdete v těchto GitHub repozitářích:

Další informace naleznete v následujících zdrojích: