Skapa och hantera funktionsappar i Flex Consumption-planen

1. Om du inte redan har gjort det loggar du in på Azure:

   az login
   

   Kommandot az login loggar in dig på ditt Azure-konto.

2. az functionapp list-flexconsumption-locations Använd kommandot för att granska listan över regioner som för närvarande stöder Flex Consumption i alfabetisk ordning.

   az functionapp list-flexconsumption-locations --query "sort_by(@, &name)[].{Region:name}" -o table
   

3. Skapa en resursgrupp i en av de regioner som stöds för närvarande:

   az group create --name <RESOURCE_GROUP> --location <REGION>
   

   I föregående kommando ersätter du <RESOURCE_GROUP> med ett värde som är unikt i din prenumeration och <REGION> med en av de regioner som stöds för närvarande. Kommandot az group create skapar en resursgrupp.

4. Skapa ett allmänt lagringskonto i din resursgrupp och region:

   az storage account create --name <STORAGE_NAME> --location <REGION> --resource-group <RESOURCE_GROUP> --sku Standard_LRS --allow-blob-public-access false
   

   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. Kommandot az storage account create skapar lagringskontot.

   Viktigt!

   Lagringskontot används för att lagra viktiga appdata, ibland inklusive själva programkoden. Du bör begränsa åtkomsten från andra appar och användare till lagringskontot.

5. Skapa funktionsappen i Azure:

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime dotnet-isolated --runtime-version 8.0 
   

   C#-appar som körs i processen stöds för närvarande inte när de körs i en Flex Consumption-plan.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime java --runtime-version 17 
   

   Java 11 stöds också för närvarande för Java-appar.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime node --runtime-version 20 
   

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime python --runtime-version 3.11 
   

   Python 3.10 stöds också för närvarande för Python-appar.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime powershell --runtime-version 7.4 
   

   I det här exemplet ersätter du både <RESOURCE_GROUP> och <STORAGE_NAME> med resursgruppen och namnet på det konto som du använde i föregående steg. Ersätt <APP_NAME> även med ett globalt unikt namn som passar dig. <APP_NAME> är också dns-standarddomänen (domain name server) för funktionsappen. Kommandot az functionapp create skapar funktionsappen i Azure.

   Det här kommandot skapar en funktionsapp som körs i Flex Consumption-planen.

   Eftersom du har skapat appen utan att ange alltid redo instanser medför din app endast kostnader när du aktivt kör funktioner. Kommandot skapar också en associerad Azure Application Insights-instans i samma resursgrupp, med vilken du kan övervaka funktionsappen och visa loggar. Mer information finns i Övervaka Azure Functions.

1. I Azure Portal går du till menyn eller startsidan och väljer Skapa en resurs.

2. Välj Kom igång och sedan Skapa under Funktionsapp.

3. Under Välj ett värdalternativ väljer du Flex Consumption Select (Flex Consumption>Select).

4. På sidan Grundläggande använder du inställningarna för funktionsappen enligt beskrivningen i följande tabell:

   Inställning	Föreslaget värde	beskrivning
   Abonnemang	Din prenumeration	Prenumerationen där du skapar din nya funktionsapp.
   Resursgrupp	myResourceGroup	Namn på den nya resursgrupp där du skapar funktionsappen.
   Funktionsappens namn	Globalt unikt namn	Namn som identifierar din nya funktionsapp. Giltiga tecken är a-z (skiftlägesokänsligt), 0-9 och -.
   Region	Önskad region	Välj en region som är nära dig eller nära andra tjänster som dina funktioner kan komma åt. Regioner som inte stöds visas inte. Mer information finns i Visa regioner som stöds för närvarande.
   Körningsstack	Önskat språk	Välj en av de språkkörningsstackar som stöds. Redigering i portalen med Visual Studio Code för webben är för närvarande endast tillgängligt för Node.js, PowerShell och Python-appar. C#-klassbibliotek och Java-funktioner måste utvecklas lokalt.
   Version:	Språkversion	Välj en version av språkkörningsstacken som stöds.
   Instansstorlek	Standardvärde	Avgör hur mycket instansminne som allokeras för varje instans av din app. Mer information finns i Instansstorlekar.

5. Acceptera standardalternativen på de återstående flikarna, inklusive standardbeteendet för att skapa ett nytt lagringskonto på fliken Lagring och en ny Application Insight-instans på fliken Övervakning . Du kan också välja att använda ett befintligt lagringskonto eller En Application Insights-instans.

6. Välj Granska + skapa för att granska appkonfigurationen du valde och välj sedan Skapa för att etablera och distribuera funktionsappen.

