Rychlý start: Vytvoření funkce jazyka C# v Azure pomocí editoru Visual Studio Code

Tento článek vytvoří funkci aktivovanou protokolem HTTP, která běží v .NET 6 v izolovaném pracovním procesu. Informace o verzích .NET podporovaných pro funkce jazyka C# najdete v tématu Podporované verze.

K dispozici je také verze tohoto článku založená na rozhraní příkazového řádku .

Dokončením tohoto rychlého startu se na vašem účtu Azure účtují malé náklady ve výši několika centů v USD nebo méně.

Konfigurace prostředí

Než začnete, ujistěte se, že máte splněné následující požadavky:

• Účet Azure s aktivním předplatným. Vytvořte si účet zdarma.

• Sada .NET 6.0 SDK a volitelně sada .NET 7.0 SDK při cílení na .NET 7.0

• Visual Studio Code na jedné z podporovaných platforem

• Rozšíření jazyka C# pro Visual Studio Code.

• Azure Functions rozšíření pro Visual Studio Code.

Instalace nebo aktualizace nástrojů Core Tools

Rozšíření Azure Functions pro Visual Studio Code se integruje s nástroji Azure Functions Core Tools, abyste mohli spouštět a ladit funkce místně v editoru Visual Studio Code pomocí modulu runtime Azure Functions. Než začnete, je vhodné nainstalovat nástroje Core Tools místně nebo aktualizovat stávající instalaci tak, aby používala nejnovější verzi.

V editoru Visual Studio Code výběrem klávesy F1 otevřete paletu příkazů a pak vyhledejte a spusťte příkaz Azure Functions: Instalace nebo aktualizace nástrojů Core Tools.

Tento příkaz spustí instalaci nejnovější verze Nástrojů Core Tools založenou na balíčku.

Vytvoření místního projektu

V této části použijete Visual Studio Code k vytvoření místního projektu Azure Functions v jazyce C#. Později v tomto článku publikujete kód funkce do Azure.

1. Na panelu Aktivita zvolte ikonu Azure a pak v oblasti Pracovní prostor (místní) vyberte + tlačítko a v rozevíracím seznamu zvolte Vytvořit funkci . Po zobrazení výzvy zvolte Vytvořit nový projekt.

   

2. Vyberte umístění adresáře pracovního prostoru projektu a zvolte Vybrat. Měli byste buď vytvořit novou složku, nebo zvolit prázdnou složku pro pracovní prostor projektu. Nevybírejte složku projektu, která už je součástí pracovního prostoru.

3. Podle pokynů na obrazovce zadejte tyto informace:

   Výzva	Výběr
   Výběr jazyka pro projekt funkcí	Zvolte C#.
   Výběr modulu runtime .NET	Zvolte .NET 6.0 Isolated (LTS).
   Výběr šablony pro první funkci projektu	Zvolte HTTP trigger.
   Zadejte název funkce.	Zadejte HttpExample.
   Zadejte obor názvů.	Zadejte My.Functions.
   Úroveň autorizace	Zvolte , Anonymouscož umožní komukoli volat koncový bod funkce. Další informace o úrovni autorizace najdete v tématu Autorizační klíče.
   Vyberte, jak chcete projekt otevřít.	Vyberte Open in current window.

4. Visual Studio Code použije poskytnuté informace a vygeneruje Azure Functions projekt s triggerem HTTP. Místní soubory projektu můžete zobrazit v Průzkumníkovi. Další informace o vytvořených souborech najdete v tématu Generované soubory projektu.

Místní spuštění funkce

Visual Studio Code se integruje s nástroji Azure Functions Core a umožňuje spustit tento projekt na místním vývojovém počítači před publikováním do Azure. Pokud ještě nemáte nástroje Core Tools nainstalované místně, zobrazí se výzva k jejich instalaci při prvním spuštění projektu.

