Vytvoření první funkce ve službě Azure Arc (Preview)

V tomto rychlém startu vytvoříte projekt Azure Functions a nasadíte ho do aplikace funkcí spuštěné v clusteru Kubernetes s podporou Azure Arc. Další informace najdete v tématu App Service, Functions a Logic Apps ve službě Azure Arc. Tento scénář podporuje jenom aplikace funkcí spuštěné v Linuxu.

Pokud potřebujete přizpůsobit kontejner, ve kterém běží vaše aplikace funkcí, přečtěte si místo toho téma Vytvoření prvních kontejnerizovaných funkcí ve službě Azure Arc (Preview).

Požadavky

Na místním počítači:

Instalace nástrojů Azure Functions Core

Doporučený způsob instalace nástrojů Core Tools závisí na operačním systému místního vývojového počítače.

Vytvoření prostředí Kubernetes služby App Service

Než začnete, musíte vytvořit prostředí Kubernetes služby App Service pro cluster Kubernetes s podporou Azure Arc.

Přidání rozšíření Azure CLI

Spusťte prostředí Bash v Azure Cloud Shellu.

Protože tyto příkazy rozhraní příkazového řádku ještě nejsou součástí základní sady rozhraní příkazového řádku, přidejte je následujícími příkazy:

az extension add --upgrade --yes --name customlocation
az extension remove --name appservice-kube
az extension add --upgrade --yes --name appservice-kube

Vytvoření projektu místní funkce

Ve službě Azure Functions je projekt funkcí jednotkou nasazení a spouštění pro jednu nebo více jednotlivých funkcí, které každá reaguje na konkrétní trigger. Všechny funkce v projektu sdílejí stejné místní a hostitelské konfigurace. V této části vytvoříte projekt funkce, který obsahuje jednu funkci.

1. Spuštěním func init následujícího příkazu vytvořte projekt funkcí ve složce s názvem LocalFunctionProj se zadaným modulem runtime:

   • C#
   • JavaScript
   • Python
   • PowerShell

   func init LocalFunctionProj --dotnet
   

2. Přejděte do složky projektu:

   cd LocalFunctionProj
   

   Tato složka obsahuje různé soubory projektu, včetně konfiguračních souborů pojmenovaných local.settings.json a host.json. Ve výchozím nastavení je soubor local.settings.json vyloučen ze správy zdrojového kódu v souboru .gitignore . Toto vyloučení je způsobeno tím, že soubor může obsahovat tajné kódy, které se stáhnou z Azure.

3. Přidejte do projektu funkci pomocí následujícího příkazu, kde --name argument je jedinečný název funkce (HttpExample) a --template argument určuje trigger funkce (HTTP).

   func new --name HttpExample --template "HTTP trigger" --authlevel "anonymous"
   

Místní spuštění funkce

1. Spusťte funkci spuštěním místního hostitele modulu runtime Azure Functions ze složky LocalFunctionProj .

   func start
   

   Na konci výstupu se musí zobrazit následující řádky:

   

   Poznámka:

   Pokud se httpExample nezobrazí, jak je znázorněno výše, pravděpodobně jste hostitele spustili mimo kořenovou složku projektu. V takovém případě pomocí ctrl+C zastavte hostitele, přejděte do kořenové složky projektu a spusťte předchozí příkaz znovu.

2. Zkopírujte adresu URL funkce HTTP z tohoto výstupu do prohlížeče a připojte řetězec ?name=<YOUR_NAME>dotazu, čímž se úplná adresa URL podobá http://localhost:7071/api/HttpExample?name=Functions. Prohlížeč by měl zobrazit zprávu s odpovědí, která vrací hodnotu řetězce dotazu. V terminálu, ve kterém jste spustili projekt, se při provádění požadavků zobrazuje také výstup protokolu.

3. Až budete hotovi, stiskněte Ctrl+C a stisknutím y kláves Ctrl+C zastavte hostitele funkcí.

Získání vlastního umístění

Abyste mohli vytvořit aplikaci funkcí ve vlastním umístění, budete muset získat informace o prostředí.

Získejte následující informace o vlastním umístění od správce clusteru (viz Vytvoření vlastního umístění).

customLocationGroup="<resource-group-containing-custom-location>"
customLocationName="<name-of-custom-location>"

Získejte ID vlastního umístění pro další krok.

customLocationId=$(az customlocation show \
    --resource-group $customLocationGroup \
    --name $customLocationName \
    --query id \
    --output tsv)

