본문 바로가기

리눅스

[draft] docker inspect 명령어

docker inspect 명령어

docker inspect 명령어는 Docker 객체의 상세 정보를 조회할 때 사용하는 명령어입니다.

  • Docker 객체 항목
    • 컨테이너(Container)
    • 이미지(Image)
    • 네트워크(Network)
    • 볼륨(Volume)

이 명령어는 객체의 구성 정보, 네트워크 설정, 환경 변수, 마운트 정보 등 다양한 세부 정보를 JSON 형식으로 반환합니다.

1. 기본 사용 방법

기본적으로 docker inspect는 대상 객체의 모든 정보를 JSON 형태로 출력합니다.

docker inspect <container_name_or_id>
[
  {
    "Id": "f5c9e...",
    "Created": "2024-01-01T12:00:00Z",
    "Path": "java",
    "Args": ["-jar", "app.jar"],
    "NetworkSettings": {
      "IPAddress": "172.17.0.2"
    }
  }
]

JSON 형식이기 때문에 스크립트 자동화 및 DevOps 환경에서 자주 활용됩니다.

2. 컨테이너 정보 조회

특정 컨테이너의 상세 정보를 확인할 수 있습니다.

 

기본 명령어

docker inspect <image_name_or_id>

예시

docker inspect my-container

조회 가능한 주요 정보

  • Id : 컨테이너 ID
  • Image : 사용된 Docker 이미지
  • State : 컨테이너 상태
  • NetworkSettings : 네트워크 설정
  • Mounts : 볼륨 마운트 정보
  • Config.Env : 환경 변수

3. 이미지 정보 조회

Docker 이미지의 상세 정보도 조회할 수 있습니다.

 

기본 명령어

docker inspect <image_name_or_id>

예시

docker inspect ubuntu:22.04

조회 가능한 정보

  • Id 이미지 ID
  • RepoTags 이미지 태그
  • Architecture CPU 아키텍처
  • Os 운영체제
  • Size 이미지 크기

4. 특정 필드만 조회하기 (--format)

docker inspect는 기본적으로 많은 JSON 데이터를 반환합니다.

필요한 정보만 확인하려면 --format 옵션을 사용할 수 있습니다.

 

기본 형식

docker inspect --format='{{.Field}}' <container_or_image>

Docker는 Go Template 문법을 사용하여 특정 필드를 출력합니다.

5. 실무에서 자주 사용하는 조회 예제

컨테이너 IP 주소 확인

docker inspect --format='{{.NetworkSettings.IPAddress}}' <container>
docker inspect --format='{{.NetworkSettings.IPAddress}}' my-container

컨테이너 플랫폼 확인

docker inspect --format='{{.Platform}}' <container-name or container-id>
$ docker inspect --format='{{.Platform}}' confident_heyrovsky
linux

이미지 플랫폼 확인

docker inspect --format='{{.Os}}/{{.Architecture}}' <image-name or image-id>
$ docker inspect --format='{{.Os}}/{{.Architecture}}' anti1346/ubuntu2204:latest
linux/amd64

6. 유용한 조회 예제 (실무 활용)

컨테이너 실행 상태 확인

docker inspect --format='{{.State.Status}}' <container>

컨테이너 시작 시간 확인

docker inspect --format='{{.State.StartedAt}}' <container>

컨테이너 이미지 확인

docker inspect --format='{{.Config.Image}}' <container>

마운트된 볼륨 확인

docker inspect --format='{{.Mounts}}' <container>