Cómo usar el comando docker config create para gestionar configuraciones en Docker

Introducción

En este laboratorio, aprenderás a gestionar configuraciones en Docker de manera efectiva utilizando el comando docker config create. Exploraremos diferentes métodos para crear configuraciones, comenzando con la creación de una configuración simple directamente desde la entrada estándar (standard input).

A continuación, aprenderás cómo crear una configuración a partir de un archivo existente, un enfoque práctico para gestionar datos de configuración más extensos. También cubriremos cómo añadir etiquetas (labels) a tus configuraciones para una mejor organización e identificación. Finalmente, aprenderás a inspeccionar los detalles de las configuraciones que has creado para verificar su contenido y propiedades.

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{{"Cómo usar el comando docker config create para gestionar configuraciones"}} docker/inspect -.-> lab-555099{{"Cómo usar el comando docker config create para gestionar configuraciones"}} docker/create -.-> lab-555099{{"Cómo usar el comando docker config create para gestionar configuraciones"}} end

Crear una configuración simple desde STDIN

En este paso, aprenderás cómo crear una configuración de Docker desde la entrada estándar (STDIN). Las configuraciones de Docker se utilizan para almacenar datos no sensibles, como archivos de configuración, que pueden ser accedidos por los servicios de Docker.

Primero, crearemos un contenido de configuración simple. Usaremos el comando echo para imprimir una cadena de texto y redirigirla al comando docker config create.

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

En el comando anterior:

echo "This is my simple config content." imprime la cadena que será el contenido de nuestra configuración.
| es el operador de tubería (pipe), que envía la salida del comando echo como entrada al siguiente comando.
docker config create es el comando para crear una nueva configuración en Docker.
my_simple_config es el nombre que le asignamos a nuestra configuración.
- indica a docker config create que lea el contenido de la configuración desde STDIN.

Después de ejecutar este comando, Docker creará una configuración llamada my_simple_config con el contenido especificado.

Para verificar que la configuración se creó correctamente, puedes listar las configuraciones existentes de Docker usando el comando docker config ls.

docker config ls

Deberías ver my_simple_config listada en la salida.

Crear una configuración desde un archivo

En el paso anterior, aprendiste cómo crear una configuración de Docker desde la entrada estándar. En este paso, aprenderás cómo crear una configuración de Docker desde un archivo. Esta es una forma común de gestionar datos de configuración más grandes o complejos.

Primero, creemos un archivo de configuración simple. Usaremos el editor nano para crear un archivo llamado my_config_file.txt en tu directorio ~/project.

nano ~/project/my_config_file.txt

Dentro del editor nano, ingresa el siguiente contenido:

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

Presiona Ctrl + X, luego Y, y Enter para guardar el archivo y salir del editor.

Ahora que tenemos nuestro archivo de configuración, podemos crear una configuración de Docker a partir de él usando el comando docker config create.

docker config create my_file_config ~/project/my_config_file.txt

En este comando:

docker config create es el comando para crear una nueva configuración de Docker
my_file_config es el nombre que le asignamos a esta configuración
~/project/my_config_file.txt es la ruta al archivo que contiene el contenido de configuración

Docker leerá el contenido de ~/project/my_config_file.txt y creará una configuración llamada my_file_config.

Para confirmar que la configuración se creó correctamente, puedes listar nuevamente las configuraciones de Docker.

docker config ls

Ahora deberías ver tanto my_simple_config (del paso anterior) como my_file_config en la lista.

Crear una configuración con etiquetas (labels)

En este paso, aprenderás cómo añadir etiquetas (labels) a tus configuraciones de Docker. Las etiquetas son pares clave-valor que puedes adjuntar a objetos de Docker, incluyendo configuraciones, para ayudar a organizarlas e identificarlas. Esto es particularmente útil en despliegues de mayor escala.

Crearemos otra configuración, esta vez añadiendo etiquetas durante el proceso de creación. Usaremos el mismo contenido del archivo que creamos en el paso anterior, pero lo redirigiremos desde cat a docker config create y añadiremos etiquetas usando la bandera --label.

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

Analicemos este comando:

cat ~/project/my_config_file.txt lee el contenido del archivo que creamos anteriormente.
| redirige el contenido del archivo al siguiente comando.
docker config create es el comando para crear una nueva configuración de Docker.
--label environment=development añade una etiqueta con la clave environment y el valor development.
--label version=1.0 añade otra etiqueta con la clave version y el valor 1.0. Puedes añadir múltiples etiquetas usando la bandera --label varias veces.
my_labeled_config es el nombre que le asignamos a esta configuración.
- indica que el contenido de la configuración debe leerse desde STDIN.

Después de ejecutar este comando, se creará una nueva configuración llamada my_labeled_config con el contenido y etiquetas especificados.

Para ver las etiquetas asociadas a tus configuraciones, puedes usar el comando docker config ls con la bandera --format para mostrar las etiquetas.

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

Este comando listará los nombres de las configuraciones y sus etiquetas asociadas. Deberías ver las etiquetas environment y version para my_labeled_config.

Inspeccionar la configuración creada

En este paso final, aprenderás cómo inspeccionar una configuración de Docker para ver sus detalles, incluyendo su ID, nombre, fecha de creación y etiquetas. Esto es útil para verificar las propiedades de la configuración y comprender su configuración.

Usaremos el comando docker config inspect para ver los detalles de my_labeled_config que creamos en el paso anterior.

docker config inspect my_labeled_config

Este comando mostrará una cadena en formato JSON con información detallada sobre la configuración especificada. Verás campos como ID, Name, CreatedAt, UpdatedAt y Labels. El campo Labels mostrará las etiquetas environment y version que añadimos.

También puedes usar la bandera --pretty para obtener una salida más legible.

docker config inspect --pretty my_labeled_config

Esto mostrará la información en un formato más organizado, facilitando su lectura.

Inspeccionar configuraciones es un paso crucial en la gestión de tus configuraciones de Docker, permitiéndote confirmar sus ajustes antes de usarlas en tus servicios.

Resumen

En este laboratorio, aprendiste a crear configuraciones de Docker utilizando el comando docker config create. Practicaste la creación de una configuración simple directamente desde la entrada estándar (STDIN), lo cual es útil para configuraciones rápidas y pequeñas. También aprendiste a crear una configuración desde un archivo, un enfoque más práctico para gestionar datos de configuración más grandes o complejos. Finalmente, exploraste cómo añadir etiquetas (labels) a tus configuraciones para una mejor organización y gestión de metadatos, y cómo inspeccionar los detalles de tus configuraciones creadas usando el comando docker config inspect.