docker config ls
| Descripción | Lista las configuraciones (configs) |
|---|---|
| Uso | docker config ls [OPTIONS] |
| Alias | docker config list |
Swarm Este comando funciona con el orquestador de Swarm.
Descripción
Ejecuta este comando en un nodo administrador (manager) para listar las configuraciones en el Swarm.
Para obtener información detallada sobre el uso de configuraciones, consulta store configuration data using Docker Configs.
NoteEste es un comando de administración de clústeres y debe ejecutarse en un nodo administrador (manager) de Swarm. Para obtener más información sobre administradores y trabajadores (workers), consulta la sección de modo Swarm en la documentación.
Opciones
| Opción | Predeterminado | Descripción |
|---|---|---|
-f, --filter | Filtra la salida en función de las condiciones proporcionadas | |
--format | Formatea la salida utilizando una plantilla personalizada: 'table': Imprime la salida en formato de tabla con encabezados de columna (predeterminado) 'table PLANTILLA': Imprime la salida en formato de tabla utilizando la plantilla de Go especificada 'json': Imprime en formato JSON 'PLANTILLA': Imprime la salida utilizando la plantilla de Go especificada. Consulta https://docs-docker.esdocu.com/go/formatting/ para obtener más información sobre cómo formatear la salida con plantillas | |
-q, --quiet | Muestra únicamente los IDs |
Ejemplos
$ docker config ls
ID NAME CREATED UPDATED
6697bflskwj1998km1gnnjr38 q5s5570vtvnimefos1fyeo2u2 6 weeks ago 6 weeks ago
9u9hk4br2ej0wgngkga6rp4hq my_config 5 weeks ago 5 weeks ago
mem02h8n73mybpgqjf0kfi1n0 test_config 3 seconds ago 3 seconds ago
Filtrado (-f, --filter)
El formato de la flag de filtrado (-f o --filter) es un par clave=valor. Si hay más de un filtro, pasa múltiples flags (ej., --filter "foo=bar" --filter "bif=baz")
Los filtros admitidos actualmente son:
- id (ID de la configuración)
- label (
label=<clave>olabel=<clave>=<valor>) - name (nombre de la configuración)
id
El filtro id coincide con todo el ID de una configuración o con su prefijo.
$ docker config ls -f "id=6697bflskwj1998km1gnnjr38"
ID NAME CREATED UPDATED
6697bflskwj1998km1gnnjr38 q5s5570vtvnimefos1fyeo2u2 6 weeks ago 6 weeks ago
label
El filtro label coincide con las configuraciones según la presencia de una etiqueta sola o de una etiqueta y un valor.
El siguiente filtro coincide con todas las configuraciones que tengan una etiqueta project independientemente de su valor:
$ docker config ls --filter label=project
ID NAME CREATED UPDATED
mem02h8n73mybpgqjf0kfi1n0 test_config About an hour ago About an hour ago
El siguiente filtro coincide únicamente con los servicios que tengan la etiqueta project con el valor project-a.
$ docker config ls --filter label=project=project-a
ID NAME CREATED UPDATED
mem02h8n73mybpgqjf0kfi1n0 test_config About an hour ago About an hour ago
name
El filtro name coincide con todo el nombre de una configuración o con su prefijo.
El siguiente filtro coincide con la configuración que tenga un nombre que comience con el prefijo test.
$ docker config ls --filter name=test
ID NAME CREATED UPDATED
mem02h8n73mybpgqjf0kfi1n0 test_config About an hour ago About an hour ago
Formatear la salida (--format)
La opción de formato (--format) realiza una impresión limpia de la salida de las configuraciones utilizando una plantilla de Go.
A continuación se enumeran los marcadores de posición (placeholders) válidos para la plantilla de Go:
| Marcador de posición | Descripción |
|---|---|
.ID | ID de la configuración |
.Name | Nombre de la configuración |
.CreatedAt | Hora en que se creó la configuración |
.UpdatedAt | Hora en que se actualizó la configuración |
.Labels | Todas las etiquetas asignadas a la configuración |
.Label | Valor de una etiqueta específica para esta configuración. Por ejemplo {{.Label "mi-etiqueta"}} |
Al usar la opción --format, el comando config ls generará los datos exactamente como lo declara la plantilla o, cuando se use la directiva table, también incluirá los encabezados de las columnas.
El siguiente ejemplo utiliza una plantilla sin encabezados y genera las entradas ID y Name separadas por dos puntos (:) para todas las imágenes:
$ docker config ls --format "{{.ID}}: {{.Name}}"
77af4d6b9913: config-1
b6fa739cedf5: config-2
78a85c484f71: config-3
Para listar todas las configuraciones con su nombre y fecha de creación en formato de tabla, puedes usar:
$ docker config ls --format "table {{.ID}}\t{{.Name}}\t{{.CreatedAt}}"
ID NAME CREATED
77af4d6b9913 config-1 5 minutes ago
b6fa739cedf5 config-2 3 hours ago
78a85c484f71 config-3 10 days ago