Rychlý Start: vytvoření funkce přejít nebo Rust v Azure pomocí Visual Studio Code

Článek
11/24/2021
9 min ke čtení

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

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

Po dokončení tohoto rychlého startu dojde v účtu Azure k malým nákladům na několik centů nebo méně.

Konfigurace prostředí

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

Přejít
Rust

Účet Azure s aktivním předplatným. Vytvořte si účet zdarma.
Visual Studio Code na jedné z podporovaných platforem
Rozšíření Azure Functions pro Visual Studio Code
Azure Functions Core Tools verze 3. x. Pomocí func --version příkazu ověřte, zda je správně nainstalován.
Přejít, doporučuje se nejnovější verze. Pomocí go version příkazu ověřte svou verzi.

Vytvořit místní projekt

v této části použijete Visual Studio Code k vytvoření místního projektu Azure Functions vlastní obslužné rutiny. Později v tomto článku publikujete kód funkce do Azure.

Zvolte ikonu Azure na panelu Aktivita a pak v oblasti Azure: Funkce vyberte ikonu Vytvořit nový projekt.
Zvolte umístění adresáře pro váš pracovní prostor projektu a zvolte Vybrat.

Poznámka

Tyto kroky jsou navržené tak, aby se dokončily mimo pracovní prostor. V tomto případě nevybírejte složku projektu, která je součástí pracovního prostoru.
Podle pokynů na obrazovce zadejte tyto informace:
- Vyberte jazyk pro váš projekt funkce: Zvolte Custom.
- Vyberte šablonu pro první funkci projektu: Zvolte HTTP trigger.
- Zadejte název funkce: Zadejte příkaz HttpExample.
- Úroveň autorizace: vyberte Anonymous , který umožňuje komukoli zavolat 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.
pomocí těchto informací Visual Studio Code generuje projekt Azure Functions pomocí funkce triggeru HTTP. Můžete zobrazit soubory místních projektů v Průzkumníkovi. Další informace o souborech, které jsou vytvořeny, najdete v tématu vygenerované soubory projektu.

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 zkompilováním do spustitelného souboru.

Přejít
Rust

Stisknutím kombinace kláves Ctrl + n (cmd + n v MacOS) vytvořte nový soubor. Uložte ho jako obslužnou rutinu. v kořenovém adresáři aplikace Function App (ve stejné složce jako Host. JSON).

V obslužné rutině. přejít přidejte následující kód a soubor uložte. Toto je vlastní obslužná rutina přejít.

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))
}

Stisknutím kombinace kláves CTRL + SHIFT + nebo vybráním nového terminálu z nabídky terminálu otevřete nový integrovaný terminál v vs Code.
Zkompilujte vlastní obslužnou rutinu pomocí následujícího příkazu. spustitelný soubor s názvem handler ( handler.exe na Windows) je výstupem v kořenové složce aplikace function app.
```
go build handler.go
```

Stisknutím kombinace kláves CTRL + SHIFT + nebo vybráním nového terminálu z nabídky terminálu otevřete nový integrovaný terminál v vs Code.
V kořenovém adresáři aplikace Function App (ve stejné složce jako Host. JSON) inicializujte projekt Rust s názvem handler .
```
cargo init --name handler
```
Do pole náklad. toml přidejte následující závislosti, které jsou nezbytné k dokončení tohoto rychlého startu. V příkladu se používá architektura webového serveru v křivce .
```
[dependencies]
warp = "0.3"
tokio = { version = "1", features = ["rt", "macros", "rt-multi-thread"] }
```

V části Src/Main. RS přidejte následující kód a soubor uložte. Toto je 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::UNSPECIFIED, port)).await
}

Zkompilujte binární soubor pro vlastní obslužnou rutinu. spustitelný soubor s názvem handler ( handler.exe na Windows) je výstupem v kořenové složce aplikace function app.
```
cargo build --release
cp target/release/handler .
```

Konfigurace aplikace Function App

Aby bylo možné spustit vlastní binární soubor obslužné rutiny při spuštění, je nutné nakonfigurovat hostitele funkce.

Otevřete Host. JSON.
v customHandler.description části nastavte hodnotu defaultExecutablePath na handler (na Windows, nastavte na handler.exe ).
V customHandler části přidejte vlastnost s názvem enableForwardingHttpRequest a nastavte její hodnotu na true . U funkcí, které se skládají jenom z triggeru HTTP, toto nastavení zjednodušuje programování tím, že vám umožní pracovat s typickým požadavkem HTTP místo v datové části žádostio vlastní obslužnou rutinu.

