Azure Container Apps'te ortam değişkenlerini yönetme

Azure Container Apps'te çalışma zamanı ortam değişkenlerini ayarlayabilirsiniz. Bu değişkenler manuel girişler veya gizli bilgiler referansları olarak ayarlanabilir. Bu ortam değişkenleri çalışma zamanı sırasında Kapsayıcı Uygulamanıza yüklenir.

Ortam değişkenlerini yapılandırma

Ortam Değişkenlerini Kapsayıcı Uygulaması'nın oluşturulmasından sonra veya daha sonra yeni bir düzeltme oluşturarak yapılandırabilirsiniz.

Not

Karışıklığı önlemek için ortam değişkenlerini yinelemek önerilmez. Birden fazla ortam değişkeni aynı isme sahip olduğunda, listedeki sonuncusu geçerli olur.

Azure portalı

Azure portalı aracılığıyla yeni bir Kapsayıcı Uygulaması oluşturuyorsanız, Kapsayıcı bölümünde ortam değişkenlerini ayarlayabilirsiniz:

Azure CLI

az containerapp create komutunu kullanarak, --env-vars parametresi ile 'key=value' şeklinde boşlukla ayrılmış ortam değişkenlerini geçirerek Kapsayıcı Uygulamanızı oluşturabilirsiniz.

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

Bir gizliye başvurmak istiyorsanız, başvurmak istediğiniz gizlinin zaten oluşturulduğundan emin olmanız gerekir, bkz Gizli bilgileri yönetme. Gizli adı kullanıp değer alanı ile secretref: başlamalı olarak geçirebilirsiniz.

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

PowerShell

PowerShell kullanmak istiyorsanız, önce New-AzContainerAppEnvironmentVarObject PowerShell cmdlet'ini kullanarak EnvironmentVar adlı bir bellek içi nesne oluşturun.

Bu cmdlet'i kullanmak için, ortam değişkeninin adını -Name parametresini, değerini ise -Value parametresini kullanarak sırasıyla geçirmeniz gerekir.

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

Bir gizliye başvurmak istiyorsanız, başvurmak istediğiniz gizlinin zaten oluşturulduğundan emin olmanız gerekir, bkz Gizli bilgileri yönetme. Gizli adı kullanabilir ve onu -SecretRef parametresine geçirerek kullanabilirsiniz.

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

Ardından New-AzContainerAppTemplateObject PowerShell cmdlet'ini kullanarak Container adlı başka bir bellek içi nesne oluşturmanız gerekir.

Bu cmdlet'te, -Name parametresini kullanarak istediğiniz kapsayıcı görüntüsünün adını (kapsayıcı uygulamasını değil!), -Image parametresini kullanarak tam görüntü adını geçirmeniz ve $envVar değişkeninde daha önce tanımladığınız ortam nesnesine referans vermeniz gerekir.

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

Not

Bunları kaynaklar, birim bağlamaları vb. geçersiz kılmamak için şablon nesnesinin içinde tanımlamanız gerekebilecek başka ayarlar olduğunu lütfen unutmayın. Lütfen New-AzContainerAppTemplateObject üzerindeki bu şablonla ilgili tüm belgeleri gözden geçirin.

Son olarak, Update-AzContainerApp PowerShell cmdlet'ini kullanarak oluşturduğunuz yeni şablon nesnesine göre Kapsayıcı Uygulamanızı güncelleştirebilirsiniz.

Bu son cmdlet'te, önceki adımda $containerTemplate değişkeninde tanımladığınız şablon nesnesini, -TemplateContainer parametresini kullanarak geçirmeniz yeterlidir.

Update-AzContainerApp -TemplateContainer $containerTemplate

Mevcut kapsayıcı uygulamalarına ortam değişkenleri ekleme

Kapsayıcı Uygulaması oluşturulduktan sonra Kapsayıcı Uygulaması ortam değişkenlerini güncelleştirmenin tek yolu, gerekli değişikliklerle yeni bir düzeltme oluşturmaktır.

Azure portalı

1. Azure portalında Container Apps'i arayın ve uygulamanızı seçin.

   

