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

Введение

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

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

Создание простой конфигурации из 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.