7. Välj ikonen Meddelanden i det övre högra hörnet i portalen och håll utkik efter meddelandet Distributionen lyckades.

8. Välj Gå till resurs för att se den nya funktionsappen. Du kan också välja Fäst på instrumentpanelen. Med fästning blir det enklare att återgå till den här funktionsappresursen från instrumentpanelen.

1. Tryck på F1 och i kommandopaletten anger du Azure Functions: Skapa funktionsapp i Azure... (Avancerat).

2. Om du inte är inloggad uppmanas du att logga in på Azure. Du kan också skapa ett kostnadsfritt Azure-konto. När du har loggat in från webbläsaren går du tillbaka till Visual Studio Code.

3. Ange följande information genom att följa anvisningarna:

   Omedelbar	Urval
   Ange ett globalt unikt namn för den nya funktionsappen.	Ange ett globalt unikt namn som identifierar din nya funktionsapp och välj sedan Retur. Giltiga tecken i ett namn på en funktionsapp är a-z, 0-9 och -.
   Välj en värdplan.	Välj Flex-förbrukning.
   Välj en körningsstack.	Välj en av språkstackens versioner som stöds.
   Välj en resursgrupp för nya resurser.	Välj Skapa ny resursgrupp och skriv ett resursgruppsnamn, till exempel myResourceGroup, och välj sedan retur. Du kan också välja en befintlig resursgrupp.
   Välj en plats för nya resurser.	Välj en plats i en region som stöds nära dig eller nära andra tjänster som dina funktioner har åtkomst till. Regioner som inte stöds visas inte. Mer information finns i Visa regioner som stöds för närvarande.
   Välj ett lagringskonto.	Välj Skapa nytt lagringskonto och ange ett globalt unikt namn för det nya lagringskontot som används av funktionsappen i prompten och välj sedan Retur. Lagringskontonamn måste vara mellan 3 och 24 tecken långa och får endast innehålla siffror och gemener. Du kan också välja ett befintligt konto.
   Välj en Application Insights-resurs för din app.	Välj Skapa ny Application Insights-resurs och ange i prompten namnet på den instans som används för att lagra körningsdata från dina funktioner.

   Ett meddelande visas när funktionsappen har skapats. Välj Visa utdata i det här meddelandet för att visa skapande- och distributionsresultatet, inklusive de Azure-resurser som du skapade.

Du kan använda Azure CLI för att ladda upp en distributionspaketfil till distributionsresursen för funktionsappen i Azure. För att göra detta måste du skapa en .zip paketfil som kan köras när paketet monteras i din app.

Azure Functions har både en anpassad GitHub-åtgärd och en anpassad Azure Pipelines-uppgift som stöd för kontinuerlig distribution. Se följande guider för att införliva dessa verktyg i dina CI/CD-pipelines:

• Skapa och distribuera med Hjälp av Azure Pipelines
• Skapa och distribuera med GitHub Actions

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

1. I kommandopaletten anger du och väljer sedan Azure Functions: Deploy to Function App (Azure Functions: Distribuera till funktionsapp).

2. Välj den funktionsapp som du nyss skapade. När du uppmanas att skriva över tidigare distributioner väljer du Distribuera för att distribuera funktionskoden till den nya funktionsappresursen.

3. När distributionen är klar väljer du Visa utdata för att visa resultatet av skapandet och distributionen, inklusive de Azure-resurser som du skapade. Om du missar meddelandet väljer du klockikonen i det nedre högra hörnet för att se det igen.

   

Du kan aktivera integrering av virtuella nätverk genom att az functionapp create köra kommandot och inkludera parametrarna --vnet och --subnet .

1. Skapa det virtuella nätverket och undernätet om du inte redan har gjort det.

2. Slutför steg 1–4 i Skapa en Flex Consumption-app för att skapa de resurser som krävs av din app.

3. az functionapp create Kör kommandot, inklusive parametrarna --vnet och --subnet som i det här exemplet:

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime <RUNTIME_NAME> --runtime-version <RUNTIME_VERSION> --vnet <VNET_RESOURCE_ID> --subnet <SUBNET_NAME>
   

   Värdet <VNET_RESOURCE_ID> är resurs-ID:t för det virtuella nätverket, som har formatet : /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.Network/virtualNetworks/<VNET_NAME>. Du kan använda det här kommandot för att hämta en lista över virtuella nätverks-ID:n, filtrerade efter <RESOURCE_GROUP>: az network vnet list --resource-group <RESOURCE_GROUP> --output tsv --query "[]".id.

