docker image inspect

O comando docker image inspect permite obter detalhes completos sobre uma imagem Docker, retornando informações em formato JSON sobre a imagem especificada. Essa informação inclui metadados, configurações de contêineres padrão, camadas da imagem, e muito mais.

Sintaxe:

docker image inspect [OPTIONS] IMAGE [IMAGE...]

• IMAGE: Nome ou ID da imagem que você deseja inspecionar. Você pode inspecionar múltiplas imagens de uma vez, separando-as por espaço.

Opções Comuns:

• --format: Permite formatar a saída usando uma expressão de Go templates, o que é útil para extrair informações específicas sem precisar manipular o JSON bruto.

Exemplo de Uso:

docker image inspect nginx

Esse comando exibe todos os detalhes da imagem nginx. A saída inclui muitas informações, entre elas:

• Id: O ID da imagem.

• RepoTags: Os tags associados à imagem (ex.: nginx:latest).

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

• Size: O tamanho total da imagem.

• VirtualSize: Tamanho virtual, considerando camadas compartilhadas.

• RootFS: Detalhes sobre as camadas de sistema de arquivos.

• Config: Configurações padrão para contêineres criados a partir dessa imagem, como Env, Cmd, ExposedPorts, entre outros.

• Architecture: A arquitetura da CPU para a qual a imagem foi construída.

• Os: O sistema operacional para o qual a imagem foi construída.

Exemplo de Saída:

Abaixo está um exemplo simplificado de como a saída JSON pode parecer:

[
    {
        "Id": "sha256:6b362a9f73eb0d377ed2f3be1c10d15c46e3d58d377fd07379cd00dc5de3c1e0",
        "RepoTags": [
            "nginx:latest"
        ],
        "Created": "2024-08-01T12:34:56.789012345Z",
        "Size": 12655710,
        "VirtualSize": 12655710,
        "Architecture": "amd64",
        "Os": "linux",
        "RootFS": {
            "Type": "layers",
            "Layers": [
                "sha256:abc123...",
                "sha256:def456..."
            ]
        },
        "Config": {
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
            ],
            "Cmd": [
                "nginx",
                "-g",
                "daemon off;"
            ],
            "ExposedPorts": {
                "80/tcp": {}
            }
        }
    }
]

Usos Comuns:

1. Extração de Informações Específicas: Você pode usar a opção --format para obter apenas as partes do JSON que lhe interessam. Por exemplo, para obter apenas o ID da imagem:

   docker image inspect --format='{{.Id}}' nginx

2. Depuração e Verificação: Esse comando é útil para depurar problemas com imagens, como verificar variáveis de ambiente ou portas expostas.

3. Automação: Ao extrair informações específicas, você pode integrar o comando em scripts de automação para gerenciar imagens e contêineres de forma programática.

Considerações:

• A saída JSON pode ser bastante extensa, especialmente para imagens complexas, portanto, a formatação com --format pode ser muito útil para tornar as informações mais legíveis ou extrair apenas o que é necessário.

• Como o JSON pode incluir detalhes sensíveis, cuidado ao compartilhá-lo ou usá-lo em ambientes públicos.

Esse comando é essencial para entender profundamente a estrutura e os detalhes das imagens Docker que você está usando ou criando.