Skapa en funktionsapp i en anpassad container i Azure Container Apps

I den här artikeln skapar du en Azure Functions-app som körs i en Linux-container och distribuerar den till en Azure Container Apps-miljö från ett containerregister. Genom att distribuera till Container Apps kan du integrera dina funktionsappar i molnbaserade mikrotjänster. För mer information, se Azure Container Apps-värdtjänster för Azure Functions.

Att slutföra den här snabbstarten medför en liten kostnad i ditt Azure-konto, vilket du kan minimera genom att rensa resurser när du är klar.

Välj programmeringsspråk

Först använder du Azure Functions-verktyg för att skapa din projektkod som en funktionsapp i en Docker-container med hjälp av en språkspecifik Linux-basavbildning. Se till att välja valfritt språk överst i artikeln.

Core Tools genererar automatiskt en Dockerfile för projektet som använder den senaste versionen av rätt basavbildning för funktionsspråket. Du bör regelbundet uppdatera din container från den senaste versionen av basavbildningen och distribuera den uppdaterade versionen av containern på nytt. Mer information finns i Skapa containerbaserade funktionsappar.

Förutsättningar

Innan du börjar måste du ha följande krav på plats:

• Installera Azure CLI version 2.4 eller senare.

Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

Om du vill publicera den containerbaserade funktionsappavbildningen som du skapar i ett containerregister behöver du ett Docker-ID och Docker Desktop som körs på den lokala datorn. Om du inte har något Docker-ID kan du skapa ett Docker-konto.

python -m venv .venv

source .venv/bin/activate

sudo apt-get install python3-venv

py -m venv .venv

.venv\scripts\activate

py -m venv .venv

.venv\scripts\activate

Skapa och testa projektet med lokala funktioner

func init --worker-runtime dotnet-isolated --docker

func init --worker-runtime node --language javascript --docker

func init --worker-runtime powershell --docker

func init --worker-runtime python --docker

func init --worker-runtime node --language typescript --docker

mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DjavaVersion=8 -Ddocker

mvn archetype:generate "-DarchetypeGroupId=com.microsoft.azure" "-DarchetypeArtifactId=azure-functions-archetype" "-DjavaVersion=8" "-Ddocker"

mvn archetype:generate "-DarchetypeGroupId=com.microsoft.azure" "-DarchetypeArtifactId=azure-functions-archetype" "-DjavaVersion=8" "-Ddocker"

Alternativet --docker genererar en Dockerfile för projektet, som definierar en lämplig container för användning med Azure Functions och den valda körningen.

cd fabrikam-functions

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

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

Om du vill testa funktionen lokalt startar du den lokala Azure Functions-runtimevärd i roten i projektmappen. Kontrollera att auktoriseringsnivån är inställd AuthorizationLevel.Anonymouspå eller ange den om den inte redan har konfigurerats för att säkerställa att funktionen kan anropas senare när den finns i Docker.

func start  

func start  

npm install
npm start

mvn clean package  
mvn azure-functions:run

Tryck på Ctrl+C (Kommando+C på macOS) för att stoppa värden.

Skapa containeravbildningen och verifiera lokalt

(Valfritt) Granska Dockerfile i roten för projektmappen. Dockerfile beskriver den miljö som krävs för att köra funktionsappen i Linux. Den fullständiga listan över basavbildningar som stöds för Azure Functions finns på basavbildningssidan för Azure Functions.

Kör kommandot docker build i rotprojektmappen, ange ett namn som azurefunctionsimageoch tagga som v1.0.0. Ersätt <DOCKER-ID> med ditt konto-ID för Docker Hub. Det här kommandot skapar Docker-avbildningen för containern.

docker build --tag <DOCKER-ID>/azurefunctionsimage:v1.0.0 .

När kommandot har slutförts kan du köra den nya containern lokalt.

Kontrollera bygget genom att köra avbildningen i en lokal container med kommandot docker run , ersätta <DOCKER-ID> igen med ditt Docker Hub-konto-ID och lägga till portargumentet som -p 8080:80:

docker run -p 8080:80 -it <DOCKER-ID>/azurefunctionsimage:v1.0.0

När du har verifierat funktionsappen i containern trycker du på Ctrl+C (Kommando+C på macOS) för att stoppa körningen.

Publicera containeravbildningen till ett register

Om du vill göra containeravbildningen tillgänglig för distribution till en värdmiljö måste du skicka den till ett containerregister. Som bästa säkerhet bör du använda en Azure Container Registry-instans och framtvinga hanterade identitetsbaserade anslutningar. Docker Hub kräver att du autentiserar med delade hemligheter, vilket gör dina distributioner mer sårbara.

Skapa stödjande Azure-resurser för din funktion

Innan du kan distribuera din container till Azure måste du skapa tre resurser:

