Skapa din första funktion på Azure Arc (förhandsversion)

I den här snabbstarten skapar du ett Azure Functions-projekt och distribuerar det till en funktionsapp som körs i ett Azure Arc-aktiverat Kubernetes-kluster. Mer information finns i App Service, Functions och Logic Apps i Azure Arc. Det här scenariot stöder endast funktionsappar som körs på Linux.

Om du behöver anpassa containern där funktionsappen körs kan du i stället läsa Skapa dina första containerbaserade funktioner i Azure Arc (förhandsversion).

Förutsättningar

På den lokala datorn:

Installera Azure Functions Core Tools

Det rekommenderade sättet att installera Core Tools beror på operativsystemet på din lokala utvecklingsdator.

Skapa en App Service Kubernetes-miljö

Innan du börjar måste du skapa en App Service Kubernetes-miljö för ett Azure Arc-aktiverat Kubernetes-kluster.

Lägga till Azure CLI-tillägg

Starta Bash-miljön i Azure Cloud Shell.

Eftersom dessa CLI-kommandon ännu inte är en del av cli-kärnuppsättningen lägger du till dem med följande kommandon:

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

Skapa det lokala funktionsprojektet

I Azure Functions är ett funktionsprojekt enheten för distribution och körning för en eller flera enskilda funktioner som var och en svarar på en specifik utlösare. Alla funktioner i ett projekt delar samma lokala konfigurationer och värdkonfigurationer. I det här avsnittet skapar du ett funktionsprojekt som innehåller en enda funktion.

1. func init Kör kommandot så här för att skapa ett funktionsprojekt i en mapp med namnet LocalFunctionProj med den angivna körningen:

   • C#
   • JavaScript
   • Python
   • PowerShell

   func init LocalFunctionProj --dotnet
   

2. Navigera till projektmappen:

   cd LocalFunctionProj
   

   Den här mappen innehåller olika filer för projektet, inklusive konfigurationsfiler med namnet local.settings.json och host.json. Som standard undantas local.settings.json-filen från källkontrollen i .gitignore-filen. Det här undantaget beror på att filen kan innehålla hemligheter som laddas ned från Azure.

3. Lägg till en funktion i projektet med hjälp av följande kommando, där --name argumentet är det unika namnet på din funktion (HttpExample) och --template argumentet anger funktionens utlösare (HTTP).

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

Kör funktionen lokalt

1. Kör funktionen genom att starta den lokala Azure Functions-körningsvärden från mappen LocalFunctionProj .

   func start
   

   Mot slutet av utdata måste följande rader visas:

   

   Kommentar

   Om HttpExample inte visas som ovan startade du förmodligen värden utanför rotmappen i projektet. I så fall använder du Ctrl+C för att stoppa värden, går till projektets rotmapp och kör föregående kommando igen.

2. Kopiera URL:en för HTTP-funktionen från den här utdatan till en webbläsare och lägg till frågesträngen ?name=<YOUR_NAME>, vilket gör den fullständiga URL:en till exempel http://localhost:7071/api/HttpExample?name=Functions. Webbläsaren bör visa ett svarsmeddelande som upprepar frågesträngsvärdet. Terminalen där du startade projektet visar även loggutdata när du gör begäranden.

3. När du är klar trycker du på Ctrl + C och skriver y för att stoppa funktionsvärden.

Hämta den anpassade platsen

För att kunna skapa en funktionsapp på en anpassad plats måste du få information om miljön.

Hämta följande information om den anpassade platsen från klusteradministratören (se Skapa en anpassad plats).

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

Hämta det anpassade plats-ID:t för nästa steg.

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

Skapa Azure-resurser

Innan du kan distribuera funktionskoden till den nya App Service Kubernetes-miljön måste du skapa ytterligare två resurser:

• Ett lagringskonto. Även om den här artikeln skapar ett lagringskonto kanske det i vissa fall inte krävs något lagringskonto. Mer information finns i Azure Arc-aktiverade kluster i artikeln om lagringsöverväganden.
• En funktionsapp som tillhandahåller kontexten för att köra funktionskoden. Funktionsappen körs i App Service Kubernetes-miljön och mappar till ditt lokala funktionsprojekt. I en funktionsapp kan du gruppera funktioner som en logisk enhet så att det blir enklare att hantera, distribuera och dela resurser.

Skapa lagringskonto

Använd kommandot az storage account create för att skapa ett allmänt lagringskonto i din resursgrupp och region:

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

I föregående exempel ersätter du <STORAGE_NAME> med ett namn som är lämpligt för dig och unikt i Azure Storage. Namn får endast innehålla siffror med tre till 24 tecken och gemener. Standard_LRS anger ett konto för generell användning som stöds av Functions. Värdet --location är en Azure-standardregion.

Skapa funktionsappen

Kör kommandot az functionapp create för att skapa en ny funktionsapp i miljön.

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

I det här exemplet ersätter <CUSTOM_LOCATION_ID> du med ID:t för den anpassade plats som du fastställde för App Service Kubernetes-miljön. Ersätt <STORAGE_NAME> också med namnet på det konto som du använde i föregående steg och ersätt <APP_NAME> med ett globalt unikt namn som passar dig.

Distribuera funktionsprojektet till Azure

När du har skapat funktionsappen func azure functionapp publish i Azure är du nu redo att distribuera ditt lokala funktionsprojekt med hjälp av kommandot .

Kör det här func azure functionapp publish kommandot i rotprojektmappen:

func azure functionapp publish <APP_NAME>

I det här exemplet ersätter du <APP_NAME> med namnet på din app. En lyckad distribution visar resultat som liknar följande utdata (trunkerade för enkelhetens skull):

...

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

Eftersom det kan ta lite tid för en fullständig distribution att slutföras i ett Azure Arc-aktiverat Kubernetes-kluster kanske du vill köra följande kommando igen för att verifiera dina publicerade funktioner:

func azure functionapp list-functions

Anropa funktionen i Azure

Eftersom funktionen använder en HTTP-utlösare anropar du den genom att göra en HTTP-begäran till dess URL i webbläsaren eller med ett verktyg som curl.

Nästa steg

Nu när din funktionsapp körs i en container i en Azure Arc-aktiverad App Service Kubernetes-miljö kan du ansluta den till Azure Storage genom att lägga till en Queue Storage-utdatabindning.