Cómo usar el comando docker config inspect para ver detalles de configuración

Introducción

En este laboratorio, aprenderás a utilizar el comando docker config inspect para ver información detallada sobre configuraciones (configs) de Docker. Comenzaremos creando una configuración de Docker a partir de un archivo, un paso fundamental para gestionar datos de configuración no sensibles dentro de un enjambre (swarm) de Docker.

Después de la creación, explorarás cómo inspeccionar la configuración creada utilizando tanto su nombre como su ID único, demostrando diferentes métodos para acceder a los detalles de configuración. Finalmente, aprenderás a formatear la salida del comando docker config inspect usando la bandera --format para personalizar la información mostrada.

Skills Graph

Crear una configuración (config) de Docker

En este paso, aprenderás cómo crear una configuración (config) de Docker. Las configuraciones de Docker se utilizan para almacenar información no sensible, como archivos de configuración, que pueden ser accedidos por servicios en un enjambre (swarm).

Primero, creemos un archivo de configuración simple. Crearemos un archivo llamado my_config.txt en el directorio ~/project con contenido de ejemplo.

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

Ahora, podemos crear una configuración de Docker a partir de este archivo usando el comando docker config create. La sintaxis básica es docker config create <nombre_config> <ruta_archivo>.

docker config create my_config ~/project/my_config.txt

Deberías ver el ID de la nueva configuración impreso en la consola. Esto indica que la configuración se ha creado exitosamente.

Para verificar que la configuración fue creada, puedes listar todas las configuraciones de Docker usando el comando docker config ls.

docker config ls

Deberías ver my_config en la salida, junto con su ID y fecha de creación.

Inspeccionar una configuración (config) por nombre

En este paso, aprenderás cómo inspeccionar una configuración de Docker utilizando su nombre. El comando docker config inspect te permite ver información detallada sobre una configuración específica.

Para inspeccionar la configuración que creamos en el paso anterior, my_config, usa el comando docker config inspect seguido del nombre de la configuración.

docker config inspect my_config

Este comando mostrará un objeto JSON que contiene varios detalles sobre la configuración my_config, como su ID, fecha de creación y el contenido de los datos de configuración.

La salida proporciona una vista completa de las propiedades de la configuración. Podrás ver los campos ID, CreatedAt, UpdatedAt, Spec y Version. El campo Spec contiene los datos reales de configuración, los cuales están codificados en base64.

Inspeccionar una configuración (config) por ID

En este paso, aprenderás cómo inspeccionar una configuración de Docker utilizando su ID. Aunque inspeccionar por nombre es conveniente, también es posible usar el ID y puede ser útil en ciertos escenarios.

Primero, obtengamos el ID de my_config que creamos anteriormente. Puedes obtener el ID de la salida del comando docker config ls.

docker config ls

Busca la columna ID en la salida para la entrada my_config. Copia este ID.

Ahora, usa el comando docker config inspect seguido del ID de configuración que acabas de copiar. Reemplaza <config_id> con el ID real.

docker config inspect <config_id>

Por ejemplo, si el ID fuera abc123def456, el comando sería:

docker config inspect abc123def456

Este comando generará la misma salida JSON detallada que al inspeccionar por nombre, proporcionando información sobre las propiedades de la configuración.

Inspeccionar por ID es particularmente útil cuando tienes múltiples configuraciones con nombres similares o cuando trabajas con scripts que dependen de IDs de configuración.

Formatear la salida usando --format

En este paso, aprenderás cómo formatear la salida del comando docker config inspect usando la bandera --format. Esto es útil cuando deseas extraer información específica de la salida JSON en un formato más legible.

La bandera --format utiliza el paquete text/template de Go. Puedes especificar los campos que deseas mostrar y cómo deben formatearse.

Intentemos mostrar solo el ID y la fecha de creación de my_config. Podemos usar la siguiente cadena de formato: {{.ID}} {{.CreatedAt}}.

docker config inspect --format '{{.ID}} {{.CreatedAt}}' my_config

Este comando mostrará el ID y la fecha de creación de my_config, separados por un espacio.

También puedes acceder a campos anidados dentro de la salida JSON. Por ejemplo, para acceder al nombre de la configuración, que está bajo Spec.Name, usarías {{.Spec.Name}}.

Mostremos el nombre y los datos codificados en base64 de la configuración.

docker config inspect --format 'Name: {{.Spec.Name}}, Data: {{.Spec.Data}}' my_config

Este comando mostrará el nombre y los datos codificados en base64 de la configuración en un formato más estructurado.

La bandera --format es una herramienta poderosa para personalizar la salida de los comandos de Docker y extraer la información que necesitas.

Resumen

En este laboratorio, aprendiste cómo crear una configuración (config) de Docker desde un archivo usando el comando docker config create y verificar su creación con docker config ls. Luego exploraste cómo inspeccionar una configuración de Docker para ver su información detallada usando el comando docker config inspect, demostrando cómo inspeccionar una configuración por su nombre.