Docker Inspect

docker inspectDocker Documentation

Descrição

O comando docker inspect fornece detalhes detalhados sobre a configuração e o estado de containers, imagens, volumes e redes em formato JSON.

Uso

docker inspect [OPTIONS] NAME|ID

Exemplo de Uso

docker inspect my_container

Exemplo de Saída

[
    {
        "Id": "123abc456def",
        "Created": "2024-09-07T14:00:00.000000000Z",
        "Path": "/bin/bash",
        "Args": [],
        "State": {
            "Status": "running",
            "Running": true,
            "Paused": false,
            "Restarting": false,
            "OOMKilled": false,
            "Dead": false,
            "Pid": 1234,
            "ExitCode": 0,
            "Error": "",
            "StartedAt": "2024-09-07T14:01:00.000000000Z",
            "FinishedAt": "0001-01-01T00:00:00Z"
        },
        "Config": {
            "Hostname": "my_container",
            "Domainname": "",
            "User": "",
            "AttachStdin": false,
            "AttachStdout": true,
            "AttachStderr": true,
            "ExposedPorts": {
                "80/tcp": {}
            },
            "Tty": false,
            "OpenStdin": false,
            "StdinOnce": false,
            "Env": [
                "DB_HOST=postgre",
                "DB_USER=user",
                "DB_PASS=pass"
            ],
            ...
        },
        ...
    }
]

Explicações

• State: Detalhes sobre o estado atual do container (executando, parado, etc.).

• Config: Informações sobre a configuração do container, como variáveis de ambiente e portas expostas.

Quando Usar

• Diagnóstico Detalhado: Para obter uma visão detalhada da configuração e do estado de um container, imagem, volume ou rede.

• Resolução de Problemas de Configuração: Para verificar se a configuração do container está correta e identificar possíveis problemas.

Laboratório

$ docker container ls
CONTAINER ID   IMAGE     COMMAND                  CREATED          STATUS          PORTS                                   NAMES
9ba71cfedb2b   nginx     "/docker-entrypoint.…"   11 minutes ago   Up 11 minutes   0.0.0.0:8080->80/tcp, :::8080->80/tcp   affectionate_galois

