Sdílet prostřednictvím

Rychlý start: Vytvoření první funkce jazyka C# v Azure pomocí sady Visual Studio

Azure Functions umožňuje pomocí sady Visual Studio vytvářet místní projekty funkcí jazyka C# a pak tento projekt snadno publikovat, aby běžel ve škálovatelném bezserverovém prostředí v Azure. Pokud dáváte přednost místnímu vývoji aplikací v jazyce C# pomocí editoru Visual Studio Code, měli byste zvážit verzi tohoto článku založenou na editoru Visual Studio Code.

Ve výchozím nastavení tento článek ukazuje, jak vytvořit funkce jazyka C#, které běží v .NET 8 v izolovaném pracovním procesu. Aplikace funkcí, které běží v izolovaném pracovním procesu, se podporují ve všech verzích rozhraní .NET, které služba Functions podporuje. Další informace naleznete v tématu Podporované verze.

V tomto článku získáte informace o těchto tématech:

  • Pomocí sady Visual Studio vytvořte projekt knihovny tříd jazyka C#.
  • Vytvořte funkci, která reaguje na požadavky HTTP.
  • Spusťte svůj kód místně a ověřte chování funkce.
  • Nasaďte projekt kódu do Služby Azure Functions.

Při dokončení tohoto rychlého startu vzniknou ve vašem účtu Azure náklady ve výši několika centů USD nebo ještě menší.

Toto video ukazuje, jak vytvořit funkci jazyka C# v Azure.

Kroky ve videu jsou popsané také v následujících částech.

Požadavky

Vytvoření projektu aplikace funkcí

Šablona projektu Azure Functions v sadě Visual Studio vytvoří projekt knihovny tříd jazyka C#, který můžete publikovat do aplikace funkcí v Azure. Aplikaci funkcí můžete použít k seskupení funkcí jako logické jednotky pro snadnější správu, nasazení, škálování a sdílení prostředků.

  1. V nabídce sady Visual Studio vyberte Soubor>>

  2. V části Vytvořit nový projekt zadejte do vyhledávacího pole funkce , zvolte šablonu Azure Functions a pak vyberte Další.

  3. V části Konfigurovat nový projekt zadejte název projektu a pak vyberte Další. Název aplikace funkcí musí být platný jako obor názvů C#, takže nepoužívejte podtržítka, pomlčky nebo jiné nealfanumerické znaky.

  4. Zbývající nastavení dalších informací:

    Nastavení Hodnota Popis
    Pracovní proces Functions Izolované prostředí .NET 8.0 (dlouhodobá podpora) Vaše funkce běží v .NET 8 v izolovaném pracovním procesu.
    Funkce HTTP spouštěč Tato hodnota vytvoří funkci aktivovanou požadavkem HTTP.
    Použití Azurite pro účet úložiště runtime (AzureWebJobsStorage) Povolit Protože funkční aplikace v Azure vyžaduje účet úložiště, je jeden přiřazen nebo vytvořen, když svůj projekt publikujete do Azure. Trigger HTTP nepoužívá připojovací řetězec účtu služby Azure Storage; všechny ostatní typy spouštěčů vyžadují platný připojovací řetězec účtu služby Azure Storage. Když vyberete tuto možnost, použije se emulátor Azurite.
    Úroveň autorizace Anonymní Vytvořenou funkci může aktivovat libovolný klient bez zadání klíče. Toto nastavení autorizace usnadňuje testování nových funkcí. Další informace najdete v tématu Úroveň autorizace.

    Snímek obrazovky s nastavením projektu Azure Functions

    Ujistěte se, že jste nastavili úroveň autorizace na anonymní. Pokud zvolíte výchozí úroveň funkce, budete muset předložit klíč funkce v požadavcích pro přístup ke koncovému bodu funkce v Azure.

  5. Výběrem možnosti Vytvořit vytvořte projekt funkce a funkci triggeru HTTP.

Visual Studio vytvoří projekt a třídu, která obsahuje šablonový kód pro typ funkce HTTP spouštěče. Šablonový kód odešle odpověď HTTP, která obsahuje hodnotu z těla požadavku nebo z řetězce dotazu. Atribut HttpTrigger určuje, že funkce se aktivuje požadavkem HTTP.

