Управление переменными среды в приложениях контейнеров Azure

В приложениях контейнеров Azure вы можете задать переменные среды выполнения. Эти переменные можно задать как записи вручную или как ссылки на секреты. Эти переменные среды загружаются в приложение-контейнер во время выполнения.

Настройка переменных среды

Переменные среды можно настроить при создании приложения-контейнера или более поздней версии, создав новую редакцию.

Примечание.

Чтобы избежать путаницы, не рекомендуется дублировать переменные среды. Если несколько переменных среды имеют одно и то же имя, последний из них в списке вступает в силу.

Портал Azure

Если вы создаете приложение-контейнер с помощью портал Azure, вы можете настроить переменные среды в разделе "Контейнер".

Azure CLI

Вы можете создать приложение-контейнер с переменными среды с помощью команды az containerapp create , передав переменные среды в виде записей key=value с помощью --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

Если вы хотите ссылаться на секрет, необходимо убедиться, что секрет, на который вы хотите ссылаться, уже создан, см. в разделе "Управление секретами". Вы можете использовать имя секрета и передать его в поле значения, но начиная с secretref:

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

PowerShell

Если вы хотите использовать PowerShell, сначала создайте объект в памяти с именем EnvironmentVar с помощью командлета PowerShell New-AzContainerAppEnvironmentVarObject.

Чтобы использовать этот командлет, необходимо передать имя переменной среды, используя -Name параметр и значение, соответственно -Value .

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

Если вы хотите ссылаться на секрет, необходимо убедиться, что секрет, на который вы хотите ссылаться, уже создан, см. в разделе "Управление секретами". Вы можете использовать имя секрета и передать его параметру -SecretRef :

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

Затем необходимо создать другой объект в памяти с именем Container с помощью командлета New-AzContainerAppTemplateObject PowerShell.

В этом командлете необходимо передать имя образа контейнера (а не приложение контейнера!), которое требуется использовать параметр, полное имя образа с помощью -Name-Image параметра и ссылаться на объект среды, определенный ранее в переменной $envVar.

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

Примечание.

Обратите внимание, что существуют другие параметры, которые могут потребоваться определить внутри объекта шаблона, чтобы избежать переопределения таких ресурсов, как ресурсы, подключения томов и т. д. Ознакомьтесь с полной документацией по этому шаблону в New-AzContainerAppTemplateObject.

Наконец, вы можете обновить приложение контейнера на основе нового объекта шаблона, созданного с помощью командлета Update-AzContainerApp PowerShell.

В этом последнем командлете необходимо передать только объект шаблона, определенный в переменной $containerTemplate на предыдущем шаге с помощью -TemplateContainer параметра.

Update-AzContainerApp -TemplateContainer $containerTemplate

Добавление переменных среды в существующие приложения-контейнеры

После создания приложения-контейнера единственным способом обновления переменных среды приложения-контейнера является создание новой редакции с необходимыми изменениями.

Портал Azure

1. В портал Azure найдите контейнерные приложения и выберите свое приложение.

   

2. В меню слева приложения выберите "Редакции" и > "Создать новую редакцию"

   

3. Затем необходимо изменить текущий существующий образ контейнера:

   

4. В разделе переменных среды можно добавить новые переменные среды, нажав кнопку "Добавить".

5. Затем задайте имя переменной среды и источник (это может быть ссылка на секрет).

   

   1. Если выбрать источник в качестве вручную, можно вручную ввести значение переменной среды.

      

Azure CLI

Вы можете обновить приложение-контейнер с помощью команды az containerapp update .

В этом примере создается переменная среды с значением вручную (не ссылается на секрет). Замените <заполнители вашими значениями> .

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

Если вы хотите создать несколько переменных среды, можно вставить разделенные пробелами значения в формате "key=value".

Если вы хотите ссылаться на секрет, необходимо убедиться, что секрет, на который вы хотите ссылаться, уже создан, см. в разделе "Управление секретами". Вы можете использовать имя секрета и передать его в поле значения, но начиная с secretref:, см. следующий пример:

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

PowerShell

Аналогично тому, что необходимо сделать при создании приложения-контейнера, необходимо создать объект с именем EnvironmentVar, который содержится в контейнере. Затем этот контейнер используется с командлетом New-AzContainerApp PowerShell.

В этом командлете необходимо передать только объект шаблона, определенный ранее, как описано в разделе "Настройка переменных среды".

Update-AzContainerApp -TemplateContainer $containerTemplate

Встроенные переменные среды

Приложения контейнеров Azure автоматически добавляют переменные среды, которые приложения и задания могут использовать для получения метаданных платформы во время выполнения.

Приложения

Следующие переменные доступны для приложений-контейнеров:

Имя переменной	Description	Пример значения
CONTAINER_APP_NAME	Имя приложения контейнера.	my-containerapp
CONTAINER_APP_REVISION	Имя редакции приложения контейнера.	my-containerapp--20mh1s9
CONTAINER_APP_HOSTNAME	Имя узла, зависящее от редакции, для приложения контейнера.	my-containerapp--20mh1s9.<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_ENV_DNS_SUFFIX	Суффикс DNS для среды "Приложения контейнеров". Чтобы получить полное доменное имя (FQDN) приложения, добавьте имя приложения в DNS-суффикс в формате $CONTAINER_APP_NAME.$CONTAINER_APP_ENV_DNS_SUFFIX.	<DEFAULT_HOSTNAME>.<REGION>.azurecontainerapps.io
CONTAINER_APP_PORT	Целевой порт приложения-контейнера.	8080
CONTAINER_APP_REPLICA_NAME	Имя реплики приложения-контейнера.	my-containerapp--20mh1s9-86c8c4b497-zx9bq

Работы

Следующие переменные доступны для заданий приложений контейнеров:

Имя переменной	Description	Пример значения
CONTAINER_APP_JOB_NAME	Имя задания.	my-job
CONTAINER_APP_JOB_EXECUTION_NAME	Имя выполнения задания.	my-job-iwpi4il

Следующие шаги

• Управление редакциями