• En resursgrupp, som är en logisk container för relaterade resurser.

• Ett Azure Storage-konto som används för att underhålla tillstånd och annan information om dina funktioner.

• En Azure Container Apps-miljö med en Log Analytics-arbetsyta.

• En användartilldelad hanterad identitet som gör att funktionsappen kan ansluta till Azure-resurser på ett säkert sätt utan att använda delade hemligheter. Anslutningar till både Azure Storage-kontot och Till Azure Container Registry-instansen görs i stället med hjälp av Microsoft Entra-autentisering med identiteten, vilket rekommenderas för det här scenariot.

  Anmärkning

  Docker Hub stöder inte hanterade identiteter.

Använd dessa kommandon för att skapa nödvändiga Azure-resurser:

1. Om det behövs loggar du in på Azure:

   Kommandot az login loggar in dig på ditt Azure-konto. Använd az account set när du har fler än en prenumeration associerad med ditt konto.

2. Kör följande kommando för att uppdatera Azure CLI till den senaste versionen:

   az upgrade
   

   Om din version av Azure CLI inte är den senaste versionen påbörjas en installation. Hur uppgraderingen fungerar beror på operativsystemet. Du kan fortsätta när uppgraderingen är klar.

3. Kör följande kommandon som uppgraderar Azure Container Apps-tillägget och registrerar namnområden som krävs av Container Apps:

   az extension add --name containerapp --upgrade -y
   az provider register --namespace Microsoft.Web 
   az provider register --namespace Microsoft.App 
   az provider register --namespace Microsoft.OperationalInsights 
   

4. Skapa en resursgrupp med namnet AzureFunctionsContainers-rg.

   az group create --name AzureFunctionsContainers-rg --location eastus
   

   Det här az group create kommandot skapar en resursgrupp i regionen USA, östra. Om du i stället vill använda en region nära dig använder du en tillgänglig regionkod som returneras från az account list-locations kommandot. Du måste ändra efterföljande kommandon för att använda din anpassade region i stället för eastus.

5. Skapa en Azure Container Apps-miljö.

   az containerapp env create --name MyContainerappEnvironment --resource-group AzureFunctionsContainers-rg --location eastus
   

   Det kan ta några minuter att köra kommandot.

6. Skapa ett allmänt lagringskonto i din resursgrupp och region, utan åtkomst till delad nyckel. I kommandot ersätter du <STORAGE-NAME> med ett namn som är lämpligt för dig och unikt i Azure Storage. Lagringsnamn måste innehålla 3 till 24 tecken och får endast bestå av siffror och små bokstäver.

   az storage account create --name <STORAGE-NAME> --location eastus --resource-group AzureFunctionsContainers-rg --sku Standard_LRS --allow-blob-public-access false --allow-shared-key-access false
   

   Kommandot az storage account create skapar ett lagringskonto som endast är tillgängligt med hjälp av Microsoft Entra-autentiserade identiteter som beviljas behörighet till specifika resurser.

   Standard_LRS anger ett allmänt konto som stöds av Functions.

7. Skapa en hanterad identitet och använd den returnerade principalId för att ge den både åtkomst till ditt lagringskonto och pull-behörigheter i registerinstansen. Ersätt <REGISTRY-NAME>, <USER-IDENTITY-NAME>och <STORAGE-NAME> med namnet på ditt befintliga containerregister, namnet på din hanterade identitet respektive lagringskontonamnet.

   principalId=$(az identity create --name <USER-IDENTITY-NAME> --resource-group AzureFunctionsContainers-rg --location eastus --query principalId -o tsv) 
   acrId=$(az acr show --name <REGISTRY-NAME> --query id --output tsv)
   az role assignment create --assignee-object-id $principalId --assignee-principal-type ServicePrincipal --role acrpull --scope $acrId
   storageId=$(az storage account show --resource-group AzureFunctionsContainers-rg --name <STORAGE-NAME> --query 'id' -o tsv)
   az role assignment create --assignee-object-id $principalId --assignee-principal-type ServicePrincipal --role "Storage Blob Data Owner" --scope $storageId
   

   Kommandot az identity create skapar en användartilldelad hanterad identitet och az role assignment createkommandona lägger till din identitet i de roller som krävs.

   Den hanterade identiteten är nu tillgänglig för appen för åtkomst till både lagringskontot och Azure Container Registry utan att använda delade hemligheter.

Skapa och konfigurera en funktionsapp i Azure med avbildningen

En funktionsapp i Azure hanterar körningen av dina funktioner i din Azure Container Apps-miljö. I det här avsnittet använder du Azure-resurserna från föregående avsnitt för att skapa en funktionsapp från en avbildning i ett containerregister i en Container Apps-miljö. Du konfigurerar också den nya miljön med en anslutningssträng till det Azure Storage-konto som krävs.

