docker compose images

O comando docker compose images é utilizado para listar as imagens dos containers definidas em um arquivo docker-compose.yml de um projeto. Ele fornece uma visão geral das imagens que estão sendo usadas, incluindo detalhes como a tag da imagem, o identificador (ID), o tamanho, e o status atual.

Uso Básico

docker compose images [OPTIONS]

Principais Opções

• --format string: Formata a saída em um dos formatos suportados, como table, json, ou yaml. Isso permite que a saída seja customizada ou processada por outras ferramentas.

• --quiet: Exibe apenas os IDs das imagens, útil quando você deseja uma saída simplificada, por exemplo, para usar em scripts.

• --filter: Filtra as imagens exibidas com base em critérios específicos, como status ou nome. Isso pode ajudar a focar a visualização em imagens de interesse.

Exemplos de Uso

1. Listar todas as imagens usadas pelo projeto:

   docker compose images

   Este comando exibe uma tabela com informações sobre todas as imagens usadas pelos serviços definidos no arquivo docker-compose.yml.

2. Listar apenas os IDs das imagens:

   docker compose images --quiet

   Útil para casos em que você precisa apenas dos IDs das imagens, por exemplo, para usá-los em outros comandos.

3. Formatar a saída em JSON:

   docker compose images --format json

   A saída será exibida em formato JSON, que pode ser processado por outras ferramentas ou scripts.

4. Filtrar imagens por status específico:

   docker compose images --filter "dangling=true"

   Exibe apenas as imagens que estão "dangling" (sem tags associadas).

Saída Padrão

A saída padrão do comando docker compose images exibe as seguintes colunas:

• Service: O nome do serviço definido no docker-compose.yml.

• Image: O nome completo da imagem (incluindo a tag).

• Tag: A tag da imagem (como latest, v1.0, etc.).

• Image ID: O identificador único da imagem.

• Size: O tamanho da imagem.

• Created: A data e hora em que a imagem foi criada.

• Status: O status atual da imagem (usada ou não usada).

Casos de Uso Comuns

• Verificação de Imagens Utilizadas: Ideal para verificar quais imagens estão sendo usadas em um projeto, especialmente útil para identificar versões desatualizadas ou dependências desnecessárias.

• Auditoria e Manutenção: Facilita a auditoria das imagens em uso e a realização de tarefas de manutenção, como a limpeza de imagens obsoletas.

• Automação e Scripts: A opção --quiet e o formato JSON são particularmente úteis em automação, permitindo que a saída seja utilizada em scripts para tarefas como remoção de imagens não utilizadas.

Considerações Finais

O comando docker compose images é uma ferramenta prática para gerenciar e auditar as imagens Docker usadas em um projeto. Ele oferece uma visão clara das imagens associadas aos serviços, com opções de filtragem e formatação para atender a diferentes necessidades, desde a simples visualização até a integração com scripts de automação.