Přejmenování funkce

Atribut Function metody nastaví název funkce, která je ve výchozím nastavení generována jako Function1. Vzhledem k tomu, že nástroje vám neumožňují přepsat výchozí název funkce při vytváření projektu, věnujte chvíli vytvoření lepšího názvu pro třídu, soubor a metadata funkce.

  1. V Průzkumník souborů klikněte pravým tlačítkem myši na soubor Function1.cs a přejmenujte ho na HttpExample.cs.

  2. V kódu přejmenujte třídu Function1 na HttpExample.

  3. V pojmenované Runmetodě přejmenujte Function atribut metody na HttpExample.

Definice funkce by teď měla vypadat jako následující kód:

[Function("HttpExample")]
public IActionResult Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequest req)
{
    _logger. LogInformation("C# HTTP trigger function processed a request.");
    return new OkObjectResult("Hello, functions");
}

Teď, když jste funkci přejmenovali, můžete ji otestovat na místním počítači.

Místní spuštění funkce

Visual Studio se integruje s nástroji Azure Functions Core Tools, abyste mohli funkce testovat místně pomocí úplného modulu runtime Azure Functions.

  1. Funkci spustíte stisknutím klávesy F5 v sadě Visual Studio. Možná budete muset povolit výjimku brány firewall, aby nástroje mohly zpracovávat požadavky HTTP. Úrovně autorizace se nikdy nevynucují při místním spuštění funkce.

  2. Zkopírujte adresu URL vaší funkce z výstupu modulu runtime služby Azure Functions.

    Místní prostředí Azure

  3. Vložte adresu URL požadavku HTTP do adresního řádku prohlížeče a spusťte požadavek. Následující obrázek ukazuje odpověď v prohlížeči na místní požadavek GET vrácený funkcí:

    Funkce odezvy místního hostitele v prohlížeči

  4. Ladění zastavíte stisknutím kláves Shift+F5 ve Visual Studiu.

Po ověření správného fungování funkce na místním počítači je na čase publikovat projekt do Azure.

Publikování projektu do Azure

Visual Studio může publikovat místní projekt do Azure. Než budete moct projekt publikovat, musíte mít v předplatném Azure aplikaci funkcí. Pokud ještě nemáte aplikaci funkcí v Azure, může vám Visual Studio pomoct ji vytvořit před publikováním projektu. V tomto článku vytvoříte aplikaci funkcí, která běží v Linuxu v plánu Flex Consumption, což je doporučený plán pro funkce řízené událostmi a zabezpečené bezserverové funkce.

  1. V Průzkumníku řešení klikněte pravým tlačítkem na požadovaný projekt a vyberte Publikovat. V Target vyberte Azure a poté vyberte Další.

  2. V konkrétním cíli vyberte Aplikaci funkcí Azure (Linux) a pak vyberte Další.

    Plán Flex Consumption vyžaduje Linux.

  3. V instanci služby Functions vyberte Vytvořit nový.

    Snímek obrazovky znázorňující vytvoření nové instance aplikace funkcí

  4. Vytvořte novou instanci pomocí hodnot zadaných v následující tabulce:

    Nastavení Hodnota Popis
    Jméno Globálně jedinečný název Název jednoznačně identifikující novou aplikaci funkcí. Přijměte tento název nebo zadejte nový název. Platné znaky jsou: a-z, 0-9a -.
    Název předplatného Název předplatného Předplatné Azure, které se má použít. Přijměte toto předplatné nebo v rozevíracím seznamu vyberte nové.
    Skupina prostředků Název vaší skupiny prostředků Skupina prostředků, ve které chcete vytvořit funkční aplikaci. Výběrem možnosti Nový vytvořte novou skupinu prostředků. Můžete také použít existující skupinu prostředků z rozevíracího seznamu.
    Typ plánu Flex Spotřeba Když projekt publikujete do aplikace funkcí, která běží v plánu Flex Consumption, můžete platit jenom za provádění aplikace funkcí. Jiné plány hostování můžou mít vyšší náklady.
    Místo Umístění služby App Service Vyberte umístění v oblasti Azure podporované plánem Flex Consumption.
    Velikost paměti instance 2048 Velikost paměti instancí virtuálních počítačů, ve kterých se aplikace spouští, je jedinečná pro plán Flex Consumption.
    Azure Storage Účet úložiště pro obecné účely Modul runtime Functions vyžaduje účet úložiště Azure. Výběrem možnosti Nový nakonfigurujte účet úložiště pro obecné účely. Můžete také použít existující účet, který splňuje požadavky na účet úložiště.
    Application Insights Instance Application Insights Měli byste povolit integraci Azure Application Insights pro svou funkci aplikace. Vyberte Nový a vytvořte novou instanci, a to buď v novém, nebo v existujícím pracovním prostoru služby Log Analytics. Můžete také použít existující instanci.

    Snímek obrazovky dialogového okna Create App Service

  5. Výběrem možnosti Vytvořit vytvoříte aplikaci funkcí a související prostředky v Azure. Stav vytváření prostředků se zobrazí v levém dolním rohu okna.

  6. Vyberte Dokončit a potom na kartě Publikovat vyberte Publikovat a nasaďte balíček, který obsahuje soubory projektu do nové aplikace funkcí v Azure.

    Po dokončení nasazení se na kartě Publikovat zobrazí kořenová adresa URL funkční aplikace v Azure.

  7. Na kartě Publikovat v části Hostování vyberte Otevřít na webu Azure Portal. Nový prostředek aplikace Azure Function se otevře v portálu Azure.

    Snímek obrazovky se zprávou o úspěšném publikování