1. Pokud chcete funkci zavolat, spusťte stisknutím klávesy F5 projekt aplikace funkcí. Na panelu Terminál se zobrazí výstup z nástrojů Core Tools. Aplikace se spustí na panelu Terminál . Můžete vidět koncový bod adresy URL vaší funkce aktivované protokolem HTTP spuštěné místně.

   

   Pokud ještě nemáte nainstalované nástroje Core Tools, po zobrazení výzvy k instalaci nástroje Core Tools vyberte Nainstalovat .
   Pokud máte potíže se spuštěním ve Windows, ujistěte se, že výchozí terminál pro Visual Studio Code není nastavený na WSL Bash.

2. Se spuštěnými nástroji Core Tools přejděte do oblasti Azure: Functions . V části Funkce rozbalte místní funkce projektu>. Klikněte pravým tlačítkem (Windows) nebo Ctrl – klikněte na funkci (macOS) HttpExample a zvolte Spustit funkci...

   

3. Stisknutím klávesy Enter v textu požadavku odešlete do funkce zprávu s žádostí.

4. Když se funkce spustí místně a vrátí odpověď, v editoru Visual Studio Code se vyvolá oznámení. Informace o spuštění funkce se zobrazují na panelu Terminál .

5. Stisknutím kombinace kláves Ctrl +C zastavte nástroje Core Tools a odpojte ladicí program.

Po kontrole správného spuštění funkce na místním počítači je čas použít Visual Studio Code k publikování projektu přímo do Azure.

Přihlášení k Azure

Než můžete aplikaci publikovat, musíte se přihlásit do Azure.

1. Pokud ještě nejste přihlášení, zvolte ikonu Azure na panelu Aktivita. Pak v oblasti Prostředky zvolte Přihlásit se k Azure....

   

   Pokud už jste přihlášení a můžete zobrazit stávající předplatná, přejděte k další části. Pokud ještě nemáte účet Azure, zvolte Vytvořit účet Azure.... Studenti můžou zvolit Vytvořit účet Azure for Students....

2. Po zobrazení výzvy v prohlížeči zvolte svůj účet Azure a přihlaste se pomocí přihlašovacích údajů účtu Azure. Pokud vytvoříte nový účet, můžete se po vytvoření účtu přihlásit.

3. Po úspěšném přihlášení můžete nové okno prohlížeče zavřít. Předplatná, která patří do vašeho účtu Azure, se zobrazí na bočním panelu.

Vytvoření aplikace funkcí v Azure

V této části vytvoříte aplikaci funkcí a související prostředky v předplatném Azure.

1. Na panelu Aktivita zvolte ikonu Azure. Pak v oblasti Prostředky vyberte ikonu + a zvolte možnost Vytvořit aplikaci funkcí v Azure .

   

2. Podle pokynů na obrazovce zadejte tyto informace:

   Výzva	Výběr
   Vybrat předplatné	Zvolte předplatné, které chcete použít. Tato výzva se nezobrazí, pokud se v části Prostředky zobrazuje jenom jedno předplatné.
   Zadejte globálně jedinečný název aplikace funkcí.	Zadejte platný název v cestě URL. Zadaný název se ověří, aby se zajistilo, že je jedinečný v Azure Functions.
   Výběr zásobníku modulu runtime	Zvolte jazyk, ve kterém jste místně spustili.
   Vyberte umístění pro nové prostředky.	Pokud chcete zlepšit výkon, vyberte oblast ve vaší blízkosti.

   Rozšíření zobrazuje stav jednotlivých prostředků při jejich vytváření v Azure na panelu Azure: Protokol aktivit .

   

