Környezeti változók kezelése az Azure Container Appsben

Az Azure Container Appsben beállíthatja a futtatókörnyezet környezeti változóit. Ezek a változók beállíthatók manuálisan bejegyzésként vagy titkos kódokra mutató hivatkozásként. Ezek a környezeti változók futásidőben töltődnek be a tárolóalkalmazásba.

Környezeti változók konfigurálása

A környezeti változókat a tárolóalkalmazás létrehozásakor vagy később konfigurálhatja egy új változat létrehozásával.

Megjegyzés

A félreértések elkerülése érdekében nem ajánlott a környezeti változók duplikálása. Ha több környezeti változónak ugyanaz a neve, a lista utolsó változója lép érvénybe.

Azure Portal

Ha új tárolóalkalmazást hoz létre az Azure Portalon keresztül, beállíthatja a környezeti változókat a Tároló szakaszban:

Azure parancssori felület

A tárolóalkalmazást környezeti változókkal az az containerapp create paranccsal hozhatja létre úgy, hogy a környezeti változókat szóközzel elválasztott "key=value" bejegyzésként adja át a --env-vars paraméterrel.

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

Ha titkos kódra szeretne hivatkozni, győződjön meg arról, hogy a hivatkozni kívánt titkos kód már létrejött, lásd: Titkos kódok kezelése. Használhatja a titkos nevet, és átadhatja az értékmezőnek, de a következővel kezdődik: secretref:

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

PowerShell

Ha a PowerShellt szeretné használni, először létre kell hoznia egy EnvironmentVar nevű memóriabeli objektumot a New-AzContainerAppEnvironmentVarObject PowerShell-parancsmaggal.

A parancsmag használatához meg kell adnia a környezeti változó nevét a -Name paraméterrel, az értéket pedig a -Value paraméter használatával.

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

Ha titkos kódra szeretne hivatkozni, győződjön meg arról, hogy a hivatkozni kívánt titkos kód már létrejött, lásd: Titkos kódok kezelése. Használhatja a titkos nevet, és átadhatja a -SecretRef paraméternek:

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

Ezután létre kell hoznia egy tároló nevű memóriabeli objektumot a New-AzContainerAppTemplateObject PowerShell-parancsmaggal.

Ezen a parancsmagon meg kell adnia a konténerkép nevét (nem a konténeralkalmazást!), a teljes képnevet a -Name paraméter használatával, és hivatkoznia kell a korábban a -Image változóban definiált környezeti objektumra.

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

Megjegyzés

Vegye figyelembe, hogy a sablonobjektumon belül más beállításokat is meg kell határoznia, hogy ne kelljen felülírni őket, például erőforrásokat, kötetcsatlakozásokat stb. Tekintse meg a sablon teljes dokumentációját a New-AzContainerAppTemplateObject webhelyen.

Végül frissítheti a tárolóalkalmazást az Update-AzContainerApp PowerShell-parancsmaggal létrehozott új sablonobjektum alapján.

Az utolsó parancsmagban csak a $containerTemplate változón az előző lépés során meghatározott sablonobjektumot kell a -TemplateContainer paraméterrel átadnia.

Update-AzContainerApp -TemplateContainer $containerTemplate

Környezeti változók hozzáadása meglévő tárolóalkalmazásokhoz

A Tárolóalkalmazás létrehozása után a Tárolóalkalmazás környezeti változóinak frissítésének egyetlen módja egy új változat létrehozása a szükséges módosításokkal.

Azure Portal

1. Az Azure Portalon keresse meg a Container Apps alkalmazást, majd válassza ki az alkalmazást.

   

2. Az alkalmazás bal oldali menüjében válassza a Változatok és replikák > Új változat létrehozása lehetőséget

   

3. Ezután szerkesztenie kell az aktuális meglévő tárolórendszerképet:

   

4. A Környezeti változók szakaszban a Hozzáadás gombra kattintva új környezeti változókat vehet fel.

5. Ezután állítsa be a környezeti változó nevét és a forrást (ez lehet egy titkos kódra való hivatkozás).

   

   1. Ha a Forrást manuálisként választja ki, manuálisan is beírhatja a Környezeti változó értékét.

      

Azure parancssori felület

A Container App az az containerapp update paranccsal frissíthető.

Ez a példa egy manuális értékkel rendelkező környezeti változót hoz létre (nem titkos kódra hivatkozik). Cserélje le a <HELYŐRZŐket> az Ön értékeire.

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

Ha több környezeti változót szeretne létrehozni, a szóközzel elválasztott értékeket a "key=value" formátumban szúrhatja be.

Ha titkos kódra szeretne hivatkozni, győződjön meg arról, hogy a hivatkozni kívánt titkos kód már létrejött, lásd: Titkos kódok kezelése. Használhatja a titkos nevet, és átadhatja az értékmezőnek, de kezdve a következő példával secretref::

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

PowerShell

Hasonlóan ahhoz, amit egy új tárolóalkalmazás létrehozásakor el kell végeznie, létre kell hoznia egy EnvironmentVar nevű objektumot, amely egy tárolóban található. Ezt a tárolót ezután a New-AzContainerApp PowerShell-parancsmaggal használja a rendszer.

Ebben a parancsmagban csak a korábban definiált sablonobjektumot kell átadnia a Környezeti változók konfigurálása szakaszban leírtak szerint.

Update-AzContainerApp -TemplateContainer $containerTemplate

Beépített környezeti változók

Az Azure Container Apps automatikusan hozzáadja azokat a környezeti változókat, amelyeket az alkalmazások és a feladatok használhatnak a platform metaadatainak futásidejű lekéréséhez.

Alkalmazások

A tárolóalkalmazások számára a következő változók érhetők el:

Változó neve	Leírás	Példaérték
CONTAINER_APP_NAME	A tárolóalkalmazás neve.	my-containerapp
CONTAINER_APP_REVISION	A tárolóalkalmazás változatának neve.	my-containerapp--20mh1s9
CONTAINER_APP_HOSTNAME	A tárolóalkalmazás változatspecifikus gazdagépneve.	my-containerapp--20mh1s9.<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_ENV_DNS_SUFFIX	A Container Apps-környezet DNS-utótagja. Az alkalmazás teljes tartománynevének (FQDN) beszerzéséhez fűzze hozzá az alkalmazás nevét a DNS-utótaghoz a formátumban $CONTAINER_APP_NAME.$CONTAINER_APP_ENV_DNS_SUFFIX.	<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_PORT	A tárolóalkalmazás célportja.	8080
CONTAINER_APP_REPLICA_NAME	A konténeralkalmazás-replika neve.	my-containerapp--20mh1s9-86c8c4b497-zx9bq
CONTAINER_NAME	A replika neve. Felügyelt függvényalkalmazásokhoz és logikai alkalmazásokhoz érhető el.	my-containerapp--20mh1s9-86c8c4b497-zx9bq

Feladatok

A Container Apps-feladatokhoz a következő változók érhetők el:

Változó neve	Leírás	Példaérték
CONTAINER_APP_JOB_NAME	A feladat neve.	my-job
CONTAINER_APP_JOB_EXECUTION_NAME	A feladat végrehajtásának neve.	my-job-iwpi4il

Következő lépések

• Változatkezelés