Ověření funkce v Azure

  1. Na webu Azure Portal byste měli být na stránce Přehled nové aplikace funkcí.

  2. V části Funkce vyberte novou funkci s názvem HttpExample, pak na stránce funkce vyberte Získat adresu URL funkce a pak ikonu Kopírovat do schránky.

  3. Do adresního řádku v prohlížeči vložte adresu URL, kterou jste zkopírovali, a spusťte požadavek.

    Adresa URL, která volá funkci triggeru HTTP, je v následujícím formátu:

    https://<APP_NAME>.azurewebsites.net/api/HttpExample?name=Functions

  4. Přejděte na tuto adresu URL a v prohlížeči se zobrazí odpověď na vzdálený požadavek GET vrácený funkcí, který vypadá jako v následujícím příkladu:

    Odezva funkce v prohlížeči

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

Prostředky v Azure zahrnují aplikační funkce, funkce, účty úložiště a podobně. Jsou seskupeny do skupin prostředků a můžete odstranit všechno ve skupině tím, že odstraníte samotnou skupinu.

K dokončení tohoto rychlého startu jste vytvořili prostředky Azure. Tyto prostředky se vám můžou účtovat v závislosti na stavu vašeho účtu a cenách služeb. Další rychlé starty v této kolekci jsou postavené na tomto rychlém startu. Pokud plánujete pracovat s dalšími rychlými starty, kurzy nebo s některou ze služeb, které jste v tomto rychlém startu vytvořili, nečistěte prostředky.

Pomocí následujících kroků odstraňte aplikaci funkcí a související prostředky, abyste se vyhnuli dalším nákladům.

  1. V dialogovém okně Publikovat v sadě Visual Studio v části Hostování vyberte Otevřít na webu Azure Portal.

  2. Na stránce aplikace funkcí vyberte kartu Přehled a pak vyberte odkaz pod Skupina prostředků.

    Na stránce aplikace funkcí vyberte skupinu prostředků, která se má odstranit.

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

  4. 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ší kroky

V tomto rychlém startu jste pomocí sady Visual Studio vytvořili a publikovali aplikaci funkcí jazyka C# v Azure pomocí jednoduché funkce triggeru HTTP.

Další informace o práci s funkcemi jazyka C#, které běží v izolovaném pracovním procesu, najdete v průvodci spuštěním azure Functions jazyka C# v izolovaném pracovním procesu. Podívejte se na podporované verze .NET a podívejte se na další verze podporovaných verzí .NET v izolovaném pracovním procesu.

Přejděte k dalšímu článku, kde se dozvíte, jak přidat vazbu fronty Azure Storage do vaší funkce.

Přidejte vazbu fronty Azure Storage do vaší funkce