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

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

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

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

Примечание.

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

Портал Azure

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

Azure CLI

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

В этом командлете необходимо передать название вашего Docker-образа контейнера (не самого приложения контейнера!) с использованием параметра -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, который содержится в контейнере. Затем этот контейнер используется с командлетом PowerShell New-AzContainerApp.

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

Update-AzContainerApp -TemplateContainer $containerTemplate

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

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

Приложения

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

Имя переменной	Описание	Пример значения
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
CONTAINER_NAME	Имя реплики. Доступно для приложений управляемой функции и приложений логики.	my-containerapp--20mh1s9-86c8c4b497-zx9bq

Работы

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

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

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

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