$ docker inspect 9ba71cfedb2b
[
    {
        "Id": "9ba71cfedb2b114b2212fc4762b8ac52ca76bedfde8bb18d93c720c7a5c1e418",
        "Created": "2024-09-07T18:28:30.464669078Z",
        "Path": "/docker-entrypoint.sh",
        "Args": [
            "nginx",
            "-g",
            "daemon off;"
        ],
        "State": {
            "Status": "running",
            "Running": true,
            "Paused": false,
            "Restarting": false,
            "OOMKilled": false,
            "Dead": false,
            "Pid": 90368,
            "ExitCode": 0,
            "Error": "",
            "StartedAt": "2024-09-07T18:28:30.552017668Z",
            "FinishedAt": "0001-01-01T00:00:00Z"
        },
        "Image": "sha256:39286ab8a5e14aeaf5fdd6e2fac76e0c8d31a0c07224f0ee5e6be502f12e93f3",
        "ResolvConfPath": "/var/lib/docker/containers/9ba71cfedb2b114b2212fc4762b8ac52ca76bedfde8bb18d93c720c7a5c1e418/resolv.conf",
        "HostnamePath": "/var/lib/docker/containers/9ba71cfedb2b114b2212fc4762b8ac52ca76bedfde8bb18d93c720c7a5c1e418/hostname",
        "HostsPath": "/var/lib/docker/containers/9ba71cfedb2b114b2212fc4762b8ac52ca76bedfde8bb18d93c720c7a5c1e418/hosts",
        "LogPath": "/var/lib/docker/containers/9ba71cfedb2b114b2212fc4762b8ac52ca76bedfde8bb18d93c720c7a5c1e418/9ba71cfedb2b114b2212fc4762b8ac52ca76bedfde8bb18d93c720c7a5c1e418-json.log",
        "Name": "/affectionate_galois",
        "RestartCount": 0,
        "Driver": "overlay2",
        "Platform": "linux",
        "MountLabel": "",
        "ProcessLabel": "",
        "AppArmorProfile": "",
        "ExecIDs": null,
        "HostConfig": {
            "Binds": null,
            "ContainerIDFile": "",
            "LogConfig": {
                "Type": "json-file",
                "Config": {}
            },
            "NetworkMode": "bridge",
            "PortBindings": {
                "80/tcp": [
                    {
                        "HostIp": "",
                        "HostPort": "8080"
                    }
                ]
            },
            "RestartPolicy": {
                "Name": "no",
                "MaximumRetryCount": 0
            },
            "AutoRemove": false,
            "VolumeDriver": "",
            "VolumesFrom": null,
            "ConsoleSize": [
                63,
                84
            ],
            "CapAdd": null,
            "CapDrop": null,
            "CgroupnsMode": "host",
            "Dns": [],
            "DnsOptions": [],
            "DnsSearch": [],
            "ExtraHosts": null,
            "GroupAdd": null,
            "IpcMode": "private",
            "Cgroup": "",
            "Links": null,
            "OomScoreAdj": 0,
            "PidMode": "",
            "Privileged": false,
            "PublishAllPorts": false,
            "ReadonlyRootfs": false,
            "SecurityOpt": null,
            "UTSMode": "",
            "UsernsMode": "",
            "ShmSize": 67108864,
            "Runtime": "runc",
            "Isolation": "",
            "CpuShares": 0,
            "Memory": 0,
            "NanoCpus": 0,
            "CgroupParent": "",
            "BlkioWeight": 0,
            "BlkioWeightDevice": [],
            "BlkioDeviceReadBps": [],
            "BlkioDeviceWriteBps": [],
            "BlkioDeviceReadIOps": [],
            "BlkioDeviceWriteIOps": [],
            "CpuPeriod": 0,
            "CpuQuota": 0,
            "CpuRealtimePeriod": 0,
            "CpuRealtimeRuntime": 0,
            "CpusetCpus": "",
            "CpusetMems": "",
            "Devices": [],
            "DeviceCgroupRules": null,
            "DeviceRequests": null,
            "MemoryReservation": 0,
            "MemorySwap": 0,
            "MemorySwappiness": null,
            "OomKillDisable": false,
            "PidsLimit": null,
            "Ulimits": [],
            "CpuCount": 0,
            "CpuPercent": 0,
            "IOMaximumIOps": 0,
            "IOMaximumBandwidth": 0,
            "MaskedPaths": [
                "/proc/asound",
                "/proc/acpi",
                "/proc/kcore",
                "/proc/keys",
                "/proc/latency_stats",
                "/proc/timer_list",
                "/proc/timer_stats",
                "/proc/sched_debug",
                "/proc/scsi",
                "/sys/firmware",
                "/sys/devices/virtual/powercap"
            ],
            "ReadonlyPaths": [
                "/proc/bus",
                "/proc/fs",
                "/proc/irq",
                "/proc/sys",
                "/proc/sysrq-trigger"
            ]
        },
        "GraphDriver": {
            "Data": {
                "LowerDir": "/var/lib/docker/overlay2/b6a2064d6c6d0df7be3cfe121f19171e2d6fbdcb5dee417b8a46f34fd1fa9dd0-init/diff:/var/lib/docker/overlay2/53ca1d567a08401398bc05589b82ab218f0a4dcf4875d67fee0fe2bfc954b5e4/diff:/var/lib/docker/overlay2/1861721874e4e9f8f69d0508c5b04cdd54ba920e761959d5a8ad43dd973466a3/diff:/var/lib/docker/overlay2/3e7720351ef56f1e9bcbe96ab9c5ddc57cdc3ef10e7a38a5bb028639ed2ea274/diff:/var/lib/docker/overlay2/511ff1ed1f3506e5245938903fe09d940a5a1b45ad33b52892007cdc88cf35d7/diff:/var/lib/docker/overlay2/72b03936547efe675a252f887f9c6f1c13e7c657750b3ebbd653a168da59e653/diff:/var/lib/docker/overlay2/6dfda3a0cd234cf757014db254d3ff0c090994737c28cce101492999997e2ab8/diff:/var/lib/docker/overlay2/6b4e91c6c46662eb15ad937b7a842d63f74be93efeda5e8f2c0f9eed65831baa/diff",
                "MergedDir": "/var/lib/docker/overlay2/b6a2064d6c6d0df7be3cfe121f19171e2d6fbdcb5dee417b8a46f34fd1fa9dd0/merged",
                "UpperDir": "/var/lib/docker/overlay2/b6a2064d6c6d0df7be3cfe121f19171e2d6fbdcb5dee417b8a46f34fd1fa9dd0/diff",
                "WorkDir": "/var/lib/docker/overlay2/b6a2064d6c6d0df7be3cfe121f19171e2d6fbdcb5dee417b8a46f34fd1fa9dd0/work"
            },
            "Name": "overlay2"
        },
        "Mounts": [],
        "Config": {
            "Hostname": "9ba71cfedb2b",
            "Domainname": "",
            "User": "",
            "AttachStdin": false,
            "AttachStdout": false,
            "AttachStderr": false,
            "ExposedPorts": {
                "80/tcp": {}
            },
            "Tty": false,
            "OpenStdin": false,
            "StdinOnce": false,
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
                "NGINX_VERSION=1.27.1",
                "NJS_VERSION=0.8.5",
                "NJS_RELEASE=1~bookworm",
                "PKG_RELEASE=1~bookworm",
                "DYNPKG_RELEASE=2~bookworm"
            ],
            "Cmd": [
                "nginx",
                "-g",
                "daemon off;"
            ],
            "Image": "nginx",
            "Volumes": null,
            "WorkingDir": "",
            "Entrypoint": [
                "/docker-entrypoint.sh"
            ],
            "OnBuild": null,
            "Labels": {
                "maintainer": "NGINX Docker Maintainers <[e-mail]>"
            },
            "StopSignal": "SIGQUIT"
        },
        "NetworkSettings": {
            "Bridge": "",
            "SandboxID": "946c7ae646acf06b0c29ef488cdb785ad0b39148db1744852388337040641282",
            "SandboxKey": "/var/run/docker/netns/946c7ae646ac",
            "Ports": {
                "80/tcp": [
                    {
                        "HostIp": "0.0.0.0",
                        "HostPort": "8080"
                    },
                    {
                        "HostIp": "::",
                        "HostPort": "8080"
                    }
                ]
            },
            "HairpinMode": false,
            "LinkLocalIPv6Address": "",
            "LinkLocalIPv6PrefixLen": 0,
            "SecondaryIPAddresses": null,
            "SecondaryIPv6Addresses": null,
            "EndpointID": "2d54b03bf7a10a1d0e6604a1b897f22bd53dc32e3f385db56b2ec94eb8b4b5fb",
            "Gateway": "172.17.0.1",
            "GlobalIPv6Address": "",
            "GlobalIPv6PrefixLen": 0,
            "IPAddress": "172.17.0.2",
            "IPPrefixLen": 16,
            "IPv6Gateway": "",
            "MacAddress": "02:42:ac:11:00:02",
            "Networks": {
                "bridge": {
                    "IPAMConfig": null,
                    "Links": null,
                    "Aliases": null,
                    "MacAddress": "02:42:ac:11:00:02",
                    "DriverOpts": null,
                    "NetworkID": "ecf1a29e1c88dc1d5946fc08ce5b1e185becf9110983e49d5eb27a17b4fb76dc",
                    "EndpointID": "2d54b03bf7a10a1d0e6604a1b897f22bd53dc32e3f385db56b2ec94eb8b4b5fb",
                    "Gateway": "172.17.0.1",
                    "IPAddress": "172.17.0.2",
                    "IPPrefixLen": 16,
                    "IPv6Gateway": "",
                    "GlobalIPv6Address": "",
                    "GlobalIPv6PrefixLen": 0,
                    "DNSNames": null
                }
            }
        }
    }
]

