Переменные окружения
100%

Docker Compose · Урок 5

Переменные окружения

Научитесь различать значение, подставленное в файл Compose, и значение, переданное в контейнер.

Переменная окружения — это значение с именем, которое может прочитать программа. Compose использует переменные двумя способами: подставляет значения при чтении файла и передаёт значения программам внутри контейнера.

Подставляем значение в файл

Сохраните пример в учебном каталоге под именем compose.env.yaml. Выражение ${PAGE_MODE:-demo} означает, что Compose возьмёт значение PAGE_MODE, если переменная задана и не пуста. В остальных случаях он подставит demo.

services:
  toolbox:
    image: busybox:1.36
    environment:
      PAGE_MODE: "${PAGE_MODE:-demo}"

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

Если PAGE_MODE не задана, какое значение появится в выводе конфигурации?

Смотрим, какое значение получилось

Если задать переменную перед командой, значение будет действовать только для этого запуска. Попробуйте указать другое значение и посмотреть, что изменится. Команда config показывает настройки с подставленными значениями и не создаёт контейнер.

$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml config

Найдите PAGE_MODE: review в окружении сервиса. Значение review используется для примера. Не помещайте секреты в примеры конфигурации или вывод команд.

В выводе конфигурации появилось review. Что уже произошло?

Передаём значение в контейнер

Раздел environment передаёт полученное значение в новый контейнер. С помощью printenv выведите значение из контейнера, созданного для одного запуска.

$ PAGE_MODE=review docker compose -p journey-env -f compose.env.yaml run --rm toolbox printenv PAGE_MODE

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

Как проверить, какое значение получила программа в контейнере с инструментами?

Урок завершён

Вы завершили Переменные окружения

Теперь вы различаете два способа использования переменных окружения.

  • Читайте выражения со значением по умолчанию в файле Compose.

  • Проверяйте конфигурацию после подстановки до запуска контейнера.

  • Проверяйте значение в окружении запущенной программы.

Сохраните прогресс

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

Создать бесплатный аккаунт
Следующий Урок
Назад к Docker Compose