Rychlý start: Vytvoření funkce v Azure pomocí TypeScriptu pomocí Visual Studio Code

  • Článek
  • 6 min ke čtení

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

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

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

Konfigurace prostředí

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

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 TypeScriptu. Později v tomto článku publikujete kód funkce do Azure.

  1. Na panelu aktivit zvolte ikonu Azure. Potom 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.

    Screenshot of create a new project window.

  2. Zvolte 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
    Výběr jazyka pro projekt funkce Zvolte TypeScript.
    Výběr šablony pro první funkci projektu Zvolte HTTP trigger.
    Zadejte název funkce. Zadejte HttpExample.
    Ú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. Zvolte Add to workspace.

    Pomocí těchto informací Visual Studio Code 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 najdete 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 funkci spustit místně, stiskněte klávesu F5 nebo ikonu přehrávání. Na panelu Terminálu se 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ě.

    Screenshot of the Local function VS Code output.

    Pokud máte potíže se spuštěním na Windows, ujistěte se, že výchozí terminál pro Visual Studio Code není nastavený na WSL Bash.

  2. V nástroji Core Tools stále běží v terminálu, zvolte ikonu Azure na panelu aktivit. V oblasti Pracovní prostor rozbalte položku Místní Project>Funkce. Klikněte pravým tlačítkem myši (Windows) nebo Ctrl – klikněte na funkci (macOS) HttpExample a zvolte Spustit funkci nyní....

    Execute function now from Visual Studio Code

  3. V části Zadejte text požadavku se zobrazí textová hodnota { "name": "Azure" }zprávy požadavku . Stisknutím klávesy Enter odešlete tuto zprávu žádosti do vaší funkce.

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

  5. S fokusem panelu Terminálu zastavte nástroje Core Tools stisknutím kombinace kláves Ctrl+C a odpojte ladicí program.

Po ověření 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....

    Screenshot of the sign-in to Azure window within 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. Pak v oblasti Prostředky vyberte + ikonu a zvolte možnost Vytvořit aplikaci funkcí v Azure .

    Create a resource in your Azure subscription

  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 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. Zadaný název se ověří, aby byl v Azure Functions jedinečný.
    Výběr zásobníku modulu runtime Zvolte jazyková verze, na které jste místně spustili.
    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 .

    Log of Azure resource creation

  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 základního hostitele vaší aplikace funkcí.
    • Aplikace Přehledy instanci připojenou 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í vytvářejí 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 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. Na panelu aktivit zvolte ikonu Azure a pak v oblasti Pracovní prostor vyberte složku projektu a vyberte tlačítko Nasadit... .

    Deploy project from the Visual Studio Code workspace

  2. 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 zobrazte.

    Screenshot of the View Output window.

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

    Screenshot of executing function in Azure from Visual Studio Code.

  2. V části Zadejte text požadavku se zobrazí textová hodnota { "name": "Azure" }zprávy požadavku . Stisknutím klávesy Enter odešlete tuto zprávu žádosti do vaší funkce.

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

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

Až budete pokračovat k dalšímu kroku a přidáte do funkce vazbu fronty Azure Storage, budete muset zachovat všechny prostředky na místě, 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 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. Stránka aplikace funkcí se otevře v Azure Portal.

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

    Screenshot of select the resource group to delete from the function app page.

  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. 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 službu Functions najdete v tématu Odhad nákladů na plán Consumption.

Další kroky

Použili jste Visual Studio Code k vytvoření aplikace funkcí s jednoduchou funkcí aktivovanou protokolem HTTP. V dalším článku rozbalíte tuto funkci připojením k Azure Storage. 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í do fronty Azure Storage