Använd de här stegen för att skapa funktionsappen med integrering av virtuella nätverk och relaterade Azure-resurser.

1. I Azure Portal går du till menyn eller startsidan och väljer Skapa en resurs.

2. Välj Kom igång och sedan Skapa under Funktionsapp.

3. Under Välj ett värdalternativ väljer du Flex Consumption Select (Flex Consumption>Select).

4. På sidan Grundläggande använder du inställningarna för funktionsappen enligt beskrivningen i följande tabell:

   Inställning	Föreslaget värde	beskrivning
   Abonnemang	Din prenumeration	Prenumerationen där du skapar din nya funktionsapp.
   Resursgrupp	myResourceGroup	Namn på den nya resursgrupp där du skapar funktionsappen.
   Funktionsappens namn	Globalt unikt namn	Namn som identifierar din nya funktionsapp. Giltiga tecken är a-z (skiftlägesokänsligt), 0-9 och -.
   Region	Önskad region	Välj en region som är nära dig eller nära andra tjänster som dina funktioner kan komma åt. Regioner som inte stöds visas inte. Mer information finns i Visa regioner som stöds för närvarande.
   Körningsstack	Önskat språk	Välj en av de språkkörningsstackar som stöds. Redigering i portalen med Visual Studio Code för webben är för närvarande endast tillgängligt för Node.js, PowerShell och Python-appar. C#-klassbibliotek och Java-funktioner måste utvecklas lokalt.
   Version:	Språkversion	Välj en version av språkkörningsstacken som stöds.
   Instansstorlek	Standardvärde	Avgör hur mycket instansminne som allokeras för varje instans av din app. Mer information finns i Instansstorlekar.

5. Acceptera standardalternativen på de återstående flikarna, inklusive standardbeteendet för att skapa ett nytt lagringskonto på fliken Lagring och en ny Application Insight-instans på fliken Övervakning . Du kan också välja att använda ett befintligt lagringskonto eller En Application Insights-instans.

6. På fliken Nätverk anger du Aktivera offentlig åtkomst till Av och Aktivera nätverksinmatning till På.

7. För Virtuellt nätverk väljer eller skapar du ett virtuellt nätverk som finns i samma region som din app.

8. Ange Aktivera VNet-integrering till På och välj eller skapa ett undernät.

9. Välj Granska + skapa för att granska appkonfigurationen du valde och välj sedan Skapa för att etablera och distribuera funktionsappen med virtuella nätverk.

10. Välj ikonen Meddelanden i det övre högra hörnet i portalen och håll utkik efter meddelandet Distributionen lyckades.

11. Välj Gå till resurs för att se den nya funktionsappen. Du kan också välja Fäst på instrumentpanelen. Med fästning blir det enklare att återgå till den här funktionsappresursen från instrumentpanelen.

Du kan för närvarande inte aktivera virtuella nätverk när du använder Visual Studio Code för att skapa din app.

Använd kommandot för att aktivera integrering av az functionapp vnet-integration add virtuella nätverk i en befintlig funktionsapp:

az functionapp vnet-integration add --resource-group <RESOURCE_GROUP> --name <APP_NAME> --vnet <VNET_RESOURCE_ID> --subnet <SUBNET_NAME>

Använd kommandot för att inaktivera integrering av az functionapp vnet-integration remove virtuella nätverk i din app:

az functionapp vnet-integration remove --resource-group <RESOURCE_GROUP> --name <APP_NAME>

az functionapp vnet-integration list Använd kommandot för att lista de aktuella integreringarna av virtuella nätverk för din app:

az functionapp vnet-integration list --resource-group <RESOURCE_GROUP> --name <APP_NAME>

Du kan integrera din befintliga app med ett befintligt virtuellt nätverk och undernät i portalen.

1. På funktionsappsidan i Azure Portal expanderar du Inställningar på den vänstra menyn och väljer Nätverk.

2. Under Konfiguration av utgående trafik väljer du Inte konfigurerad.

3. På sidan Integrering av virtuellt nätverk väljer du Lägg till integrering av virtuellt nätverk.

4. Välj ett befintligt virtuellt nätverk och undernät och välj Anslut.

Du kan för närvarande inte konfigurera virtuella nätverk i Visual Studio Code.

az functionapp create Använd kommandot och ange dessa extra alternativ som anpassar distributionslagringen:

