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:
Azure Functions Core Tools verze 4.x.
Visual Studio Code na jedné z podporovaných platforem
Rozšíření jazyka C# pro Visual Studio Code
rozšíření Azure Functions pro Visual Studio Code.
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.
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.
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.
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
, vyhledejteAzure Functions: Project Runtime
a změňte výchozí verzi modulu runtime na~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.
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ě.
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.
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í....V textu požadavku Enter stiskněte Enter a odešlete do funkce zprávu požadavku.
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 .
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.
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....
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....
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.
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.
Na panelu aktivit zvolte ikonu Azure. Potom v oblasti Prostředky vyberte + ikonu a zvolte možnost Vytvořit aplikaci funkcí v Azure .
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 .
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.
Na panelu aktivit zvolte ikonu Azure a pak v oblasti Pracovní prostor vyberte složku projektu a vyberte tlačítko Nasadit...
Vyberte Nasadit do aplikace funkcí..., zvolte aplikaci funkcí, kterou jste právě vytvořili, a vyberte Nasadit.
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.
Spuštění funkce v Azure
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í....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.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.
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
.Zvolte aplikaci funkcí a stiskněte Enter. Otevře se stránka aplikace funkcí v Azure Portal.
Na kartě Přehled vyberte pojmenovaný odkaz vedle skupiny prostředků.
Na stránce Skupina prostředků zkontrolujte seznam zahrnutých prostředků a ověřte, že jsou ty, které chcete odstranit.
Na stránce Skupina prostředků zkontrolujte seznam zahrnutých prostředků a ověřte, že jsou to ty, které chcete odstranit.
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.