2. Uygulamanın sol menüsünde Düzeltmeler ve çoğaltmalar > Yeni düzeltme oluştur'u seçin

   

3. Ardından mevcut kapsayıcı görüntüsünü düzenlemeniz gerekir:

   

4. Ortam değişkenleri bölümünde Ekle'ye tıklayarak Yeni Ortam değişkenleri ekleyebilirsiniz.

5. Ardından, Ortam değişkeninizin adını ve Kaynağını ayarlayın (bu, bir sır için referans olabilir).

   

   1. Kaynak'ı el ile seçerseniz Ortam değişkeni değerini el ile girebilirsiniz.

      

Azure CLI

Kapsayıcı Uygulamanızı az containerapp update komutuyla güncelleştirebilirsiniz .

Bu örnek, elle belirtilmiş bir değer içeren bir ortam değişkeni oluşturur (gizli bir değere atıfta bulunmaz). PLACEHOLDERS< değerini >değerlerinizle değiştirin.

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

Birden çok ortam değişkeni oluşturmak istiyorsanız, 'key=value' biçiminde boşlukla ayrılmış değerler ekleyebilirsiniz.

Bir gizliye başvurmak istiyorsanız, başvurmak istediğiniz gizlinin zaten oluşturulduğundan emin olmanız gerekir, bkz Gizli bilgileri yönetme. Gizli adı kullanabilir ve değer alanına geçirebilirsiniz, ancak secretref: ile başlayarak aşağıdaki örneğe bakın:

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

PowerShell

Yeni bir Kapsayıcı Uygulaması oluştururken yapmanız gerekenlere benzer şekilde, kapsayıcı içinde yer alan EnvironmentVar adlı bir nesne oluşturmanız gerekir. Bu Kapsayıcı daha sonra New-AzContainerApp PowerShell cmdlet'iyle kullanılır.

Bu cmdlet'te, ortam değişkenlerini yapılandırma bölümünde açıklandığı gibi daha önce tanımladığınız şablon nesnesini geçirmeniz yeterlidir .

Update-AzContainerApp -TemplateContainer $containerTemplate

Yerleşik ortam değişkenleri

Azure Container Apps, uygulamalarınızın ve işlerinizin çalışma zamanında platform meta verilerini almak için kullanabileceği ortam değişkenlerini otomatik olarak ekler.

Uygulamalar

Kapsayıcı uygulamaları için aşağıdaki değişkenler kullanılabilir:

Değişken adı	Açıklama	Örnek değer
CONTAINER_APP_NAME	Kapsayıcı uygulamasının adı.	my-containerapp
CONTAINER_APP_REVISION	Kapsayıcı uygulama sürümünün adı.	my-containerapp--20mh1s9
CONTAINER_APP_HOSTNAME	Kapsayıcı uygulamanın revizyona özgü ana bilgisayar adı.	my-containerapp--20mh1s9.<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_ENV_DNS_SUFFIX	Container Apps ortamı için DNS son eki. Uygulamanın tam etki alanı adını (FQDN) almak için, uygulama adını $CONTAINER_APP_NAME.$CONTAINER_APP_ENV_DNS_SUFFIX biçiminde DNS son ekine ekleyin.	<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_PORT	Kapsayıcı uygulamasının hedef bağlantı noktası.	8080
CONTAINER_APP_REPLICA_NAME	Kapsayıcı uygulaması çoğaltmasının adı.	my-containerapp--20mh1s9-86c8c4b497-zx9bq
CONTAINER_NAME	Replikanın adı. Yönetilen işlev uygulamaları ve mantıksal uygulamalar için kullanılabilir.	my-containerapp--20mh1s9-86c8c4b497-zx9bq

İşler

Container Apps işleri için aşağıdaki değişkenler kullanılabilir:

Değişken adı	Açıklama	Örnek değer
CONTAINER_APP_JOB_NAME	İşin adı.	my-job
CONTAINER_APP_JOB_EXECUTION_NAME	İş yürütmenin adı.	my-job-iwpi4il

Sonraki adımlar

• Düzeltme yönetimi