Как использовать команду docker config create для управления конфигурациями в Docker

Введение

В этой лабораторной работе вы научитесь эффективно управлять конфигурациями в Docker с помощью команды docker config create. Мы рассмотрим различные методы создания конфигураций, начиная с создания простой конфигурации напрямую из стандартного ввода.

Затем вы узнаете, как создать конфигурацию из существующего файла — практичный подход для управления более объёмными данными конфигурации. Мы также рассмотрим, как добавлять метки (labels) к вашим конфигурациям для лучшей организации и идентификации. Наконец, вы научитесь проверять детали созданных конфигураций, чтобы убедиться в их содержимом и свойствах.

Skills Graph

%%%%{init: {'theme':'neutral'}}%%%% flowchart RL docker(("Docker")) -.-> docker/ContainerOperationsGroup(["Container Operations"]) docker/ContainerOperationsGroup -.-> docker/ls("List Containers") docker/ContainerOperationsGroup -.-> docker/inspect("Inspect Container") docker/ContainerOperationsGroup -.-> docker/create("Create Container") subgraph Lab Skills docker/ls -.-> lab-555099{{"Как использовать команду docker config create для управления конфигурациями"}} docker/inspect -.-> lab-555099{{"Как использовать команду docker config create для управления конфигурациями"}} docker/create -.-> lab-555099{{"Как использовать команду docker config create для управления конфигурациями"}} end

Создание простой конфигурации из STDIN

На этом шаге вы узнаете, как создать Docker-конфигурацию из стандартного ввода (STDIN). Docker-конфигурации используются для хранения нечувствительных данных, таких как конфигурационные файлы, которые могут быть доступны сервисам Docker.

Сначала создадим простое содержимое конфигурации. Мы воспользуемся командой echo для вывода строки и передадим её в команду docker config create через конвейер (pipe).

echo "This is my simple config content." | docker config create my_simple_config -

В приведённой команде:

echo "This is my simple config content." выводит строку, которая станет содержимым нашей конфигурации.
| — это оператор конвейера, который передаёт вывод команды echo на вход следующей команде.
docker config create — команда для создания новой Docker-конфигурации.
my_simple_config — имя, которое мы даём нашей конфигурации.
- указывает docker config create читать содержимое конфигурации из STDIN.

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

Чтобы убедиться, что конфигурация успешно создана, вы можете вывести список существующих Docker-конфигураций с помощью команды docker config ls.

docker config ls

В выводе вы должны увидеть my_simple_config.

Создание конфигурации из файла

В предыдущем шаге вы научились создавать Docker-конфигурацию из стандартного ввода. В этом шаге вы узнаете, как создать Docker-конфигурацию из файла. Это распространённый способ управления большими или сложными конфигурационными данными.

Сначала создадим простой конфигурационный файл. Используем редактор nano для создания файла my_config_file.txt в вашей директории ~/project.

nano ~/project/my_config_file.txt

В редакторе nano введите следующее содержимое:

This is the content from my config file.
Another line of configuration.

Нажмите Ctrl + X, затем Y и Enter, чтобы сохранить файл и выйти из редактора.

Теперь, когда у нас есть конфигурационный файл, мы можем создать Docker-конфигурацию с помощью команды docker config create.

docker config create my_file_config ~/project/my_config_file.txt

В этой команде:

docker config create — команда для создания новой Docker-конфигурации
my_file_config — имя, которое мы даём этой конфигурации
~/project/my_config_file.txt — путь к файлу с содержимым конфигурации

Docker прочитает содержимое из ~/project/my_config_file.txt и создаст конфигурацию с именем my_file_config.

Чтобы убедиться в успешном создании конфигурации, снова выведем список Docker-конфигураций.

docker config ls

Теперь вы должны увидеть в списке как my_simple_config (из предыдущего шага), так и my_file_config.

Создание конфигурации с метками

В этом шаге вы узнаете, как добавлять метки (labels) к Docker-конфигурациям. Метки — это пары "ключ-значение", которые можно прикреплять к объектам Docker (включая конфигурации) для организации и идентификации. Это особенно полезно в крупных развертываниях.

Мы создадим ещё одну конфигурацию, на этот раз добавив метки в процессе создания. Используем то же содержимое из файла, созданного в предыдущем шаге, но передадим его через cat в docker config create с добавлением меток с помощью флага --label.

cat ~/project/my_config_file.txt | docker config create --label environment=development --label version=1.0 my_labeled_config -

Разберём эту команду:

cat ~/project/my_config_file.txt читает содержимое созданного ранее файла
| передаёт содержимое файла следующей команде
docker config create — команда создания новой Docker-конфигурации
--label environment=development добавляет метку с ключом environment и значением development
--label version=1.0 добавляет вторую метку с ключом version и значением 1.0. Можно добавлять несколько меток, используя флаг --label несколько раз
my_labeled_config — имя, которое мы даём этой конфигурации
- указывает, что содержимое конфигурации должно читаться из STDIN

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

Для просмотра меток, связанных с вашими конфигурациями, используйте команду docker config ls с флагом --format для отображения меток:

docker config ls --format "{{.Name}}\t{{.Labels}}"

Эта команда выведет список имён конфигураций и связанных с ними меток. Вы должны увидеть метки environment и version для конфигурации my_labeled_config.

Просмотр созданной конфигурации

В этом завершающем шаге вы узнаете, как просматривать детали Docker-конфигурации, включая её ID, имя, время создания и метки. Это полезно для проверки свойств конфигурации и понимания её настроек.

Мы используем команду docker config inspect для просмотра деталей конфигурации my_labeled_config, созданной на предыдущем шаге.

docker config inspect my_labeled_config

Эта команда выведет строку в формате JSON, содержащую подробную информацию о указанной конфигурации. Вы увидите такие поля как ID, Name, CreatedAt, UpdatedAt и Labels. В поле Labels будут отображены метки environment и version, которые мы добавили.

Также можно использовать флаг --pretty для получения более удобочитаемого вывода.

docker config inspect --pretty my_labeled_config

Это отобразит информацию в более структурированном формате, что упростит чтение.

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

Итоги

В этой лабораторной работе вы научились создавать Docker-конфигурации с помощью команды docker config create. Вы попрактиковались в создании простой конфигурации напрямую из стандартного ввода (stdin), что полезно для быстрого создания небольших конфигураций. Также вы узнали, как создавать конфигурацию из файла — более практичный подход для управления большими или сложными конфигурационными данными. Наконец, вы изучили, как добавлять метки к конфигурациям для лучшей организации и управления метаданными, а также как просматривать детали созданных конфигураций с помощью команды docker config inspect.