Переменные окружения
Переменные окружения позволяют настроить среду выполнения для вашего приложения, легко управлять его конфигурацией и быстро изменять её в случае необходимости.
- Имя переменной должно содержать латинские буквы, цифровые символы и «-», «_».
- Максимальная длина значения переменной не должна превышать 255 символов.
Количество переменных в проекте зависит от текущих лимитов проекта.
Создание переменной через веб-интерфейс
Для создания новой переменной перейдите в проекте в раздел «Окружение», затем в раздел «Переменные окружения» и нажмите на кнопку «Добавить». Затем укажите название переменной и её значение.
После ввода необходимых значений, нажмите на кнопку «Применить» и дождитесь завершения процесса создания переменной.
Значение переменных окружения можно переиспользовать в нескольких контейнерах. Для этого, после создания переменной окружения, перейдите в раздел «Контейнеры», откройте контейнер, который нужно отредактировать, нажмите на кнопку «Редактировать», после этого откроется модальное окно с настройками конфигурации контейнера.
В открывшемся модальном окне, в разделе «Переменные», укажите в значение переменной имя глобальной переменной с префиксом «$».
В примере выше для переменной контейнера с именем KEY значение будет браться из переменной окружения с именем TOKEN.
Создание переменной с помощью консольной утилиты
dockhost environment variable set --name <name> --value <value> [options]
Подробнее о команде создания переменной можно узнать в описании команды environment variable set
dockhost.yaml
Также, создать новую переменную можно в файле dockhost.yaml, в одном файле можно указать несколько переменных.
version: 1
project: my-project
environment:
variables:
MY_ENV: value
MY_OTHER_ENV: value
Также, в файле dockhost.yaml, в качестве значения переменной можно указать одну из встроенных функций:
- <password> - Генерирует пароль.
- <string> или <string:32> - Генерирует произвольную строку состоящую из чисел и букв. Можно указать длину строки (по умолчанию 10 символов).
version: 1
project: my-project
environment:
variables:
MY_PASSWORD: <password>
MY_TOKEN: <string:16>
Если в качестве значения указана одна из встроенных функций, то переменная создаётся только если она не существует в проекте.
Чтобы использовать переменную в описании контейнера, укажите в разделе variables имя переменной (имя может отличаться) и её значение в виде $ИМЯ_ПЕРЕМЕННОЙ
version: 1
project: my-project
environment:
variables:
PASSWORD: <password>
containers:
my-container:
image: mysql
variables:
MYSQL_ROOT_PASSWORD: $PASSWORD