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

V tomto článku pomocí editoru Visual Studio Code vytvoříte funkci jazyka C#, která reaguje na požadavky HTTP. Po místním testování kódu ho nasadíte do bezserverového prostředí Azure Functions. Tento článek vytvoří funkci aktivovanou protokolem HTTP, která běží na .NET 6.0. K dispozici je také verze tohoto článku založená na rozhraní příkazového řádku .

Ve výchozím nastavení tento článek ukazuje, jak vytvořit funkce jazyka C#, které běží na .NET 6 ve stejném procesu jako hostitel služby Functions. Tyto funkce jazyka C# v procesu jsou podporovány pouze ve verzích .NET (Long Term Support) (LTS), jako je .NET 6. Pokud chcete vytvořit funkce jazyka C# v .NET 6, které se dají spustit také v rozhraní .NET 5.0 a .NET Framework 4.8 (ve verzi Preview) v izolovaném procesu, podívejte se na alternativní verzi tohoto článku.

Dokončením tohoto rychlého startu se v účtu Azure zobrazí malé náklady na pár centů USD nebo méně.

Konfigurace prostředí

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

Potřebujete také účet Azure s aktivním předplatným. Zdarma si vytvořte účet.

Vytvoření místního projektu

V této části pomocí editoru Visual Studio Code vytvoříte místní projekt Azure Functions v jazyce C#. Později v tomto článku publikujete kód funkce do Azure.

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

    Snímek obrazovky s oknem 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á je již součástí pracovního prostoru.

  3. Podle pokynů na obrazovce zadejte tyto informace:

    Výzva Výběr
    Vyberte jazyk Zvolte C#.
    Výběr modulu runtime .NET Vyberte .NET 6.
    Výběr šablony pro první funkci projektu Zvolte HTTP trigger.
    Zadejte název funkce. Zadejte HttpExample.
    Zadání oboru názvů Zadejte My.Functions.
    Úroveň autorizace Zvolte Anonymous, což umožňuje každému volat váš koncový bod funkce. Další informace o úrovni autorizace najdete v tématu Autorizační klíče.
    Vyberte, jak chcete projekt otevřít. Vyberte Add to workspace.

    Poznámka

    Pokud nevidíte .NET 6 jako možnost modulu runtime, zkontrolujte následující:

    • Ujistěte se, že jste nainstalovali sadu .NET 6.0 SDK.
    • Stiskněte klávesu F1 a zadejte Preferences: Open user settings, vyhledejte Azure Functions: Project Runtime a změňte výchozí verzi modulu runtime na ~4.
  4. Visual Studio Code používá poskytnuté informace a vygeneruje projekt Azure Functions s triggerem HTTP. Soubory místního projektu můžete zobrazit v Průzkumníku. Další informace o vytvořených souborech naleznete v tématu Vygenerované soubory projektu.

Místní spuštění funkce

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

  1. Pokud chcete volat funkci, stisknutím klávesy F5 spusťte projekt aplikace funkcí. Panel terminálu zobrazí výstup z nástrojů Core Tools. Aplikace se spustí na panelu Terminálu . Zobrazí se koncový bod adresy URL funkce aktivované protokolem HTTP spuštěné místně.

    Snímek obrazovky s výstupem místní funkce editoru Visual Studio Code

    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 na funkci (Windows) nebo Ctrl – klikněte na funkci (macOS) HttpExample a zvolte Spustit funkci nyní....

    Snímek obrazovky se spuštěnou funkcí z editoru Visual Studio Code

  3. V textu požadavku Enter stiskněte Enter a odešlete do funkce zprávu požadavku.

  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álu .

  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 aktivit. Pak v oblasti Prostředky zvolte Přihlásit se k Azure....

    Snímek obrazovky s oknem přihlášení k Azure v editoru VS Code

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

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

  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.

Vytvoření aplikace funkcí v Azure

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

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

    Vytvoření prostředku v předplatném Azure

  2. Podle pokynů na obrazovce zadejte tyto informace:

    Výzva Výběr
    Výběr předplatného Zvolte předplatné, které chcete použít. Tato výzva se nezobrazí, pokud máte v části Prostředky viditelné jenom jedno předplatné.
    Zadejte globálně jedinečný název aplikace funkcí. Zadejte název, který je platný v cestě URL. Název, který zadáte, se ověří, aby byl v Azure Functions jedinečný.
    Výběr zásobníku modulu runtime Zvolte jazyková verze, na které jste spustili místně.
    Výběr umístění pro nové prostředky Pokud chcete dosáhnout lepšího výkonu, zvolte oblast blízko vás.

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

    Protokol vytvoření prostředku Azure

  3. Po dokončení vytváření se ve vašem předplatném vytvoří následující prostředky Azure. Prostředky jsou pojmenované 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 spouš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ů ve stejném plánu hostování.
    • Plán App Service, který definuje podkladového hostitele vaší aplikace funkcí.
    • Instance Application Insights připojená k aplikaci funkcí, která sleduje využití 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í vytvoří na základě vámi zadaného názvu aplikace funkcí. Ve výchozím nastavení se také vytvoří 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 projekt publikovat s pokročilý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. Na panelu aktivit zvolte ikonu Azure a pak v oblasti Pracovní prostor vyberte složku projektu a vyberte tlačítko Nasadit...

    Nasazení projektu z pracovního prostoru editoru Visual Studio Code

  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 vytváření a nasazení, včetně prostředků Azure, které jste vytvořili. Pokud oznámení vynecháte, vyberte ikonu zvonku v pravém dolním rohu a znovu ho zobrazíte.

    Snímek obrazovky s oknem Zobrazit výstup

Spuštění funkce v Azure

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

    Snímek obrazovky se spouštěním funkce v Azure z editoru Visual Studio Code

  2. V části Zadat text požadavku se zobrazí základní hodnota { "name": "Azure" }zprávy požadavku . Stisknutím klávesy Enter odešlete tuto zprávu žádosti do 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ů

Až budete pokračovat v dalším kroku a přidáte vazbu fronty Azure Storage do funkce, 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 pomocí následujících kroků odstranit aplikaci funkcí a související prostředky, 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. Otevře se stránka aplikace funkcí v Azure Portal.

  3. Na kartě Přehled vyberte pojmenovaný odkaz vedle skupiny prostředků.

    Snímek obrazovky s výběrem skupiny prostředků, která se má odstranit ze stránky aplikace funkcí

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

  5. Na stránce Skupina prostředků zkontrolujte seznam zahrnutých prostředků a ověřte, že jsou to ty, které chcete odstranit.

  6. 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 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 ke službě Azure Cosmos DB nebo službě Azure Queue Storage. Další informace o připojení k dalším službám Azure najdete v tématu Přidání vazeb do existující funkce v Azure Functions.