Správa proměnných prostředí v Azure Container Apps

V Azure Container Apps můžete nastavit proměnné prostředí runtime. Tyto proměnné lze nastavit jako ručně zadané položky nebo odkazy na tajné kódy. Tyto proměnné prostředí se načítají do kontejnerové aplikace během běhu.

Konfigurace proměnných prostředí

Proměnné prostředí můžete nakonfigurovat při vytváření aplikace kontejneru nebo novější vytvořením nové revize.

Poznámka:

Aby nedocházelo k nejasnostem, nedoporučuje se duplikovat proměnné prostředí. Pokud má více proměnných prostředí stejný název, projeví se poslední proměnná v seznamu.

Azure Portal

Pokud vytváříte novou aplikaci kontejneru prostřednictvím webu Azure Portal, můžete nastavit proměnné prostředí v části Kontejner:

Azure CLI

Aplikaci kontejneru můžete vytvořit s proměnnými prostředí pomocí příkazu az containerapp create tak, že proměnné prostředí předáte jako položky key=value oddělené mezerami pomocí parametru --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

Pokud chcete odkazovat na tajný klíč, musíte zajistit, že tajný klíč, na který chcete odkazovat, už je vytvořený, viz Správa tajných kódů. Název tajného kódu můžete použít a předat ho do pole hodnoty, ale začíná na secretref:

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

PowerShell

Pokud chcete použít PowerShell, musíte nejprve vytvořit objekt v paměti s názvem EnvironmentVar pomocí rutiny PowerShellu New-AzContainerAppEnvironmentVarObject .

Pokud chcete tuto rutinu použít, musíte předat název proměnné prostředí pomocí -Name parametru a hodnoty pomocí parametru -Value .

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

Pokud chcete odkazovat na tajný klíč, musíte zajistit, že tajný klíč, na který chcete odkazovat, už je vytvořený, viz Správa tajných kódů. Název tajného kódu můžete použít a předat ho parametru -SecretRef :

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

Pak musíte vytvořit další objekt v paměti s názvem Kontejner pomocí rutiny PowerShellu New-AzContainerAppTemplateObject .

V této rutině musíte předat název image kontejneru (nikoli aplikace kontejneru!), který chcete použít parametr -Name , plně kvalifikovaný název image pomocí parametru -Image a odkazovat na objekt prostředí, který jste definovali dříve v proměnné $envVar.

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

Poznámka:

Upozorňujeme, že v objektu šablony možná budete muset definovat další nastavení, abyste se vyhnuli jejich přepsání, jako jsou prostředky, připojení svazků atd. Projděte si úplnou dokumentaci k této šabloně na webu New-AzContainerAppTemplateObject.

Nakonec můžete aplikaci Container App aktualizovat na základě nového objektu šablony, který jste vytvořili pomocí rutiny Update-AzContainerApp PowerShellu.

V této poslední rutině stačí předat objekt šablony, který jste definovali v $containerTemplate proměnné v předchozím kroku pomocí parametru -TemplateContainer .

Update-AzContainerApp -TemplateContainer $containerTemplate

Přidání proměnných prostředí v existujících kontejnerových aplikacích

Po vytvoření kontejnerové aplikace je jediným způsobem, jak aktualizovat proměnné prostředí Container App, vytvořením nové revize s potřebnými změnami.

Azure Portal

1. Na webu Azure Portal vyhledejte kontejnerové aplikace a pak vyberte svou aplikaci.

   

2. V nabídce vlevo aplikace vyberte Revize a repliky > Vytvořit novou revizi.

   

3. Pak musíte upravit aktuální existující image kontejneru:

   

4. V části Proměnné prostředí můžete přidat nové proměnné prostředí kliknutím na přidat.

5. Potom nastavte název proměnné prostředí a zdroj (může to být odkaz na tajný kód).

   

   1. Pokud vyberete zdroj jako ruční, můžete hodnotu proměnné prostředí zadat ručně.

      

Azure CLI

Aplikaci kontejneru můžete aktualizovat pomocí příkazu az containerapp update .

Tento příklad vytvoří proměnnou prostředí s ruční hodnotou (ne odkazující na tajný klíč). <Zástupné symboly> nahraďte hodnotami.

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

Pokud chcete vytvořit více proměnných prostředí, můžete hodnoty oddělené mezerami vložit ve formátu key=value.

Pokud chcete odkazovat na tajný klíč, musíte zajistit, že tajný klíč, na který chcete odkazovat, už je vytvořený, viz Správa tajných kódů. Název tajného kódu můžete použít a předat ho do pole hodnoty, ale začněte na secretref:následujícím příkladu:

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

PowerShell

Podobně jako při vytváření nové kontejnerové aplikace musíte vytvořit objekt s názvem EnvironmentVar, který je součástí kontejneru. Tento kontejner se pak použije s rutinou New-AzContainerApp PowerShell.

V této rutině stačí předat objekt šablony, který jste definovali dříve, jak je popsáno v části Konfigurace proměnných prostředí.

Update-AzContainerApp -TemplateContainer $containerTemplate

Předdefinované proměnné prostředí

Azure Container Apps automaticky přidává proměnné prostředí, které můžou vaše aplikace a úlohy použít k získání metadat platformy za běhu.

Aplikace

Pro kontejnerové aplikace jsou k dispozici následující proměnné:

Název proměnné	Popis	Příklad hodnoty
CONTAINER_APP_NAME	Název aplikace kontejneru.	my-containerapp
CONTAINER_APP_REVISION	Název revize aplikace kontejneru.	my-containerapp--20mh1s9
CONTAINER_APP_HOSTNAME	Název hostitele specifického pro revizi aplikace kontejneru.	my-containerapp--20mh1s9.<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_ENV_DNS_SUFFIX	Přípona DNS pro prostředí Container Apps. Pokud chcete získat plně kvalifikovaný název domény (FQDN) aplikace, připojte název aplikace k příponě DNS ve formátu $CONTAINER_APP_NAME.$CONTAINER_APP_ENV_DNS_SUFFIX.	<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_PORT	Cílový port aplikace kontejneru.	8080
CONTAINER_APP_REPLICA_NAME	Název repliky aplikace kontejneru.	my-containerapp--20mh1s9-86c8c4b497-zx9bq

Úlohy

Pro úlohy Container Apps jsou k dispozici následující proměnné:

Název proměnné	Popis	Příklad hodnoty
CONTAINER_APP_JOB_NAME	Název úlohy.	my-job
CONTAINER_APP_JOB_EXECUTION_NAME	Název spuštění úlohy.	my-job-iwpi4il

Další kroky

• Správa revizí