Rychlý start: Vytvoření funkce Go nebo Rust v Azure pomocí editoru Visual Studio Code

• C#
• Java
• JavaScript
• Prostředí PowerShell
• Krajta
• Strojopis
• Jiné (Go/Rust)

V tomto článku pomocí editoru Visual Studio Code vytvoříte vlastní funkci obslužné rutiny , která reaguje na požadavky HTTP. Po místním otestování kód nasadíte do bezserverového prostředí Azure Functions.

Vlastní obslužné rutiny lze použít k vytváření funkcí v libovolném jazyce nebo modulu runtime spuštěním procesu serveru HTTP. Tento článek podporuje Go i Rust.

Návod

Dokončením tohoto rychlého startu se vytvoří aplikace, která běží v plánu Elastic Premium, což může způsobit náklady ve vašem účtu Azure, i když ji nepoužíváte. Po dokončení článku byste měli uvolnit prostředky a odebrat funkční aplikaci, plán služby App Service a související prostředky.

Konfigurujte své prostředí

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

Přejít

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

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

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

• Doporučujeme přejít na nejnovější verzi. go version Pomocí příkazu zkontrolujte verzi.

Rez

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

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

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

• Rust nástrojový řetězec využívající rustup. rustc --version Pomocí příkazu zkontrolujte verzi.

Instalace nebo aktualizace nástrojů Core Tools

Rozšíření Azure Functions pro Visual Studio Code se integruje s nástroji Azure Functions Core Tools, abyste mohli spouštět a ladit funkce místně v editoru Visual Studio Code pomocí modulu runtime Azure Functions. Než začnete, je vhodné nainstalovat Nástroje Core Tools místně nebo aktualizovat existující instalaci tak, aby používala nejnovější verzi.

V editoru Visual Studio Code výběrem klávesy F1 otevřete paletu příkazů a pak vyhledejte a spusťte příkaz Azure Functions: Instalace nebo aktualizace nástrojů Core Tools.

Tento příkaz se pokusí spustit instalaci založené na balíčku nejnovější verze nástrojů Core Tools nebo aktualizovat existující instalaci založenou na balíčku. Pokud nemáte na místním počítači nainstalovaný npm nebo Homebrew, musíte místo toho nainstalovat nebo aktualizovat nástroje Core Tools ručně.

Vytvoření místního projektu

V této části pomocí editoru Visual Studio Code vytvoříte místní projekt vlastních obslužných rutin Azure Functions. Později v tomto článku publikujete kód funkce do Azure.

1. V editoru Visual Studio Code stisknutím klávesy F1 otevřete paletu příkazů a vyhledejte a spusťte příkaz Azure Functions: Create New Project....

2. Zvolte umístění adresáře pro pracovní prostor 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á už je součástí pracovního prostoru.

3. Podle pokynů na obrazovce zadejte tyto informace:

   Instrukce	Výběr
   Výběr jazyka pro projekt funkce	Zvolte Custom Handler.
   Výběr šablony pro první funkci projektu	Zvolte HTTP trigger.
   Zadejte název funkce.	Zadejte HttpExample.
   Úroveň autorizace	Zvolte Anonymousmožnost , která umožňuje každému volat koncový bod funkce. Další informace najdete v tématu Úroveň autorizace.
   Vyberte, jak chcete projekt otevřít.	Zvolte Open in current window.

   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.

Vytvoření a sestavení funkce

Soubor function.json ve složce HttpExample deklaruje funkci triggeru HTTP. Funkci dokončíte přidáním obslužné rutiny a jeho kompilací do spustitelného souboru.

Přejít

1. Stisknutím kombinace kláves Ctrl+ N (Cmd + N v macOS) vytvořte nový soubor. Uložte ho jako obslužnou rutinu.go v kořenovém adresáři aplikace funkcí (ve stejné složce jako host.json).

