Hantera miljövariabler i Azure Container Apps

I Azure Container Apps kan du ange miljövariabler för körning. Dessa variabler kan anges som manuellt poster eller som referenser till hemligheter. Dessa miljövariabler läses in på containerappen under körning.

Konfigurera miljövariabler

Du kan konfigurera miljövariablerna när containerappen skapas eller senare genom att skapa en ny revision.

Kommentar

För att undvika förvirring rekommenderas det inte att duplicera miljövariabler. När flera miljövariabler har samma namn börjar den sista i listan att gälla.

Azure-portalen

Om du skapar en ny containerapp via Azure Portal kan du konfigurera miljövariablerna i avsnittet Container:

Azure CLI

Du kan skapa containerappen med miljövariabler med kommandot az containerapp create genom att skicka miljövariablerna som blankstegsavgränsade "key=value"-poster med hjälp av parametern --env-vars .

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappEnv \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" \
    --env-vars GREETING="Hello, world" ANOTHERENV=anotherenv

Om du vill referera till en hemlighet måste du se till att den hemlighet som du vill referera till redan har skapats. Mer information finns i Hantera hemligheter. Du kan använda det hemliga namnet och skicka det till värdefältet men börja med secretref:

az containerapp update \
    -n <APP NAME> 
    -g <RESOURCE_GROUP_NAME> 
    --set-env-vars <VAR_NAME>=secretref:<SECRET_NAME>

PowerShell

Om du vill använda PowerShell måste du först skapa ett minnesinternt objekt med namnet EnvironmentVar med powershell-cmdleten New-AzContainerAppEnvironmentVarObject .

Om du vill använda den här cmdleten måste du skicka namnet på miljövariabeln med hjälp av parametern -Name respektive värdet med hjälp av parametern -Value .

$envVar = New-AzContainerAppEnvironmentVarObject -Name "envVarName" -Value "envVarvalue"

Om du vill referera till en hemlighet måste du se till att den hemlighet som du vill referera till redan har skapats. Mer information finns i Hantera hemligheter. Du kan använda det hemliga namnet och skicka det till parametern -SecretRef :

$envVar = New-AzContainerAppEnvironmentVarObject -Name "envVarName" -SecretRef "secretName"

Sedan måste du skapa ett annat minnesinternt objekt med namnet Container med hjälp av PowerShell-cmdleten New-AzContainerAppTemplateObject .

På den här cmdleten måste du skicka namnet på containeravbildningen (inte containerappen!) som du vill använda parametern -Name , det fullständigt kvalificerade avbildningsnamnet med hjälp av parametern -Image och referera till miljöobjektet som du definierade tidigare i variabeln $envVar.

$containerTemplate = New-AzContainerAppTemplateObject -Name "container-app-name" -Image "repo/imagename:tag" -Env $envVar

Kommentar

Observera att det finns andra inställningar som du kan behöva definiera i mallobjektet för att undvika att åsidosätta dem som resurser, volymmonteringar osv. Kontrollera den fullständiga dokumentationen om den här mallen på New-AzContainerAppTemplateObject.

Slutligen kan du uppdatera containerappen baserat på det nya mallobjektet som du skapade med hjälp av Cmdleten Update-AzContainerApp PowerShell.

I den här sista cmdleten behöver du bara skicka mallobjektet som du definierade i variabeln $containerTemplate i föregående steg med hjälp av parametern -TemplateContainer .

Update-AzContainerApp -TemplateContainer $containerTemplate

Lägga till miljövariabler i befintliga containerappar

När containerappen har skapats är det enda sättet att uppdatera miljövariablerna för Container App genom att skapa en ny revision med nödvändiga ändringar.

Azure-portalen

1. I Azure Portal söker du efter Container Apps och väljer sedan din app.

   

2. I appens vänstra meny väljer du Revisioner > och repliker Skapa ny revision

   

3. Sedan måste du redigera den aktuella befintliga containeravbildningen:

   

4. I avsnittet Miljövariabler kan du lägga till nya miljövariabler genom att klicka på Lägg till.

5. Ange sedan miljövariabelns namn och källan (det kan vara en referens till en hemlighet).

   

   1. Om du väljer Källan som manuell kan du ange miljövariabelvärdet manuellt.

      

Azure CLI

Du kan uppdatera containerappen med kommandot az containerapp update .

Det här exemplet skapar en miljövariabel med ett manuellt värde (refererar inte till en hemlighet). <Ersätt PLACEHOLDERS> med dina värden.

az containerapp update \
    -n <APP NAME> 
    -g <RESOURCE_GROUP_NAME> 
    --set-env-vars <VAR_NAME>=<VAR_VALUE>

Om du vill skapa flera miljövariabler kan du infoga blankstegsavgränsade värden i formatet "key=value".

Om du vill referera till en hemlighet måste du se till att den hemlighet som du vill referera till redan har skapats. Mer information finns i Hantera hemligheter. Du kan använda det hemliga namnet och skicka det till värdefältet, men börja med secretref:, se följande exempel:

az containerapp update \
    -n <APP NAME> 
    -g <RESOURCE_GROUP_NAME> 
    --set-env-vars <VAR_NAME>=secretref:<SECRET_NAME>

PowerShell

På samma sätt som du behöver göra när du skapar en ny containerapp måste du skapa ett objekt med namnet EnvironmentVar, som finns i en container. Den här containern används sedan med PowerShell-cmdleten New-AzContainerApp .

I den här cmdleten behöver du bara skicka mallobjektet som du definierade tidigare enligt beskrivningen i avsnittet Konfigurera miljövariabler .

Update-AzContainerApp -TemplateContainer $containerTemplate

Inbyggda miljövariabler

Azure Container Apps lägger automatiskt till miljövariabler som dina appar och jobb kan använda för att hämta plattformsmetadata vid körning.

Appar

Följande variabler är tillgängliga för containerappar:

Variabelnamn	beskrivning	Exempelvärde
CONTAINER_APP_NAME	Namnet på containerappen.	my-containerapp
CONTAINER_APP_REVISION	Namnet på containerappens revision.	my-containerapp--20mh1s9
CONTAINER_APP_HOSTNAME	Containerappens revisionsspecifika värdnamn.	my-containerapp--20mh1s9.<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_ENV_DNS_SUFFIX	DNS-suffixet för Container Apps-miljön. Om du vill hämta det fullständigt kvalificerade domännamnet (FQDN) för appen lägger du till appnamnet i DNS-suffixet i formatet $CONTAINER_APP_NAME.$CONTAINER_APP_ENV_DNS_SUFFIX.	<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_PORT	Målporten för containerappen.	8080
CONTAINER_APP_REPLICA_NAME	Namnet på containerappens replik.	my-containerapp--20mh1s9-86c8c4b497-zx9bq

Projekt

Följande variabler är tillgängliga för Container Apps-jobb:

Variabelnamn	beskrivning	Exempelvärde
CONTAINER_APP_JOB_NAME	Namnet på jobbet.	my-job
CONTAINER_APP_JOB_EXECUTION_NAME	Namnet på jobbkörningen.	my-job-iwpi4il

Nästa steg

• Revisionshantering