Omgevingsvariabelen beheren in Azure Container Apps

In Azure Container Apps kunt u omgevingsvariabelen voor runtime instellen. Deze variabelen kunnen worden ingesteld als handmatige vermeldingen of als verwijzingen naar geheimen. Deze omgevingsvariabelen worden tijdens runtime in uw container-app geladen.

Omgevingsvariabelen configureren

U kunt de omgevingsvariabelen configureren bij het maken van de container-app of later door een nieuwe revisie te maken.

Notitie

Om verwarring te voorkomen, wordt het afgeraden om omgevingsvariabelen te dupliceren. Wanneer meerdere omgevingsvariabelen dezelfde naam hebben, wordt de laatste in de lijst van kracht.

Azure-portal

Als u een nieuwe container-app maakt via Azure Portal, kunt u de omgevingsvariabelen instellen in de sectie Container:

Azure-CLI

U kunt uw container-app maken met omgevingsvariabelen met behulp van de opdracht az containerapp create door de omgevingsvariabelen door te geven als door spaties gescheiden 'key=value'-vermeldingen met behulp van de --env-vars parameter.

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

Als u naar een geheim wilt verwijzen, moet u ervoor zorgen dat het geheim waarnaar u wilt verwijzen al is gemaakt. Zie Geheimen beheren. U kunt de geheime naam gebruiken en doorgeven aan het waardeveld, maar beginnen met secretref:

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

Powershell

Als u PowerShell wilt gebruiken, maakt u eerst een in-memory object met de naam EnvironmentVar met behulp van de Cmdlet New-AzContainerAppEnvironmentVarObject PowerShell.

Als u deze cmdlet wilt gebruiken, moet u de naam van de omgevingsvariabele doorgeven met behulp van de -Name parameter en de waarde die respectievelijk de -Value parameter gebruikt.

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

Als u naar een geheim wilt verwijzen, moet u ervoor zorgen dat het geheim waarnaar u wilt verwijzen al is gemaakt. Zie Geheimen beheren. U kunt de geheime naam gebruiken en doorgeven aan de -SecretRef parameter:

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

Vervolgens moet u een ander in-memory object maken met de naam Container met behulp van de PowerShell-cmdlet New-AzContainerAppTemplateObject .

In deze cmdlet moet u de naam van uw containerinstallatiekopieën doorgeven (niet de container-app!) die u wilt gebruiken met behulp van de parameter, de -Name volledig gekwalificeerde installatiekopieënnaam met behulp van de -Image parameter en verwijzen naar het omgevingsobject dat u eerder hebt gedefinieerd op de variabele $envVar.

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

Notitie

Houd er rekening mee dat er andere instellingen zijn die u mogelijk in het sjabloonobject moet definiëren om te voorkomen dat ze worden overschreven, zoals resources, volumekoppelingen, enzovoort. Raadpleeg de volledige documentatie over deze sjabloon in New-AzContainerAppTemplateObject.

Ten slotte kunt u uw container-app bijwerken op basis van het nieuwe sjabloonobject dat u hebt gemaakt met behulp van de PowerShell-cmdlet Update-AzContainerApp .

In deze laatste cmdlet hoeft u alleen het sjabloonobject door te geven dat u hebt gedefinieerd voor de $containerTemplate variabele in de vorige stap met behulp van de -TemplateContainer parameter.

Update-AzContainerApp -TemplateContainer $containerTemplate

Omgevingsvariabelen toevoegen aan bestaande container-apps

Nadat de container-app is gemaakt, is de enige manier om de omgevingsvariabelen voor container-apps bij te werken door een nieuwe revisie te maken met de benodigde wijzigingen.

Azure-portal

1. Zoek in Azure Portal naar Container Apps en selecteer vervolgens uw app.

   

2. Selecteer revisies en replica's > maken in het linkermenu van de app

   

3. Vervolgens moet u de huidige bestaande containerinstallatiekopieën bewerken:

   

4. In de sectie Omgevingsvariabelen kunt u nieuwe omgevingsvariabelen toevoegen door op Toevoegen te klikken.

5. Stel vervolgens de naam van uw omgevingsvariabele en de bron in (dit kan een verwijzing naar een geheim zijn).

   

   1. Als u de bron als handmatig selecteert, kunt u de waarde van de omgevingsvariabele handmatig invoeren.

      

Azure-CLI

U kunt uw container-app bijwerken met de opdracht az containerapp update .

In dit voorbeeld wordt een omgevingsvariabele gemaakt met een handmatige waarde (geen verwijzing naar een geheim). Vervang de <TIJDELIJKE AANDUIDINGEN> door uw waarden.

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

Als u meerdere omgevingsvariabelen wilt maken, kunt u door spaties gescheiden waarden invoegen in de indeling 'key=value'.

Als u naar een geheim wilt verwijzen, moet u ervoor zorgen dat het geheim waarnaar u wilt verwijzen al is gemaakt. Zie Geheimen beheren. U kunt de geheime naam gebruiken en doorgeven aan het waardeveld, maar beginnen met secretref:, zie het volgende voorbeeld:

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

Powershell

Net als bij het maken van een nieuwe container-app moet u een object maken met de naam EnvironmentVar, dat zich in een container bevindt. Deze container wordt vervolgens gebruikt met de PowerShell-cmdlet New-AzContainerApp .

In deze cmdlet hoeft u alleen het sjabloonobject door te geven dat u eerder hebt gedefinieerd, zoals beschreven in de sectie Omgevingsvariabelen configureren.

Update-AzContainerApp -TemplateContainer $containerTemplate

Ingebouwde omgevingsvariabelen

Azure Container Apps voegt automatisch omgevingsvariabelen toe die uw apps en taken kunnen gebruiken om platformmetagegevens tijdens runtime te verkrijgen.

Apps

De volgende variabelen zijn beschikbaar voor container-apps:

Variabelenaam	Beschrijving	Voorbeeldwaarde
CONTAINER_APP_NAME	De naam van de container-app.	my-containerapp
CONTAINER_APP_REVISION	De naam van de revisie van de container-app.	my-containerapp--20mh1s9
CONTAINER_APP_HOSTNAME	De revisiespecifieke hostnaam van de container-app.	my-containerapp--20mh1s9.<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_ENV_DNS_SUFFIX	Het DNS-achtervoegsel voor de Container Apps-omgeving. Als u de FQDN (Fully Qualified Domain Name) van de app wilt ophalen, voegt u de naam van de app toe aan het DNS-achtervoegsel in de indeling $CONTAINER_APP_NAME.$CONTAINER_APP_ENV_DNS_SUFFIX.	<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_PORT	De doelpoort van de container-app.	8080
CONTAINER_APP_REPLICA_NAME	De naam van de replica van de container-app.	my-containerapp--20mh1s9-86c8c4b497-zx9bq

Projecten

De volgende variabelen zijn beschikbaar voor Container Apps-taken:

Variabelenaam	Beschrijving	Voorbeeldwaarde
CONTAINER_APP_JOB_NAME	De naam van de taak.	my-job
CONTAINER_APP_JOB_EXECUTION_NAME	De naam van de taakuitvoering.	my-job-iwpi4il

Volgende stappen

• Revisiebeheer