Cómo usar el comando docker config ls para listar configuraciones

Introducción

En este laboratorio, aprenderás a utilizar eficazmente el comando docker config ls para gestionar tus configuraciones de Docker. Comenzarás listando todas las configuraciones disponibles, entendiendo cómo crearlas y visualizarlas.

Sobre esta base, explorarás técnicas avanzadas de filtrado utilizando la bandera --filter para localizar configuraciones específicas por nombre y etiqueta (label). Finalmente, aprenderás a formatear la salida del comando docker config ls para mostrar la información de la manera que mejor se adapte a tus necesidades.

Listar todas las configuraciones

En este paso, aprenderás a listar todas las configuraciones de Docker utilizando el comando docker config ls. Las configuraciones de Docker se utilizan para almacenar datos sensibles o archivos de configuración que pueden ser accedidos por los servicios.

Primero, creemos una configuración simple. Crearemos un archivo llamado my_config.txt en tu directorio principal con contenido de ejemplo.

echo "This is a sample configuration." > ~/my_config.txt

Ahora, creemos una configuración de Docker a partir de este archivo.

docker config create my_config ~/my_config.txt

Deberías ver como salida el ID de la configuración creada.

Ahora puedes listar todas las configuraciones de Docker disponibles usando el comando docker config ls.

docker config ls

Este comando mostrará una tabla con información sobre tus configuraciones, incluyendo el ID, Nombre y la marca de tiempo CreatedAt. Deberías ver la configuración my_config que acabas de crear en la lista.

Filtrar configuraciones por nombre

En este paso, aprenderás a filtrar configuraciones de Docker por nombre utilizando la bandera --filter con la clave name. Esto es útil cuando tienes muchas configuraciones y necesitas encontrar una específica.

En el paso anterior, creaste una configuración llamada my_config. Vamos a crear otra configuración para demostrar el filtrado.

Primero, crea un nuevo archivo llamado another_config.txt en tu directorio principal.

echo "This is another configuration." > ~/another_config.txt

Ahora, crea una configuración de Docker a partir de este archivo.

docker config create another_config ~/another_config.txt

Deberías ver el ID de la nueva configuración creada.

Ahora, listemos todas las configuraciones nuevamente para ver ambas.

docker config ls

Deberías ver tanto my_config como another_config en la salida.

Para filtrar las configuraciones y mostrar solo la llamada my_config, puedes usar la opción --filter name=my_config.

docker config ls --filter name=my_config

Este comando solo mostrará la configuración con el nombre my_config.

De manera similar, para filtrar y mostrar solo another_config, usarías:

docker config ls --filter name=another_config

Esto demuestra cómo usar el filtro name para encontrar configuraciones específicas.

Filtrar configuraciones por etiqueta

En este paso, aprenderás a filtrar configuraciones de Docker por etiquetas usando la bandera --filter con la clave label. Las etiquetas son pares clave-valor que puedes asignar a objetos Docker para organizarlos y categorizarlos.

Primero, creemos una nueva configuración y agreguemos una etiqueta. Crearemos un archivo llamado labeled_config.txt en tu directorio principal.

echo "This config has a label." > ~/labeled_config.txt

Ahora, crea una configuración de Docker a partir de este archivo y añade la etiqueta env=production usando la bandera --label.

docker config create --label env=production labeled_config ~/labeled_config.txt

Deberías ver el ID de la configuración creada.

Creemos otra configuración con una etiqueta diferente. Crea un archivo llamado another_labeled_config.txt.

echo "This config has a different label." > ~/another_labeled_config.txt

Ahora, crea una configuración Docker con la etiqueta env=development.

docker config create --label env=development another_labeled_config ~/another_labeled_config.txt

Ahora, lista todas las configuraciones para ver las recién creadas con sus etiquetas.

docker config ls

Deberías ver labeled_config y another_labeled_config en la lista.

Para filtrar configuraciones por etiqueta, usa el formato --filter label=<clave>=<valor>. Por ejemplo, para listar configuraciones con la etiqueta env=production:

docker config ls --filter label=env=production

Este comando solo mostrará labeled_config.

Para listar configuraciones con la etiqueta env=development:

docker config ls --filter label=env=development

Esto mostrará another_labeled_config.

También puedes filtrar solo por la clave de la etiqueta, sin importar el valor. Por ejemplo, para listar todas las configuraciones que tengan una etiqueta env:

docker config ls --filter label=env

Esto mostrará tanto labeled_config como another_labeled_config.

Formatear la salida de la lista de configuraciones

En este paso, aprenderás a formatear la salida del comando docker config ls usando la bandera --format. Esto te permite personalizar la salida para mostrar solo la información que necesitas o presentarla en un formato específico como JSON.

Por defecto, docker config ls muestra una tabla.

docker config ls

Puedes usar la bandera --format para especificar una plantilla Go y formatear la salida. Por ejemplo, para mostrar solo el ID y nombre de la configuración:

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

Este comando mostrará el ID y nombre de cada configuración, separados por un tabulador.

También puedes mostrar los datos en formato JSON, lo cual es útil para scripting o integración con otras herramientas.

docker config ls --format json

Esto mostrará un array JSON donde cada elemento representa una configuración.

Probemos otro formato para mostrar el nombre y fecha de creación.

docker config ls --format "Config Name: {{.Name}}, Created At: {{.CreatedAt}}"

Este comando mostrará una cadena personalizada para cada configuración, con su nombre y marca de tiempo de creación.

Puedes explorar otros campos disponibles para incluir en tu formato inspeccionando una configuración con docker config inspect <config_id>.

Por ejemplo, inspeccionemos my_config para ver sus detalles. Reemplaza <config_id> con el ID real de my_config obtenido de la salida de docker config ls.

docker config inspect my_config

La salida mostrará varios campos como ID, Name, CreatedAt, UpdatedAt, Spec y Version. Puedes usar estos nombres de campo en tu cadena de formato --format.

Experimenta con diferentes cadenas de formato para personalizar la salida según tus necesidades.

Resumen

En este laboratorio, aprendiste a usar el comando docker config ls para listar configuraciones de Docker. Comenzaste creando una configuración de ejemplo usando docker config create y luego utilizaste docker config ls para ver todas las configuraciones disponibles, observando el ID, Nombre y marca de tiempo CreatedAt.

Además, exploraste cómo filtrar las configuraciones listadas usando la bandera --filter. Aprendiste a filtrar por nombre usando --filter name=<config_name> para mostrar solo las configuraciones que coincidan con un nombre específico.