Как добавить переменную окружения в контейнер в Docker Desktop?

Вопрос или проблема

При первом использовании Docker Desktop на моем Mac я скачал MySQL из строки поиска (предположительно с Docker Hub) и нажал Run. Появилось диалоговое окно с просьбой ввести параметры конфигурации, такие как номер порта. Я нажал Run, чтобы запустить контейнер.

Я получил сообщение об ошибке, в котором говорилось:

Вы должны указать одну из следующих переменных среды:
- MYSQL_ROOT_PASSWORD
- MYSQL_ALLOW_EMPTY_PASSWORD
- MYSQL_RANDOM_ROOT_PASSWORD

К сожалению, будучи новичком в Docker в целом и в приложении Docker Desktop в частности, я не знаю, как установить переменную окружения после того, как уже создал этот контейнер в приложении Docker Desktop.

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

Как установить переменные окружения для существующего контейнера в Docker Desktop?

Docker Desktop (или Docker в данном случае) не предоставляет возможность добавить переменную среды после того, как ваш контейнер запущен, и любые добавления/изменения переменных среды через команду docker exec ограничены этой конкретной сессией.

Я рекомендую вам остановить и снова запустить новый контейнер, особенно потому что ошибка возникает при запуске MySQL.

Вы можете установить переменные среды, когда нажмете на раздел Images и нажмете “Run”

В Docker Desktop есть опция “copy docker run”, которая сгенерирует команду, использованную для запуска вашего контейнера:

Тогда будет легко добавить переменную среды, добавив --env=NewVariable=ItsValue. Просто не добавляйте это в конец сгенерированной команды, так как это запустит эту часть как команду внутри нового контейнера.

Чтобы добавить переменную среды в контейнер в Docker Desktop, используйте флаг -e в команде Docker run. Например,

docker run -e MY_VARIABLE=value your_image_name

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

Ответ или решение

Чтобы добавить переменную окружения в контейнер в Docker Desktop на вашем Mac, сначала стоит понимать, что Docker, в том числе его настольная версия, не поддерживают непосредственного добавления или изменения переменных окружения в уже запущенном контейнере. Переменные окружения нужно задавать при запуске контейнера, так как они часто влияют на начальные процессы, например, инициализацию базы данных, как в случае с MySQL.

Теория

Контейнеры Docker обычно воспроизводят поведение на основе образов, из которых они созданы. Изображения, такие как MySQL из Docker Hub, часто настраиваются через переменные окружения для управления такими аспектами, как учетные данные, порты и другие параметры. В случае с MySQL, отсутствие установки необходимых переменных окружения, таких как MYSQL_ROOT_PASSWORD, MYSQL_ALLOW_EMPTY_PASSWORD или MYSQL_RANDOM_ROOT_PASSWORD, приведет к ошибке запуска.

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

Пример

Допустим, вы хотите использовать MySQL в Docker и настроить его так, чтобы установить пароль для пользователя "root". Обычно, вы бы делали это при запуске контейнера с помощью командной строки или через GUI Docker Desktop, предоставляя переменную окружения MYSQL_ROOT_PASSWORD. Вероятно, во время первого запуска диалоговое окно Docker Desktop действительно предлагало вам ввести эту информацию.

Пример команды для создания и запуска контейнера MySQL с необходимыми переменными окружения выглядит следующим образом:

docker run --name mysql-container -e MYSQL_ROOT_PASSWORD=yourpassword -d mysql

Применение

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

В Docker Desktop процесс будет следующим:

Остановите текущий контейнер с MySQL, если он запущен. Это можно сделать через интерфейс Docker Desktop, выбрав контейнер и нажав кнопку "Stop".
Удалите текущий контейнер, чтобы освободить имя контейнера и прочие ресурсы. В Docker Desktop выберите ваш контейнер и нажмите кнопку "Remove" или используйте команду docker rm в терминале.
Перезапустите контейнер с новыми переменными окружения. В разделе "Images" Docker Desktop найдите ваш образ MySQL и нажмите "Run". Под "Settings" выберите "Optional Settings" и добавьте переменные окружения, такие как:
- MYSQL_ROOT_PASSWORD=yourpassword для задания пароля root,
- MYSQL_ALLOW_EMPTY_PASSWORD=yes если хотите разрешить пустой пароль (не рекомендуется с точки зрения безопасности),
- MYSQL_RANDOM_ROOT_PASSWORD=yes если хотите, чтобы MySQL сгенерировал случайный пароль для root.

Имплементация через командную строку при помощи Docker CLI хорошо подходит для скриптов и автоматизации:

docker run --name mysql-container -e MYSQL_ROOT_PASSWORD=yourpassword -d mysql

Для получения полной команды запуска из Docker Desktop можно использовать функцию "Copy Docker Run", которая позволяет вам скопировать команду с уже заданными параметрами контейнера, которые использовались в GUI. Это позволит вам легко добавить или изменить переменные окружения в команде перед повторным запуском.

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