Cómo usar el comando docker desktop engine ls para listar motores disponibles

Introducción

En este laboratorio, aprenderás a utilizar el comando docker desktop engine ls para listar los motores de Docker disponibles. Comenzarás comprendiendo el propósito de este comando y cómo interactúa con el demonio de Docker en un entorno de máquina virtual en la nube.

Después de la introducción, explorarás diferentes formatos de salida para el comando docker desktop engine ls. Aprenderás a listar los motores disponibles utilizando el formato de tabla predeterminado, el formato JSON para datos estructurados y el formato "pretty" para una mejor legibilidad. Este laboratorio te proporcionará las habilidades necesarias para inspeccionar y gestionar eficazmente tus motores de Docker utilizando la CLI de docker desktop.

Skills Graph

Comprender el propósito de docker desktop engine ls

En este paso, entenderemos el propósito del comando docker desktop engine ls. Aunque el entorno de LabEx es una máquina virtual en la nube y no un entorno de escritorio, los comandos de docker desktop siguen disponibles y pueden utilizarse para gestionar motores de Docker.

El comando docker desktop engine ls se utiliza para listar los motores de Docker disponibles que Docker Desktop reconoce. En una instalación típica de Docker Desktop, esto podría mostrar diferentes motores, como el predeterminado u otros si los has configurado. En nuestro entorno de máquina virtual de LabEx, este comando interactuará con el demonio de Docker que se ejecuta en la VM.

Ejecutemos el comando para ver la salida. Abre tu terminal en el directorio ~/project.

docker desktop engine ls

Deberías ver una salida similar a esta, que indica el motor predeterminado:

NAME    STATUS    BUILTIN
default running   true

Esta salida nos indica el nombre del motor (default), su estado actual (running) y si es un motor integrado (true). Comprender este comando es el primer paso para gestionar motores de Docker utilizando la CLI de docker desktop.

Listar motores disponibles usando el formato predeterminado

En el paso anterior, utilizamos el comando docker desktop engine ls sin opciones de formato específicas. Por defecto, este comando utiliza un formato de tabla estándar para mostrar la información sobre los motores de Docker. Este formato predeterminado suele ser fácil de leer y proporciona los detalles esenciales de un vistazo.

Ejecutemos nuevamente el comando para ver el formato de salida predeterminado. Asegúrate de estar en el directorio ~/project en tu terminal.

docker desktop engine ls

La salida se verá así:

NAME    STATUS    BUILTIN
default running   true

Este es el formato predeterminado. Presenta los datos en columnas con encabezados: NAME, STATUS y BUILTIN. Este formato es adecuado para verificaciones rápidas y legibilidad humana. En los siguientes pasos, exploraremos otras opciones de formato que son útiles para scripting o cuando necesitas los datos en una estructura diferente.

Listar motores disponibles usando formato JSON

En este paso, aprenderemos cómo listar los motores de Docker disponibles en formato JSON. Este formato es especialmente útil cuando necesitas procesar la salida de manera programática, por ejemplo, en scripts o al integrarse con otras herramientas.

Para obtener la salida en formato JSON, utilizamos la bandera --format con el valor json.

Ejecuta el siguiente comando en tu terminal dentro del directorio ~/project:

docker desktop engine ls --format json

La salida será un arreglo JSON que contiene objetos representando cada motor de Docker. Se verá similar a esto:

[
  {
    "Name": "default",
    "Status": "running",
    "Builtin": true
  }
]

Como puedes observar, la información está estructurada como un objeto JSON dentro de un arreglo, con claves como "Name", "Status" y "Builtin". Este formato es legible por máquinas y puede ser fácilmente analizado por diversos lenguajes de programación y herramientas.

Listar motores disponibles usando el formato pretty

En este paso, exploraremos otra opción de formato útil para el comando docker desktop engine ls: el formato pretty. Este formato permite personalizar la salida usando sintaxis de plantillas Go, brindando control detallado sobre qué campos se muestran y cómo se presentan.

Para usar el formato pretty, se proporciona la bandera --format con una cadena de plantilla Go. Por ejemplo, para mostrar el nombre y estado del motor, puedes usar la plantilla {{.Name}}\t{{.Status}}. El . hace referencia al objeto actual (un motor), mientras que .Name y .Status acceden a los campos respectivos. \t se usa para un carácter de tabulación que separa las columnas.

Probemos listar el nombre y estado del motor usando el formato pretty. Ejecuta el siguiente comando en tu terminal dentro del directorio ~/project:

docker desktop engine ls --format "{{.Name}}\t{{.Status}}"

La salida mostrará el nombre y estado del motor, separados por una tabulación:

default running

También puedes incluir encabezados en el formato pretty. Para añadirlos, inclúyelos en la cadena de plantilla. Por ejemplo, para agregar los encabezados "NOMBRE DEL MOTOR" y "ESTADO":

docker desktop engine ls --format "NOMBRE DEL MOTOR\tESTADO\n{{.Name}}\t{{.Status}}"

La salida ahora incluirá los encabezados:

NOMBRE DEL MOTOR	ESTADO
default	running

El \n crea un salto de línea después de la fila de encabezados. El formato pretty es muy flexible y permite adaptar la salida a necesidades específicas, siendo útil tanto para legibilidad humana como para tareas simples de scripting donde JSON podría ser excesivo.

Resumen

En este laboratorio, aprendimos a utilizar el comando docker desktop engine ls para listar los motores de Docker disponibles. Comenzamos comprendiendo el propósito de este comando, que es mostrar información sobre los motores de Docker conocidos por Docker Desktop, incluso en entornos de máquina virtual en la nube como LabEx. Luego practicamos el listado de motores disponibles usando el formato de salida predeterminado, que presenta el nombre del motor, su estado y si es integrado en una tabla clara y legible.

Exploramos además la flexibilidad del comando docker desktop engine ls al listar los motores disponibles usando el formato JSON, útil para procesamiento programático, y el formato pretty, que proporciona una salida más amigable y formateada para humanos. A través de estos pasos, adquirimos experiencia práctica en el uso de diferentes formatos de salida para visualizar información sobre motores de Docker.