az containerapp create --kind=functionapp Använd kommandot för att skapa en funktionsapp i den nya hanterade miljön som backas upp av Azure Container Apps. Inom az containerapp create --kind-functionapp specificerar parametern --environment Container Apps-miljön.

UAMI_RESOURCE_ID=$(az identity show --name $uami_name --resource-group $group --query id -o tsv)

az containerapp create --name <APP-NAME> --storage-account <STORAGE-NAME> --environment MyContainerappEnvironment --workload-profile-name "Consumption" --resource-group AzureFunctionsContainers-rg --functions-version 4 --assign-identity $UAMI_RESOURCE_ID

UAMI_RESOURCE_ID=$(az identity show --name <USER-IDENTITY-NAME> --resource-group AzureFunctionsContainers-rg --query id -o tsv)
az resource patch --resource-group AzureFunctionsContainers-rg --name <APP-NAME> --resource-type "Microsoft.Web/sites" --properties "{ \"siteConfig\": { \"linuxFxVersion\": \"DOCKER|<REGISTRY-NAME>.azurecr.io/azurefunctionsimage:v1.0.0\", \"acrUseManagedIdentityCreds\": true, \"acrUserManagedIdentityID\":\"$UAMI_RESOURCE_ID\", \"appSettings\": [{\"name\": \"DOCKER_REGISTRY_SERVER_URL\", \"value\": \"<REGISTRY-NAME>.azurecr.io\"}]}}"

az containerapp create --name <APP-NAME> --storage-account <STORAGE-NAME> --environment MyContainerappEnvironment --workload-profile-name "Consumption" --resource-group AzureFunctionsContainers-rg --functions-version 4 --assign-identity --image <DOCKER-ID>/azurefunctionsimage:v1.0.0 --kind=functionapp

När du anger --workload-profile-name "Consumption" skapas din app i en miljö med standardprofilen Consumption för arbetsbelastningen, vilket kostar samma sak som att köra i en förbrukningsplan för containerappar. När du först skapar funktionsappen hämtas den första avbildningen från registret.

Uppdatera programinställningar

Om du vill att Functions-värden ska kunna ansluta till standardlagringskontot med delade nycklar måste du ersätta inställningen för anslutningssträng AzureWebJobsStorage med en motsvarande inställning som använder den hanterade identiteten som tilldelats användaren för att ansluta till lagringskontot.

1. Ta bort den befintliga AzureWebJobsStorage inställningen för anslutningssträng:

   az containerapp config appsettings delete --name <APP-NAME> --resource-group AzureFunctionsContainers-rg --setting-names AzureWebJobsStorage 
   

   Kommandot az containerapp config appsettings delete tar bort den här inställningen från din app. Ersätt <APP-NAME> med namnet på funktionsappen.

2. Lägg till motsvarande inställningar med ett AzureWebJobsStorage__ prefix som definierar en användartilldelad hanterad identitetsanslutning till standardlagringskontot:

   clientId=$(az identity show --name <USER-IDENTITY-NAME> --resource-group AzureFunctionsContainers-rg --query 'clientId' -o tsv)
   az containerapp config appsettings set --name <APP-NAME> --resource-group AzureFunctionsContainers-rg --settings AzureWebJobsStorage__accountName=<STORAGE-NAME> AzureWebJobsStorage__credential=managedidentity AzureWebJobsStorage__clientId=$clientId
   

   I det här exemplet ersätter du <APP-NAME>, <USER-IDENTITY-NAME>, <STORAGE-NAME> med funktionsappens namn, namnet på din identitet respektive lagringskontonamnet.

I det här läget körs dina funktioner i en Container Apps-miljö, och de nödvändiga programinställningarna har redan lagts till. När det behövs kan du lägga till andra inställningar i funktionsappen på standardsättet för Functions. Mer information finns i Arbeta med programinställningar.

Verifiera dina funktioner i Azure

När avbildningen har distribuerats till funktionsappen i Azure kan du nu anropa funktionen via HTTP-begäranden. Få detaljerad information om en specifik funktion:

    az containerapp function show \
    --resource-group AzureFunctionsContainers-rg \
    --name <APP-NAME> \
    --function-name HttpExample 

Ersätt <APP-NAME> med namnet på funktionsappen. Använd url:en som du nyss hämtade för att anropa funktionsslutpunkten HttpExample och lägga till frågesträngen ?name=Functions.

Begärande-URL:en bör se ut ungefär så här:

Rensa resurser

Om du vill fortsätta arbeta med Azure Function med hjälp av de resurser som du skapade i den här artikeln kan du lämna alla dessa resurser på plats.

När du är klar med distributionen av funktionsappen AzureFunctionsContainers-rg tar du bort resursgruppen för att rensa alla resurser i gruppen:

az group delete --name AzureFunctionsContainers-rg

Nästa steg