Det här exemplet skapar en funktionsapp i Flex Consumption-planen med ett separat distributionslagringskonto och användartilldelad identitet:

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime dotnet-isolated --runtime-version 8.0 --flexconsumption-location "<REGION>" --deployment-storage-name <DEPLOYMENT_ACCOUNT_NAME> --deployment-storage-container-name <DEPLOYMENT_CONTAINER_NAME> --deployment-storage-auth-type UserAssignedIdentity --deployment-storage-auth-value <MI_RESOURCE_ID>

Du kan för närvarande inte konfigurera distributionslagring när du skapar din app i Azure Portal. Om du vill konfigurera distributionslagring när appen skapas använder du i stället Azure CLI för att skapa din app.

Du kan använda portalen för att ändra distributionsinställningarna för en befintlig app, enligt beskrivningen i nästa avsnitt.

Du kan för närvarande inte konfigurera distributionslagring när du skapar din app i Azure med hjälp av Visual Studio Code.

az functionapp deployment config set Använd kommandot för att ändra distributionslagringskonfigurationen:

az functionapp deployment config set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --deployment-storage-name <DEPLOYMENT_ACCOUNT_NAME> --deployment-storage-container-name <DEPLOYMENT_CONTAINER_NAME>

1. På funktionsappsidan i Azure Portal expanderar du Inställningar på den vänstra menyn och väljer Distributionsinställningar.

2. Under Programpaketplats väljer du ett befintligt lagringskonto och väljer sedan en befintlig tom container i kontot.

3. Under Lagringsautentisering väljer du önskad autentiseringstyp

   • Om du har valt Anslutningssträng väljer du namnet på appinställningen som innehåller anslutningssträng för distributionslagringskontot.

   • Om du har valt Användartilldelad identitet väljer du den identitet som du vill använda.

4. Välj Spara för att uppdatera appen.

Du kan för närvarande inte konfigurera distributionslagring för din app i Azure med hjälp av Visual Studio Code.

Ange parametern --instance-memory i kommandot az functionapp create . I det här exemplet skapas en C#-app med instansstorleken 4096:

az functionapp create --instance-memory 4096 --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime dotnet-isolated --runtime-version 8.0

När du skapar din app i en Flex Consumption-plan i Azure Portal kan du välja din minnesstorlek för instansen i fältet Instansstorlek på fliken Grundläggande. Mer information finns i Skapa en Flex Consumption-app.

Du kan för närvarande inte styra minnesstorleken för instansen när du använder Visual Studio Code för att skapa din app. Standardstorleken används.

I det az functionapp scale config set här exemplet används kommandot för att ändra inställningen för minnesstorlek för instansen till 512 MB:

az functionapp scale config set --resource-group <resourceGroup> --name <APP_NAME> --instance-memory 512

1. På funktionsappsidan i Azure Portal expanderar du Inställningar på den vänstra menyn och väljer Skala och samtidighet.

2. Välj ett alternativ för instansminne och välj Spara för att uppdatera appen.

Du kan för närvarande inte ändra inställningen för minnesstorlek för instansen för din app med hjälp av Visual Studio Code.

Om du vill definiera en eller flera alltid redo instansbeteckningar använder du parametern --always-ready-instances med az functionapp create kommandot . I det här exemplet anges antalet alltid redo instanser för alla HTTP-utlösta funktioner till 5:

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime <LANGUAGE_RUNTIME> --runtime-version <RUNTIME_VERSION> --flexconsumption-location <REGION> --always-ready-instances http=10

Det här exemplet anger antalet alltid redo instanser för alla Durable-utlösarfunktioner till 3 och anger antalet alltid redo instanser till 2 för en Service Bus-utlöst funktion med namnet function5:

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime <LANGUAGE_RUNTIME> --runtime-version <RUNTIME_VERSION> --flexconsumption-location <REGION> --always-ready-instances durable=3 function:function5=2

Du kan för närvarande inte definiera alltid redo instanser när du skapar din app i Azure Portal. Om du vill definiera alltid redo instanser när appen skapas använder du i stället Azure CLI för att skapa din app.

Du kan använda portalen för att ändra alltid redo instanser i en befintlig app, enligt beskrivningen i nästa avsnitt.

Du kan för närvarande inte definiera alltid redo instanser när du skapar din app i Azure med hjälp av Visual Studio Code.

I det az functionapp scale config always-ready set här exemplet används kommandot för att ändra antalet alltid redo instanser för gruppen HTTP-utlösare till 10:

az functionapp scale config always-ready set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --settings http=10

Om du vill ta bort alltid redo instanser använder du az functionapp scale config always-ready delete kommandot, som i det här exemplet som tar bort alla alltid redo instanser från både GRUPPEN HTTP-utlösare och även en funktion med namnet hello_world:

