Introdução
Neste laboratório, você aprenderá como usar o comando docker desktop engine ls para listar os motores Docker disponíveis. Começará por entender o propósito deste comando e como ele interage com o daemon Docker em um ambiente de VM (Virtual Machine) na nuvem.
Após a introdução, você explorará diferentes formatos de saída para o comando docker desktop engine ls. Aprenderá como listar os motores disponíveis usando o formato de tabela padrão, o formato JSON para dados estruturados e o formato "pretty" para melhor legibilidade. Este laboratório irá equipá-lo com as habilidades necessárias para inspecionar e gerenciar efetivamente seus motores Docker usando a CLI docker desktop.
Entenda o propósito do docker desktop engine ls
Nesta etapa, entenderemos o propósito do comando docker desktop engine ls. Embora o ambiente LabEx seja uma VM na nuvem e não um ambiente de desktop, os comandos docker desktop ainda estão disponíveis e podem ser usados para gerenciar os motores Docker.
O comando docker desktop engine ls é usado para listar os motores Docker disponíveis que o Docker Desktop reconhece. Em uma instalação típica do Docker Desktop, isso pode mostrar diferentes motores, como o padrão ou, potencialmente, outros, se você os tiver configurado. Em nosso ambiente de VM LabEx, este comando irá interagir com o daemon Docker em execução na VM.
Vamos executar o comando para ver a saída. Abra seu terminal no diretório ~/project.
docker desktop engine ls
Você deve ver uma saída semelhante a esta, indicando o motor padrão:
NAME STATUS BUILTIN
default running true
Esta saída nos informa o nome do motor (default), seu status atual (running) e se é um motor embutido (true). Entender este comando é o primeiro passo para gerenciar os motores Docker usando a CLI docker desktop.
Listar motores disponíveis usando o formato padrão
Na etapa anterior, usamos o comando docker desktop engine ls sem nenhuma opção de formatação específica. Este comando, por padrão, usa um formato de tabela padrão para exibir as informações sobre os motores Docker. Este formato padrão geralmente é fácil de ler e fornece os detalhes essenciais rapidamente.
Vamos executar o comando novamente para ver o formato de saída padrão. Certifique-se de estar no diretório ~/project em seu terminal.
docker desktop engine ls
A saída será semelhante a esta:
NAME STATUS BUILTIN
default running true
Este é o formato padrão. Ele apresenta os dados em colunas com cabeçalhos: NAME, STATUS e BUILTIN. Este formato é adequado para verificações rápidas e legibilidade humana. Nas próximas etapas, exploraremos outras opções de formatação que são úteis para scripting ou quando você precisa dos dados em uma estrutura diferente.
Listar motores disponíveis usando o formato JSON
Nesta etapa, aprenderemos como listar os motores Docker disponíveis no formato JSON. O formato JSON é particularmente útil quando você precisa processar a saída programaticamente, por exemplo, em scripts ou ao integrar com outras ferramentas.
Para obter a saída no formato JSON, usamos a flag --format com o valor json.
Execute o seguinte comando em seu terminal no diretório ~/project:
docker desktop engine ls --format json
A saída será um array JSON contendo objetos que representam cada motor Docker. Será semelhante a isto:
[
{
"Name": "default",
"Status": "running",
"Builtin": true
}
]
Como você pode ver, as informações são estruturadas como um objeto JSON dentro de um array, com chaves como "Name", "Status" e "Builtin". Este formato é legível por máquina e pode ser facilmente analisado por várias linguagens de programação e ferramentas.
Listar motores disponíveis usando o formato 'pretty'
Nesta etapa, exploraremos outra opção de formatação útil para o comando docker desktop engine ls: o formato pretty. O formato pretty permite que você personalize a saída usando a sintaxe de template Go, dando a você controle preciso sobre quais campos são exibidos e como eles são apresentados.
Para usar o formato pretty, você fornece a flag --format com uma string de template Go. Por exemplo, para exibir o nome e o status do motor, você pode usar o template {{.Name}}\t{{.Status}}. O . se refere ao objeto atual (um motor), e .Name e .Status acessam os campos respectivos. \t é usado para um caractere de tabulação para separar as colunas.
Vamos tentar listar o nome e o status do motor usando o formato pretty. Execute o seguinte comando em seu terminal no diretório ~/project:
docker desktop engine ls --format "{{.Name}}\t{{.Status}}"
A saída mostrará o nome e o status do motor, separados por uma tabulação:
default running
Você pode incluir cabeçalhos no formato pretty também. Para adicionar cabeçalhos, você pode incluí-los na string do template. Por exemplo, para adicionar os cabeçalhos "ENGINE NAME" e "STATUS":
docker desktop engine ls --format "ENGINE NAME\tSTATUS\n{{.Name}}\t{{.Status}}"
A saída agora incluirá os cabeçalhos:
ENGINE NAME STATUS
default running
O \n cria uma nova linha após a linha do cabeçalho. O formato pretty é muito flexível e permite que você adapte a saída às suas necessidades específicas, tornando-o útil tanto para legibilidade humana quanto para tarefas simples de scripting onde JSON pode ser excessivo.
Resumo
Neste laboratório, aprendemos como usar o comando docker desktop engine ls para listar os motores Docker disponíveis. Começamos entendendo o propósito deste comando, que é exibir informações sobre os motores Docker conhecidos pelo Docker Desktop, mesmo em um ambiente de VM em nuvem como o LabEx. Em seguida, praticamos a listagem dos motores disponíveis usando o formato de saída padrão, que apresenta o nome, status e se o motor é embutido em uma tabela clara e legível.
Exploramos ainda mais a flexibilidade do comando docker desktop engine ls listando os motores disponíveis usando o formato JSON, que é útil para processamento programático, e o formato pretty, que fornece uma saída formatada mais amigável para humanos. Por meio dessas etapas, ganhamos experiência prática no uso de diferentes formatos de saída para visualizar informações do motor Docker.