3. Po vytvoření se ve vašem předplatném vytvoří následující prostředky Azure. Prostředky se pojmenovávají na základě názvu vaší aplikace funkcí:

   • Skupina prostředků, což je logický kontejner pro související prostředky.
   • Standardní účet Azure Storage, který udržuje stav a další informace o vašich projektech.
   • Aplikace funkcí, která poskytuje prostředí pro spuštění kódu funkce. Aplikace funkcí umožňuje seskupit funkce jako logickou jednotku pro snadnější správu, nasazení a sdílení prostředků v rámci stejného plánu hostování.
   • Plán App Service, který definuje základního hostitele pro vaši aplikaci funkcí.
   • Instance Application Insights připojená k aplikaci funkcí, která sleduje využití vašich funkcí v aplikaci.

   Po vytvoření aplikace funkcí a použití balíčku nasazení se zobrazí oznámení.

   Tip

   Ve výchozím nastavení se prostředky Azure vyžadované vaší aplikací funkcí vytvářejí na základě zadaného názvu aplikace funkcí. Ve výchozím nastavení se vytvoří také ve stejné nové skupině prostředků s aplikací funkcí. Pokud chcete buď přizpůsobit názvy těchto zdrojů, nebo znovu použít existující zdroje, musíte místo toho publikovat projekt s rozšířenými možnostmi vytvoření .

Nasazení projektu do Azure

Důležité

Nasazení do existující aplikace funkcí vždy přepíše obsah této aplikace v Azure.

1. Zvolte ikonu Azure na panelu Aktivita, pak v oblasti Pracovní prostor vyberte složku projektu a vyberte tlačítko Nasadit .

   

2. Vyberte Nasadit do aplikace funkcí..., zvolte aplikaci funkcí, kterou jste právě vytvořili, a vyberte Nasadit.

3. Po dokončení nasazení vyberte Zobrazit výstup a zobrazte výsledky vytvoření a nasazení, včetně prostředků Azure, které jste vytvořili. Pokud oznámení zmeškáte, vyberte ikonu zvonku v pravém dolním rohu a znovu ho zobrazte.

   

Spuštění funkce v Azure

1. Zpět v oblasti Prostředky na bočním panelu rozbalte své předplatné, novou aplikaci funkcí a funkce. Klikněte pravým tlačítkem (Windows) nebo Ctrl – klikněte na funkci (macOS) HttpExample a zvolte Execute Function Now....

   

2. V části Zadejte text požadavku uvidíte hodnotu text zprávy požadavku s hodnotou { "name": "Azure" }. Stisknutím klávesy Enter odešlete tuto zprávu požadavku do vaší funkce.

3. Když se funkce spustí v Azure a vrátí odpověď, v editoru Visual Studio Code se vyvolá oznámení.

Vyčištění prostředků

Když budete pokračovat dalším krokem a přidáte do funkce vazbu fronty Azure Storage, budete muset zachovat všechny prostředky, abyste mohli stavět na tom, co jste už udělali.

V opačném případě můžete aplikaci funkcí a související prostředky odstranit pomocí následujícího postupu, abyste se vyhnuli dalším nákladům.

1. V editoru Visual Studio Code stisknutím klávesy F1 otevřete paletu příkazů. Na paletě příkazů vyhledejte a vyberte Azure: Open in portal.

2. Zvolte aplikaci funkcí a stiskněte Enter. V Azure Portal se otevře stránka aplikace funkcí.

3. Na kartě Přehled vyberte pojmenovaný odkaz vedle položky Skupina prostředků.

   

4. Na stránce Skupina prostředků zkontrolujte seznam zahrnutých prostředků a ověřte, že se jedná o ty, které chcete odstranit.

5. Vyberte Odstranit skupinu prostředků a postupujte podle pokynů.

   Odstranění může trvat několik minut. Po jeho dokončení se na několik sekund zobrazí oznámení. K zobrazení tohoto oznámení můžete také vybrat ikonu zvonku v horní části stránky.

Další informace o nákladech na functions najdete v tématu Odhad nákladů na plán Consumption.

Další kroky

Pomocí editoru Visual Studio Code jste vytvořili aplikaci funkcí s jednoduchou funkcí aktivovanou protokolem HTTP. V dalším článku tuto funkci rozbalíte připojením k jedné ze základních služeb úložiště Azure. Další informace o připojení k dalším službám Azure najdete v tématu Přidání vazeb k existující funkci v Azure Functions.

Připojení ke službě Azure Cosmos DBPřipojení ke službě Azure Queue StoragePřipojení k Azure SQL