2. Do souboru handler.go přidejte následující kód a soubor uložte. Toto je vaše vlastní obslužná rutina Go.

   package main
   
   import (
       "fmt"
       "log"
       "net/http"
       "os"
   )
   
   func helloHandler(w http.ResponseWriter, r *http.Request) {
       message := "This HTTP triggered function executed successfully. Pass a name in the query string for a personalized response.\n"
       name := r.URL.Query().Get("name")
       if name != "" {
           message = fmt.Sprintf("Hello, %s. This HTTP triggered function executed successfully.\n", name)
       }
       fmt.Fprint(w, message)
   }
   
   func main() {
       listenAddr := ":8080"
       if val, ok := os.LookupEnv("FUNCTIONS_CUSTOMHANDLER_PORT"); ok {
           listenAddr = ":" + val
       }
       http.HandleFunc("/api/HttpExample", helloHandler)
       log.Printf("About to listen on %s. Go to https://127.0.0.1%s/", listenAddr, listenAddr)
       log.Fatal(http.ListenAndServe(listenAddr, nil))
   }
   

3. Stisknutím kombinace kláves Ctrl + Shift + ' nebo vyberte Nový terminál z nabídky Terminál a otevřete nový integrovaný terminál v editoru VS Code.

4. Zkompilujte vlastní obslužnou rutinu pomocí následujícího příkazu. Spustitelný soubor s názvem handler (handler.exe ve Windows) je výstupem v kořenové složce aplikace funkcí.

   go build handler.go
   

   

Rez

1. Stisknutím kombinace kláves Ctrl + Shift + ' nebo vyberte Nový terminál z nabídky Terminál a otevřete nový integrovaný terminál v editoru VS Code.

2. V kořenovém adresáři aplikace funkcí (stejná složka jako host.json) inicializujte projekt Rust s názvem handler.

   cargo init --name handler
   

3. V souboru Cargo.toml přidejte následující závislosti potřebné k dokončení tohoto rychlého startu. Příklad používá architekturu webového serveru warp .

   [dependencies]
   warp = "0.3"
   tokio = { version = "1", features = ["rt", "macros", "rt-multi-thread"] }
   

4. Do souboru src/main.rs přidejte následující kód a soubor uložte. Toto je vaše vlastní obslužná rutina Rust.

   use std::collections::HashMap;
   use std::env;
   use std::net::Ipv4Addr;
   use warp::{http::Response, Filter};
   
   #[tokio::main]
   async fn main() {
       let example1 = warp::get()
           .and(warp::path("api"))
           .and(warp::path("HttpExample"))
           .and(warp::query::<HashMap<String, String>>())
           .map(|p: HashMap<String, String>| match p.get("name") {
               Some(name) => Response::builder().body(format!("Hello, {}. This HTTP triggered function executed successfully.", name)),
               None => Response::builder().body(String::from("This HTTP triggered function executed successfully. Pass a name in the query string for a personalized response.")),
           });
   
       let port_key = "FUNCTIONS_CUSTOMHANDLER_PORT";
       let port: u16 = match env::var(port_key) {
           Ok(val) => val.parse().expect("Custom Handler port is not a number!"),
           Err(_) => 3000,
       };
   
       warp::serve(example1).run((Ipv4Addr::LOCALHOST, port)).await
   }
   

5. Zkompilujte binární soubor pro vlastní obslužnou rutinu. Spustitelný soubor s názvem handler (handler.exe ve Windows) je výstupem v kořenové složce aplikace funkcí.

   cargo build --release
   cp target/release/handler .
   

   

Konfigurace aplikace funkcí

Hostitel funkce musí být nakonfigurovaný tak, aby při spuštění spustil binární soubor vlastní obslužné rutiny.

1. Otevřete host.json.

2. customHandler.description V části nastavte hodnotu defaultExecutablePath na handler hodnotu (ve Windows, nastavte ji na handler.exehodnotu ).

3. customHandler V části přidejte vlastnost s názvem enableForwardingHttpRequest a nastavte její hodnotu na true. Pro funkce, které se skládají pouze z triggeru HTTP, toto nastavení zjednodušuje programování tím, že umožňuje pracovat s typickým požadavkem HTTP místo vlastní datové části požadavku obslužné rutiny.

4. Potvrďte, že oddíl vypadá jako v tomto příkladu customHandler . Uložte soubor.

   "customHandler": {
     "description": {
       "defaultExecutablePath": "handler",
       "workingDirectory": "",
       "arguments": []
     },
     "enableForwardingHttpRequest": true
   }
   

Aplikace funkcí je nakonfigurovaná tak, aby spustila spustitelný soubor vlastní obslužné rutiny.

Místní spuštění funkce