Potvrďte, že customHandler oddíl vypadá jako v tomto příkladu. Soubor uložte.

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

Aplikace Function App je nakonfigurována tak, aby spouštěla vlastní spustitelný soubor 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.

V integrovaném terminálu spusťte aplikaci Function App pomocí Azure Functions Core Tools.
```
func start
```
Pokud běží základní nástroje, přejděte na následující adresu URL a spusťte požadavek GET, který zahrnuje ?name=Functions řetězec dotazu.

http://localhost:7071/api/HttpExample?name=Functions
Vrátí se odpověď, která v prohlížeči vypadá jako v následujících případech:
Informace o žádosti se zobrazí na panelu terminálu .
Stisknutím kombinace kláves CTRL + C zastavte základní nástroje.

po ověření, že se funkce na místním počítači spustí správně, je čas použít Visual Studio Code k publikování projektu přímo do Azure.

Než můžete aplikaci publikovat, musíte se přihlásit do Azure.

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.
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.
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 Function App se systémem Linux. Ve většině případů je před publikováním do Azure nutné znovu zkompilovat binární soubor a upravit konfiguraci tak, aby odpovídala cílové platformě.

Přejít
Rust

V integrovaném terminálu zkompilujte obslužnou rutinu na Linux/x64. handlerV kořenu aplikace Function App se vytvoří binární soubor s názvem.
- macOS
- Linux
- Windows
```
GOOS=linux GOARCH=amd64 go build handler.go
```
```
GOOS=linux GOARCH=amd64 go build handler.go
```
```
set GOOS=linux
set GOARCH=amd64
go build handler.go
```
Změňte defaultExecutablePath v umístění Host. JSON z handler.exe na handler . Tím se dá aplikaci Function App spustit binární soubor Linux.

Vytvořte soubor v souboru . náklad/config. Přidejte následující obsah a uložte soubor.
```
[target.x86_64-unknown-linux-musl]
linker = "rust-lld"
```
V integrovaném terminálu zkompilujte obslužnou rutinu na Linux/x64. Vytvoří se binární handler soubor s názvem . 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 .
```
Pokud používáte soubor Windows, změňte v defaultExecutablePath souboru host.json z handler.exe na handler . Tím aplikaci funkcí instruuje, aby spouštěl binární soubor Linuxu.
Do souboru .funcignore přidejte následující řádek:
```
target
```
Tím se zabrání publikování obsahu cílové složky.

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.

Důležité

Publikování do existující aplikace funkcí přepíše obsah této aplikace v Azure.

Na panelu aktivita zvolte ikonu Azure a pak v oblasti Azure: Funkce zvolte tlačítko Nasadit do aplikace funkcí.
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 (advanced).
  
  Důležité
  
  Možnost umožňuje zvolit konkrétní operační systém, ve kterém vaše aplikace funkcí běží v Azure, což je v advanced tomto případě Linux.
- 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 byl v souboru Azure Functions.
- Vyberte zásobník modulu runtime: Zvolte Custom Handler .
- Vyberte operační systém: Zvolte Linux .
- Vyberte plán hostování: Zvolte Consumption .
- Vyberte skupinu prostředků: Zvolte + Create new resource group . Zadejte název skupiny prostředků. Tento název musí být jedinečný v rámci vašeho předplatného Azure. Můžete použít název navrhovaný v příkazovém řádku.
- Vyberte účet úložiště: Zvolte + Create new storage account . Tento název musí být globálně jedinečný v rámci Azure. Můžete použít název navrhovaný v příkazovém řádku.
- Vyberte prostředek Application Přehledy: Zvolte + Create Application Insights resource . Tento název musí být globálně jedinečný v rámci Azure. Můžete použít název navrhovaný v příkazovém řádku.
- 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.
Po dokončení se ve vašem předplatném vytvoří následující prostředky Azure:
- 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í.
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

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

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 .
Zvolte aplikaci Function App a stiskněte klávesu ENTER. Na Azure Portal se otevře stránka Function App.
Na kartě Přehled vyberte odkaz s názvem vedle skupiny prostředků.
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 spotřeby.

Další kroky

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