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

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

Za dokončení tohoto rychlého startu se ve vašem účtu Azure účtu Azure účtu vynačítá 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 splňujete následující požadavky:

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

• Node.js 14.x neboNode.js 16.x (Preview). Ke kontrole node --version verze použijte příkaz .

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

• Rozšíření Azure Functions pro Visual Studio Code

• Azure Functions Core Tools 4.x.

Vytvoření místního projektu

V této části použijete příkaz Visual Studio Code k vytvoření místního projektu Azure Functions TypeScriptu. 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.

   

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

   Poznámka

   Tyto kroky byly navrženy 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 TypeScript.

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

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

   • Úroveň autorizace: Zvolte Anonymous , která komukoli umožní volat váš 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 vygeneruje Azure Functions projekt s triggerem HTTP. Místní soubory 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 , 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í.

   

   pokud máte potíže s provozem na Windows, 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 Project. klikněte pravým tlačítkem (Windows) nebo stiskněte klávesu Ctrl (macOS) HttpExample a vyberte možnost spustit funkci nyní....

   

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.

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.

Jakmile ověříte, že funkce funguje správně na místním počítači, je čas použít funkci Visual Studio Code publikovat projekt 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.

   

   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 nasadíte kód.

1. Na panelu aktivita zvolte ikonu Azure a pak v oblasti Azure: Funkce zvolte tlačítko Nasadit do aplikace funkcí.

   

2. Podle pokynů na obrazovce zadejte tyto informace:

   • Vybrat složku: Zvolte složku z pracovního prostoru nebo přejděte do složky, která obsahuje vaši aplikaci funkcí. Pokud už máte otevřenou platnou aplikaci funkcí, neuvidíte ji.

   • Vyberte předplatné: Zvolte předplatné, které chcete použít. Pokud máte jenom jedno předplatné, toto neuvidíte.

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

   • Zadejte globálně jedinečný název aplikace funkcí: Zadejte název, který je platný v cestě URL. Název, který napíšete, se ověří, aby se ověřil, že je jedinečný v Azure Functions.

   • Vyberte modul runtime: Zvolte verzi Node.js, na které jste místně běželi. Ke kontrole node --version verze můžete použít příkaz .

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

   Rozšíření v oznamovací oblasti zobrazuje stav jednotlivých prostředků při jejich vytváření v 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 funkcí:

   • 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. Výběrem možnosti Zobrazit výstup v tomto oznámení zobrazíte výsledky vytvoření a nasazení, včetně prostředků Azure, které jste vytvořili. Pokud oznámení promeškáte, vyberte ikonu zvonku v pravém dolním rohu a znovu ji zobrazte.

   

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í....

   

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ů.

   

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í s jednoduchou funkcí aktivované protokolem HTTP. V dalším článku tuto funkci rozbalíte připojením k Azure Storage. Další informace o připojení k jiným službám Azure najdete v tématu Přidání vazeb do existující funkce v Azure Functions.