az functionapp scale config always-ready delete --resource-group <RESOURCE_GROUP> --name <APP_NAME> --setting-names http function:hello_world

1. På funktionsappsidan i Azure Portal expanderar du Inställningar på den vänstra menyn och väljer Skala och samtidighet.

2. Under , http, blob, eller ett specifikt funktionsnamn med formatet durable i function:<FUNCTION_NAME>=n och skriv Antalet alltid redo instanser.

3. Välj Spara för att uppdatera appen.

Du kan för närvarande inte ändra alltid redo instanser med hjälp av Visual Studio Code.

az functionapp scale config set Använd kommandot för att ange specifika HTTP-samtidighetsgränser för din app, oavsett instansstorlek.

az functionapp scale config set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --trigger-type http --trigger-settings perInstanceConcurrency=10

I det här exemplet anges http-utlösarens samtidighetsnivå till 10. När du har angett ett HTTP-samtidighetsvärde bibehålls det värdet trots ändringar i appens inställning för instansstorlek.

1. På funktionsappsidan i Azure Portal expanderar du Inställningar på den vänstra menyn och väljer Skala och samtidighet.

2. Under Samtidighet per instans väljer du Tilldela manuellt och skriver en specifik gräns.

3. Välj Spara för att uppdatera appen.

Du kan för närvarande inte ange HTTP-samtidighetsgränser med hjälp av Visual Studio Code.

Konfiguration av platsuppdateringsstrategi stöds för närvarande inte i Azure CLI. Använd Bicep- eller ARM-mallar enligt beskrivningen i Konfigurera webbplatsuppdateringsstrategi.

Konfiguration av platsuppdateringsstrategi stöds för närvarande inte i Azure-portalen. Använd Bicep- eller ARM-mallar enligt beskrivningen i Konfigurera webbplatsuppdateringsstrategi.

Konfiguration av platsuppdateringsstrategi stöds för närvarande inte i Visual Studio Code. Använd Bicep- eller ARM-mallar enligt beskrivningen i Konfigurera webbplatsuppdateringsstrategi.

Använd det här skriptet för att generera en rapport över aktuella mått för din app:

appId=$(az functionapp show --name <APP_NAME> --resource-group <RESOURCE_GROUP> --query id -o tsv)

appId=$(az functionapp show --name func-fuxigh6c255de --resource-group exampleRG --query id -o tsv)

echo -e "\nAlways-ready and on-emand execution counts..."
az monitor metrics list --resource $appId --metric "AlwaysReadyFunctionExecutionCount" --interval PT1H --output table
az monitor metrics list --resource $appId --metric "OnDemandFunctionExecutionCount" --interval PT1H --output table

echo -e "\nExecution units (MB-ms) in always-ready and on-emand execution counts..."
az monitor metrics list --resource $appId --metric "AlwaysReadyFunctionExecutionUnits" --interval PT1H --output table
az monitor metrics list --resource $appId --metric "OnDemandFunctionExecutionUnits" --interval PT1H --output table

echo -e "\nAlways-ready resource utilization..."
az monitor metrics list --resource $appId --metric "AlwaysReadyUnits" --interval PT1H --output table

echo -e "\nMemory utilization..."
az monitor metrics list --resource $appId --metric "AverageMemoryWorkingSet" --interval PT1H --output table
az monitor metrics list --resource $appId --metric "MemoryWorkingSet" --interval PT1H --output table

echo -e "\nInstance count and CPU utilization..."
az monitor metrics list --resource $appId --metric "InstanceCount" --interval PT1H --output table
az monitor metrics list --resource $appId --metric "CpuPercentage" --interval PT1H --output table

1. På funktionsappsidan i Azure-portalen väljer duÖvervakningsmått> och om det aktuella diagrammet är tomt väljer du + Lägg till mått.

2. Med appen som omfång väljer du ett eller flera av de måttalternativ som stöds för att lägga till det aktuella diagrammet.

3. Upprepa föregående steg för att lägga till andra mått i diagrammet.

4. (Valfritt) Välj Spara på instrumentpanelen för att lägga till det aktuella diagrammet i en ny eller befintlig instrumentpanel. Kom ihåg att inkludera både alltid tillgängliga och efterfrågade metrik för bred synlighet.

5. (Valfritt) Välj Ny varningsregel om du vill skapa en varning för ett visst mätvärde. Kom ihåg att inkludera både alltid tillgängliga och efterfrågade metrik för bred synlighet.

Du kan för närvarande inte granska och ange mått med hjälp av Visual Studio Code.