Rychlý Start: vytvoření funkce jazyka C# v Azure pomocí Visual Studio Code

V tomto článku použijete Visual Studio Code k vytvoření funkce založené na knihovně jazyka C#, která reaguje na požadavky HTTP. Po místním testování kódu ho nasadíte do prostředí Azure Functions bez serveru.

Po dokončení tohoto rychlého startu dojde v účtu Azure k malým nákladům na několik centů nebo méně.

K dispozici je také verze tohoto článku na bázi CLI .

Konfigurace prostředí

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

Vytvořit místní projekt

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. Zvolte ikonu Azure na panelu Aktivita a pak v oblasti Azure: Funkce vyberte ikonu Vytvořit nový projekt.

    Volba možnosti Vytvořit nový projekt

  2. Zvolte umístění adresáře pro váš pracovní prostor projektu a zvolte Vybrat.

    Poznámka

    Tyto kroky jsou navržené tak, aby se dokončily mimo pracovní prostor. V tomto případě nevybírejte složku projektu, která je součástí pracovního prostoru.

  3. Podle pokynů na obrazovce zadejte tyto informace:

    • Vyberte jazyk pro váš projekt funkce: Zvolte C#.

    • Vyberte šablonu pro první funkci projektu: Zvolte HTTP trigger.

    • Zadejte název funkce: Zadejte příkaz HttpExample.

    • Zadejte obor názvů: Zadejte příkaz My.Functions.

    • Úroveň autorizace: vyberte Anonymous , který umožňuje komukoli zavolat koncový bod funkce. Další informace o úrovni autorizace najdete v tématu autorizační klíče.

    • Vyberte způsob, jakým chcete projekt otevírat: Zvolte Add to workspace.

  4. Pomocí těchto informací Visual Studio Code generuje Azure Functions projekt pomocí triggeru protokolu HTTP. Můžete zobrazit soubory místních projektů v Průzkumníkovi. Další informace o souborech, které jsou vytvořeny, najdete v tématu vygenerované soubory projektu.

Místní spuštění funkce

Visual Studio Code se integruje s nástroji Azure Functions Core , aby bylo možné spustit tento projekt na místním vývojovém počítači před publikováním do Azure.

  1. Pro volání funkce stiskněte klávesu F5 ke spuštění projektu Function App. Výstup z nástrojů Tools se zobrazí na panelu Terminál. Vaše aplikace se spustí na panelu terminálu . Koncový bod adresy URL vámi spuštěné funkce aktivované protokolem HTTP se zobrazí v místním prostředí.

    Místní funkce VS Code výstupem

    Pokud máte v systému Windows potíže, ujistěte se, že výchozí terminál pro Visual Studio Code není nastaven na WSL bash.

  2. Se základními nástroji, které běží, přejdete do oblasti Azure: Functions . V části funkce rozbalte místní > funkce projektu. Klikněte pravým tlačítkem myši (Windows) nebo stiskněte klávesu CTRL (MacOS) HttpExample a vyberte možnost Spustit funkci nyní....

    Spustit funkci hned z Visual Studio Code

  3. V části Zadejte text žádosti se zobrazí hodnota tělo zprávy žádosti { "name": "Azure" } . Stisknutím klávesy ENTER odešlete tuto zprávu požadavku vaší funkci.

    Místo toho byste mohli odeslat požadavek HTTP GET na http://localhost:7071/api/HttpExample adresu ve webovém prohlížeči.

  4. Když se funkce spustí místně a vrátí odpověď, vygeneruje se oznámení v Visual Studio Code. Informace o spuštění funkce se zobrazí na panelu terminálu .

  5. Stisknutím kombinace kláves CTRL + C zastavte základní nástroje a odpojte ladicí program.

Po ověření, že se funkce na místním počítači spustí správně, 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 na řádku aktivity ikonu Azure a pak v oblasti Azure: funkce zvolte Přihlásit se k Azure.... Pokud ho ještě nemáte, můžete si vytvořit bezplatný účet Azure. Studenti můžou vytvořit bezplatný účet Azure pro studenty.

    Přihlaste se k Azure v rámci VS Code

    Pokud jste už přihlášení, přečtěte si další část.

  2. Po zobrazení výzvy v prohlížeči vyberte svůj účet Azure a přihlaste se pomocí svých přihlašovacích údajů k účtu Azure.

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

