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í kontejnerové aplikace nebo později 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í parametru -Name, a hodnotu 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 vašeho image kontejneru (nejde o aplikaci kontejneru!) s použitím parametru -Name, plně kvalifikovaný název image pomocí parametru -Image a odkazovat na objekt prostředí, který jste dříve definovali v proměnné $envVar.

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

Poznámka:

Upozorňujeme, že možná budete muset v objektu šablony 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 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řidejte proměnné prostředí do existujících kontejnerových aplikací

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 manuální hodnotou (není odkazem na tajemství). Nahraďte <zástupné symboly> vašimi 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ů. Můžete použít název tajemství a předat ho do pole hodnoty, ale začněte s secretref:, viz následující příklad:

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 PowerShell rutinou New-AzContainerApp.

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 kontejnerové aplikace.	my-containerapp
CONTAINER_APP_REVISION	Název revize aplikace kontejneru.	my-containerapp--20mh1s9
CONTAINER_APP_HOSTNAME	Hostitelské jméno specifické pro revizi kontejnerové aplikace.	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 kontejnerové aplikace.	my-containerapp--20mh1s9-86c8c4b497-zx9bq
CONTAINER_NAME	Název repliky. K dispozici pro aplikace spravovaných funkcí a aplikace logiky.	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 provádění úlohy.	my-job-iwpi4il

Další kroky

• Správa revizí