Tento projekt můžete spustit na místním vývojovém počítači před publikováním do Azure.

1. V integrovaném terminálu spusťte aplikaci funkcí pomocí nástrojů Azure Functions Core Tools.

   func start
   

2. Se spuštěnými nástroji Core Tools přejděte na následující adresu URL a spusťte požadavek GET, který obsahuje ?name=Functions řetězec dotazu.

   http://localhost:7071/api/HttpExample?name=Functions

3. Vrátí se odpověď, která v prohlížeči vypadá takto:

   

4. Informace o žádosti se zobrazí na panelu terminálu .

   

5. Stisknutím kombinace kláves Ctrl+C ukončete nástroje Core Tools.

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ž budete moct vytvářet prostředky Azure nebo publikovat aplikaci, musíte se přihlásit do Azure.

1. Pokud ještě nejste přihlášení, vyberte na panelu Aktivit ikonu Azure. Pak v části Prostředky vyberte 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, vyberte Vytvořit účet Azure. Studenti můžou vybrat Vytvořit účet Azure for Students.

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

Kompilace vlastní obslužné rutiny pro Azure

V této části publikujete projekt do Azure v aplikaci funkcí s Linuxem. Ve většině případů musíte před publikováním do Azure znovu zkompilovat binární soubor a upravit konfiguraci tak, aby odpovídala cílové platformě.

Přejít

1. V integrovaném terminálu zkompilujte obslužnou rutinu do Linuxu/x64. V kořenovém adresáři aplikace funkcí se vytvoří binární název handler .

   macOS

   GOOS=linux GOARCH=amd64 go build handler.go
   

   Linux

   GOOS=linux GOARCH=amd64 go build handler.go
   

   Windows

   set GOOS=linux
   set GOARCH=amd64
   go build handler.go
   

   defaultExecutablePath Změňte host.json z handler.exe na handler. Tím aplikaci funkcí dáváte pokyn ke spuštění binárního souboru Linuxu.

Rez

1. Vytvořte soubor v souboru .cargo/config. Přidejte následující obsah a soubor uložte.

   [target.x86_64-unknown-linux-musl]
   linker = "rust-lld"
   

2. V integrovaném terminálu zkompilujte obslužnou rutinu do Linuxu/x64. Vytvoří se binární název handler . Zkopírujte ho do kořenového adresáře aplikace funkcí.

   rustup target add x86_64-unknown-linux-musl
   cargo build --release --target=x86_64-unknown-linux-musl
   cp target/x86_64-unknown-linux-musl/release/handler .
   

3. Pokud používáte Windows, změňte defaultExecutablePathhost.json z handler.exe na handler. Tím aplikaci funkcí dáváte pokyn ke spuštění binárního souboru Linuxu.

4. Do souboru .funcignore přidejte následující řádek:

   target
   

   Tím zabráníte publikování obsahu cílové složky.

Vytvoření aplikace funkcí v Azure

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

1. Na paletě příkazů zadejte Azure Functions: Vytvoření aplikace funkcí v Azure... (Upřesnit).

2. Pokud nejste přihlášení, zobrazí se výzva k přihlášení do Azure. Můžete také vytvořit bezplatný účet Azure. Po přihlášení z prohlížeče se vraťte do editoru Visual Studio Code.