Publikování projektu do Azure

V této části vytvoříte aplikaci funkcí a související prostředky v předplatném Azure a pak svůj kód nasadíte.

Důležité

Publikování do existující aplikace funkcí přepíše obsah této aplikace v Azure.

  1. Zvolte ikonu Azure na řádku aktivity a potom v oblasti Azure: funkce zvolte tlačítko nasadit do aplikace Function App... .

    Publikování projektu do Azure

  2. Podle pokynů na obrazovce zadejte tyto informace:

    • Vyberte složku: Zvolte složku z pracovního prostoru nebo přejděte k nějakému, který obsahuje vaši aplikaci Function App. Tato funkce se nezobrazuje, pokud už máte spuštěnou platnou aplikaci Function App.

    • Vyberte předplatné: zvolte předplatné, které chcete použít. Toto se nezobrazí, pokud máte jenom jedno předplatné.

    • Výběr aplikace funkcí v Azure: Zvolte - Create new Function App. (Nevybírejte Advanced možnost, která není pokrytá v tomto článku.)

    • Zadejte globálně jedinečný název aplikace Function App: zadejte název, který je platný v cestě URL. Název, který zadáte, bude ověřený, abyste se ujistili, že je v Azure Functions jedinečný.

    • Vyberte umístění pro nové prostředky: pro lepší výkon zvolte oblast poblíž.

    Rozšíření zobrazuje stav jednotlivých prostředků, které se vytváří v Azure v oznamovací oblasti.

    Oznámení o vytváření prostředků Azure

  3. Po dokončení se ve vašem předplatném vytvoří následující prostředky Azure s použitím názvů na základě názvu vaší aplikace Function App:

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

    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 požadované vaší aplikací Function App vytvoří na základě názvu aplikace Function App, kterou zadáte. Ve výchozím nastavení se také vytvoří ve stejné nové skupině prostředků s aplikací Function App. Pokud chcete přizpůsobit názvy těchto prostředků nebo znovu použít stávající prostředky, je třeba projekt publikovat s možností pokročilého vytvoření.

  4. Pokud chcete zobrazit výsledky vytvoření a nasazení, včetně prostředků Azure, které jste vytvořili, vyberte Zobrazit výstup v tomto oznámení. Pokud jste oznámení nezobrazili, vyberte ikonu zvonku v pravém dolním rohu, abyste ji viděli znovu.

    Vytvořit kompletní oznámení

Spuštění funkce v Azure

  1. Zpátky v oblasti Azure: Functions (funkce ) na bočním panelu rozbalte své předplatné, novou aplikaci Function App a funkce. Klikněte pravým tlačítkem myši (Windows) nebo stiskněte klávesu CTRL (MacOS) HttpExample a vyberte možnost Spustit funkci nyní....

    Spustit nyní funkci v Azure z Visual Studio Code

  2. V části Zadejte text žádosti se zobrazí hodnota tělo zprávy žádosti { "name": "Azure" } . Stisknutím klávesy ENTER odešlete tuto zprávu požadavku vaší funkci.

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

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

Když přejdete k dalšímu kroku a přidáte do své funkce vazbu Azure Storage fronty, budete muset všechny vaše prostředky zachovávat, abyste mohli vytvářet informace o tom, co jste už provedli.

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

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

  2. Zvolte aplikaci Function App a stiskněte klávesu ENTER. Na Azure Portal se otevře stránka Function App.

  3. Na kartě Přehled vyberte odkaz s názvem vedle skupiny prostředků.

    Vyberte skupinu prostředků, kterou chcete odstranit ze stránky aplikace funkcí.

  4. Na stránce Skupina prostředků zkontrolujte seznam zahrnutých prostředků a ověřte, že jsou to 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 funkce najdete v tématu odhad nákladů na plán spotřeby.

Další kroky

Použili jste Visual Studio Code k vytvoření aplikace funkcí pomocí jednoduché funkce aktivované protokolem HTTP. V dalším článku tuto funkci rozbalíte tak, že se připojíte k Azure Cosmos DB nebo Azure Storage. Další informace o připojení k ostatním službám Azure najdete v tématu Přidání vazeb do existující funkce v Azure Functions.