Как посмотреть переменные окружения запущенного Docker Container

Просмотр переменных окружения запущенного контейнера Docker

Для просмотра переменных окружения в запущенном Docker-контейнере существует несколько эффективных способов, каждый из которых полезен в разных сценариях. Переменные окружения (environment variables) — это критически важный компонент конфигурации контейнеризированных приложений, определяющий их поведение, параметры подключения к внешним сервисам (базы данных, API) и другие настройки.

Основные методы

1. Использование команды docker exec

Самый прямой способ — выполнить команду внутри запущенного контейнера с помощью docker exec.

• Для Linux-образов (Alpine, Ubuntu и др.): Используйте команду env или printenv.

  docker exec <container_id_or_name> env
  

    *Пример с именем контейнера:*

```bash
docker exec my_app_container env
```

    Для вывода конкретной переменной:

```bash
docker exec my_app_container printenv DB_HOST
```

• Для Windows-образов: Используйте set.

  docker exec <container_name> set
  

2. Использование команды docker inspect

Эта команда выводит подробную низкоуровневую информацию о контейнере в формате JSON. Из этого вывода можно извлечь переменные окружения.

• Просмотр всех переменных в необработанном JSON:

  docker inspect <container_id_or_name>
  

    Переменные будут находиться в разделе `Config.Env`.

• Извлечение только массива переменных с помощью jq (рекомендуется):

  docker inspect <container_id> | jq '.[0].Config.Env'
  

    Это выведет чистый список вида `["PATH=/usr/bin", "MY_VAR=value"]`.

• Извлечение с помощью встроенного форматирования Go (--format):

  docker inspect --format='{{range .Config.Env}}{{println .}}{{end}}' <container_id>
  

3. Специальная команда Docker docker container run

Если контейнер запущен с флагом -it (интерактивный режим с TTY), можно получить интерактивную оболочку и исследовать окружение оттуда.

docker exec -it my_app_container /bin/sh   # Для Alpine Linux
docker exec -it my_app_container /bin/bash # Для большинства других Linux-образов

После входа в оболочку используйте знакомые команды: env, printenv, echo $VAR_NAME.

Сравнение методов

• docker exec env — самый быстрый и простой способ для получения полного списка в читаемом виде.
• docker inspect — наиболее мощный метод, используется для автоматизации в скриптах (с jq) или когда контейнер не реагирует на команды (exec).
• Интерактивная оболочка (exec -it) — удобна для комплексной отладки, когда нужно не только увидеть переменные, но и проверить их влияние, состояние файловой системы и логи.

Пример рабочего процесса

Допустим, у нас есть контейнер web-api, и нам нужно проверить настройки подключения к БД.

1. Быстрая проверка:

   docker exec web-api printenv | grep DB
   

    Результат может быть:

```
DB_HOST=postgres.prod.svc
DB_PORT=5432
DB_USER=app_user
```

2. Если контейнер "завис" или не принимает команды exec, используем inspect: bash docker inspect web-api | jq -r '.[0].Config.Env[] | select(startswith("DB"))'

1. Для детального расследования заходим в оболочку:

   docker exec -it web-api /bin/bash
   root@container-id:/app# echo $DB_HOST
   root@container-id:/app# env | sort
   

Важное замечание о безопасности

Переменные окружения часто содержат конфиденциальные данные: пароли, токены, ключи API. Используйте printenv или inspect только в доверенном окружении. Для управления секретами в производственных средах предпочтительнее использовать Docker Secrets (в Swarm) или специальные решения для работы с секретами, такие как HashiCorp Vault, или облачные KMS (Key Management Service), которые не сохраняют секреты в переменных окружения в чистом виде.

Таким образом, выбор метода зависит от ситуации: для быстрой проверки используйте docker exec env, для автоматизации в CI/CD-пайплайнах — связку docker inspect с jq, а для глубокой отладки проблем — интерактивную оболочку.