$ docker image ls
REPOSITORY   TAG       IMAGE ID       CREATED       SIZE
nginx        latest    39286ab8a5e1   3 weeks ago   188MB

$ docker inspect nginx:latest
[
    {
        "Id": "sha256:39286ab8a5e14aeaf5fdd6e2fac76e0c8d31a0c07224f0ee5e6be502f12e93f3",
        "RepoTags": [
            "nginx:latest"
        ],
        "RepoDigests": [
            "nginx@sha256:04ba374043ccd2fc5c593885c0eacddebabd5ca375f9323666f28dfd5a9710e3"
        ],
        "Parent": "",
        "Comment": "buildkit.dockerfile.v0",
        "Created": "2024-08-14T21:31:12Z",
        "DockerVersion": "",
        "Author": "",
        "Config": {
            "Hostname": "",
            "Domainname": "",
            "User": "",
            "AttachStdin": false,
            "AttachStdout": false,
            "AttachStderr": false,
            "ExposedPorts": {
                "80/tcp": {}
            },
            "Tty": false,
            "OpenStdin": false,
            "StdinOnce": false,
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
                "NGINX_VERSION=1.27.1",
                "NJS_VERSION=0.8.5",
                "NJS_RELEASE=1~bookworm",
                "PKG_RELEASE=1~bookworm",
                "DYNPKG_RELEASE=2~bookworm"
            ],
            "Cmd": [
                "nginx",
                "-g",
                "daemon off;"
            ],
            "ArgsEscaped": true,
            "Image": "",
            "Volumes": null,
            "WorkingDir": "",
            "Entrypoint": [
                "/docker-entrypoint.sh"
            ],
            "OnBuild": null,
            "Labels": {
                "maintainer": "NGINX Docker Maintainers <[e-mail]>"
            },
            "StopSignal": "SIGQUIT"
        },
        "Architecture": "amd64",
        "Os": "linux",
        "Size": 187706879,
        "GraphDriver": {
            "Data": {
                "LowerDir": "/var/lib/docker/overlay2/1861721874e4e9f8f69d0508c5b04cdd54ba920e761959d5a8ad43dd973466a3/diff:/var/lib/docker/overlay2/3e7720351ef56f1e9bcbe96ab9c5ddc57cdc3ef10e7a38a5bb028639ed2ea274/diff:/var/lib/docker/overlay2/511ff1ed1f3506e5245938903fe09d940a5a1b45ad33b52892007cdc88cf35d7/diff:/var/lib/docker/overlay2/72b03936547efe675a252f887f9c6f1c13e7c657750b3ebbd653a168da59e653/diff:/var/lib/docker/overlay2/6dfda3a0cd234cf757014db254d3ff0c090994737c28cce101492999997e2ab8/diff:/var/lib/docker/overlay2/6b4e91c6c46662eb15ad937b7a842d63f74be93efeda5e8f2c0f9eed65831baa/diff",
                "MergedDir": "/var/lib/docker/overlay2/53ca1d567a08401398bc05589b82ab218f0a4dcf4875d67fee0fe2bfc954b5e4/merged",
                "UpperDir": "/var/lib/docker/overlay2/53ca1d567a08401398bc05589b82ab218f0a4dcf4875d67fee0fe2bfc954b5e4/diff",
                "WorkDir": "/var/lib/docker/overlay2/53ca1d567a08401398bc05589b82ab218f0a4dcf4875d67fee0fe2bfc954b5e4/work"
            },
            "Name": "overlay2"
        },
        "RootFS": {
            "Type": "layers",
            "Layers": [
                "sha256:8e2ab394fabf557b00041a8f080b10b4e91c7027b7c174f095332c7ebb6501cb",
                "sha256:67796e30ff042303e3c8cbd8478e4f4f6377fd1754a168704f829c4e8a128f40",
                "sha256:eda13eb24d4c7b2c4cf60fbef992e18936613ad9067421ae1b59a413f3393267",
                "sha256:0fc6bb94eec5602c08d4261eedf9f122af7d122983c5ad8d8cf9ab108d9fd7bd",
                "sha256:2bdf51597158f7b0335cb1c082f8449a7ba1af678876158a05747eecca9b7604",
                "sha256:16907864a2d01d70c5c1e740085ace628f9d85b9eb38ced8c623e2c3ae36734d",
                "sha256:11de3d47036d69ed34dcf240a2d82e0ffc8a9dc8b77deeed65fb6380fbc84c8d"
            ]
        },
        "Metadata": {
            "LastTagTime": "0001-01-01T00:00:00Z"
        }
    }
]

# Inspeciona um container específico
$ docker container inspect <id|name>

# Inspeciona uma imagem específica
$ docker image inspect <id|name>

# Inspeciona uma rede específica
$ docker network inspect <id|name>

# Inspeciona múltiplos containers
$ docker container inspect <id1|name1> <id2|name2>