Vytvoření zdrojů Azure

Než budete moct nasadit kód funkce do nového prostředí Kubernetes služby App Service, musíte vytvořit dva další prostředky:

• Účet úložiště. Tento článek sice vytvoří účet úložiště, ale v některých případech se nemusí vyžadovat účet úložiště. Další informace najdete v článku o aspektech úložiště v clusterech s podporou Služby Azure Arc.
• Aplikace funkcí, která poskytuje kontext pro spuštění kódu funkce. Aplikace funkcí běží v prostředí Kubernetes služby App Service a mapuje se na místní projekt funkcí. Aplikace funkcí umožňuje seskupit funkce jako logickou jednotku pro snadnější správu, nasazení a sdílení prostředků.

Vytvoření účtu úložiště

Pomocí příkazu az storage account create vytvořte účet úložiště pro obecné účely ve vaší skupině prostředků a oblasti:

az storage account create --name <STORAGE_NAME> --location westeurope --resource-group myResourceGroup --sku Standard_LRS

V předchozím příkladu nahraďte <STORAGE_NAME> názvem, který je pro vás a jedinečný v Azure Storage. Názvy musí obsahovat jenom číslice se třemi až 24 znaky a malými písmeny. Standard_LRS určuje účet pro obecné účely, který služba Functions podporuje. Hodnota --location je standardní oblast Azure.

Vytvoření aplikace funkcí

Spuštěním příkazu az functionapp create vytvořte novou aplikaci funkcí v prostředí.

az functionapp create --resource-group MyResourceGroup --name <APP_NAME> --custom-location <CUSTOM_LOCATION_ID> --storage-account <STORAGE_NAME> --functions-version 4 --runtime dotnet 

az functionapp create --resource-group MyResourceGroup --name <APP_NAME> --custom-location <CUSTOM_LOCATION_ID> --storage-account <STORAGE_NAME> --functions-version 4 --runtime node --runtime-version 18

az functionapp create --resource-group MyResourceGroup --name <APP_NAME> --custom-location <CUSTOM_LOCATION_ID> --storage-account <STORAGE_NAME> --functions-version 4 --runtime python --runtime-version 3.8

az functionapp create --resource-group myResourceGroup --name <APP_NAME> --custom-location <CUSTOM_LOCATION_ID> --storage-account <STORAGE_NAME> --functions-version 4 --runtime powershell --runtime-version 7.0

V tomto příkladu nahraďte <CUSTOM_LOCATION_ID> ID vlastního umístění, které jste určili pro prostředí Kubernetes služby App Service. Nahraďte <STORAGE_NAME> také názvem účtu, který jste použili v předchozím kroku, a nahraďte <APP_NAME> globálně jedinečným názvem, který je pro vás vhodný.

Nasazení projektu funkce do Azure

Po úspěšném vytvoření aplikace funkcí v Azure teď můžete pomocí příkazu nasadit místní projekt func azure functionapp publish funkcí.

Ve složce kořenového projektu spusťte tento func azure functionapp publish příkaz:

func azure functionapp publish <APP_NAME>

V tomto příkladu nahraďte <APP_NAME> názvem vaší aplikace. Úspěšné nasazení ukazuje výsledky podobné následujícímu výstupu (zkráceně kvůli jednoduchosti):

...

Getting site publishing info...
Creating archive for current directory...
Performing remote build for functions project.

...

Deployment successful.
Remote build succeeded!
Syncing triggers...
Functions in msdocs-azurefunctions-qs:
    HttpExample - [httpTrigger]
        Invoke url: https://msdocs-azurefunctions-qs.azurewebsites.net/api/httpexample

Vzhledem k tomu, že dokončení úplného nasazení v clusteru Kubernetes s podporou Azure Arc může nějakou dobu trvat, můžete znova spustit následující příkaz, abyste ověřili publikované funkce:

func azure functionapp list-functions

Vyvolání funkce v Azure

Vzhledem k tomu, že vaše funkce používá trigger HTTP, vyvoláte ji tak, že v prohlížeči nebo pomocí nástroje, jako je curl, vytvoří požadavek HTTP na jeho adresu URL.

Další kroky

Teď, když máte aplikaci funkcí spuštěnou v kontejneru v prostředí Kubernetes s podporou Služby App Service s podporou Služby Azure Arc, můžete ji připojit ke službě Azure Storage přidáním výstupní vazby Queue Storage.