3. Po zobrazení výzev zadejte tyto informace:

   Instrukce	Výběr
   Zadejte globálně jedinečný název nové aplikace funkcí.	Zadejte globálně jedinečný název, který identifikuje novou aplikaci funkcí, a pak vyberte Enter. Platné znaky pro název aplikace funkcí jsou a-z, 0-9 a -.
   Vyberte plán hostování.	Zvolte plán hostováníPremium, který poskytuje bezserverové hostování v Linuxu, který se dynamicky škáluje podle potřeby.
   Vyberte místo pro nové zdroje.	Vyberte umístění v oblasti blízko vás nebo v blízkosti jiných služeb, ke kterým vaše funkce přistupují. Zobrazí se jenom oblasti, které podporují vámi zvolený plán hostování.
   Vyberte běhové prostředí.	Vyberte vlastní obslužnou rutinu.
   Vyberte operační systém.	Vyberte Linux , protože aplikace byla zkompilována tak, aby běžela v Linuxu.
   Výběr plánu služby App Service pro Linux	V případě plánů Elastic Premium musíte explicitně vytvořit nový plán služby App Service, zadat název plánu a vybrat cenovou úroveň EP1 .
   Výběr typu ověřování zdrojů	Vyberte Spravovanou identitu, což je nejbezpečnější možnost připojení k výchozímu účtu úložiště hostitele. Při použití spravovaných identit s plánem Elastic Premium zůstane pro přístup ke službě Azure Files povolený přístup tajných klíčů k výchozímu úložišti hostitelů. Další informace najdete v tématu Spuštění bez Azure Files.
   Vyberte účet úložiště.	Zvolte Vytvořit nový účet úložiště a na příkazovém řádku zadejte globálně jedinečný název nového účtu úložiště, který používá vaše aplikace funkcí. Názvy účtů úložiště musí mít délku 3 až 24 znaků a můžou obsahovat jenom číslice a malá písmena.
   Vyberte prostředek Application Insights pro vaši aplikaci.	Zvolte Vytvořit nový prostředek Application Insights a na výzvu zadejte název instance použité k ukládání běhových dat z vašich funkcí.
   Vyberte identitu přiřazenou uživatelem	Zvolte Vytvořit novou identitu přiřazenou uživatelem. Tato identita se používá při přístupu k výchozímu účtu úložiště hostitele pomocí ověřování Microsoft Entra ID.

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

   

4. Po dokončení vytváření se ve vašem předplatném vytvoří následující prostředky Azure. Prostředky se pojmenují na základě názvu vaší aplikace funkcí:

   • Skupina prostředků, což je logický kontejner pro související prostředky.
   • 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 služby Aplikace Azure, který definuje základního hostitele vaší aplikace funkcí.
   • Standardní účet Azure Storage, který používá hostitel Functions k udržování stavu a dalších informací o vaší aplikaci funkcí.
   • Instance Application Insights, která je připojená k aplikaci funkcí a která sleduje použití funkcí v aplikaci.
   • Spravovaná identita přiřazená uživatelem přidaná do role Přispěvatel dat objektů blob služby Storage v novém výchozím účtu úložiště hostitele.
   • Spravovaná identita přiřazená uživatelem přidaná do role Přispěvatel dat objektů blob služby Storage v novém výchozím účtu úložiště hostitele.

   Po vytvoření aplikace funkcí a použití balíčku nasazení se zobrazí oznámení.

   Návod

   Ve výchozím nastavení se prostředky Azure vyžadované vaší aplikací funkcí vytvoří na základě názvu, který jste zadali pro aplikaci funkcí. Ve výchozím nastavení se prostředky vytvářejí pomocí aplikace funkcí ve stejné nové skupině prostředků. Pokud chcete přizpůsobit názvy přidružených zdrojů nebo znovu použít existující zdroje, publikujte projekt 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 paletě příkazů zadejte a pak vyberte Azure Functions: Nasadit do aplikace funkcí.

2. Vyberte aplikaci funkcí, kterou jste právě vytvořili. Po zobrazení výzvy k přepsání předchozích nasazení vyberte Nasadit a nasaďte kód funkce do nového prostředku aplikace funkcí.

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.

   

Spuštění funkce v Azure

1. Stisknutím klávesy F1 zobrazte paletu příkazů a pak vyhledejte a spusťte příkaz Azure Functions:Execute Function Now.... Pokud se zobrazí výzva, vyberte své předplatné.

2. Vyberte nový prostředek aplikace funkcí a HttpExample jako funkci.

3. V části Zadejte text požadavku a { "name": "Azure" }stisknutím klávesy Enter odešlete tuto zprávu požadavku do funkce.

4. Když se funkce spustí v Azure, zobrazí se odpověď v oznamovací oblasti. Rozbalte oznámení a zkontrolujte úplnou odpověď.

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

Až budete pokračovat k dalšímu 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.

Jinak můžete pomocí následujícího postupu 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í na webu Azure Portal.

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

   

4. Na stránce Skupina prostředků zkontrolujte seznam zahrnutých prostředků a ověřte, že se jedná o prostředky, 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 službu Functions najdete v tématu Odhad nákladů na plán Consumption.

Další kroky

Další informace o vlastních obslužných rutinách Azure Functions