[docker] docker image inspect 명령어 사용법

1. docker image inspect 개요

docker image inspect 명령어는 특정 Docker 이미지의 세부 정보(JSON 형식)를 조회하는 명령어입니다.
이미지의 메타데이터, 생성일시, 크기, 환경 변수, 레이어 구조 등을 확인할 수 있습니다.

이미지 동작 원리를 이해하거나 문제를 디버깅할 때 매우 유용합니다.

 

2. 기본 사용법

docker image inspect <이미지명 또는 ID>

예:

docker image inspect ubuntu

→ ubuntu 이미지의 상세 메타데이터를 JSON 형태로 출력합니다.

 

 

3. 주요 정보 항목

docker image inspect 결과에서 자주 확인하는 항목은 다음과 같습니다.

• Id : 이미지의 고유 ID
• RepoTags : 이미지 이름과 태그
• Created : 이미지 생성 시간
• Size : 이미지 크기
• Config : 이미지 기본 실행 명령어, 환경 변수, 노출 포트 등 설정
• RootFS : 이미지 레이어 정보

 

 

4. 특정 항목만 출력하기

결과가 JSON 형식이라 굉장히 길기 때문에, --format 옵션을 사용해 원하는 정보만 골라서 출력할 수 있습니다.

이미지 크기 확인

docker image inspect ubuntu --format='{{.Size}}'

이미지 생성일 확인

docker image inspect ubuntu --format='{{.Created}}'

이미지의 기본 실행 명령어 확인

docker image inspect ubuntu --format='{{.Config.Cmd}}'

 

 

5. 실습 예제

# Nginx 이미지 정보 조회
docker pull nginx
docker image inspect nginx --format='{{.Config.ExposedPorts}}'

실행 결과 (예시):

map[80/tcp:{}]

→ Nginx 이미지는 기본적으로 80번 포트를 노출한다는 정보를 확인할 수 있습니다.

 

 

6. 정리

• docker image inspect <이미지> : 이미지의 세부 메타데이터를 JSON 형태로 출력
• --format 옵션을 사용하면 원하는 값만 추출 가능
• 생성일, 크기, 환경 변수, 포트 정보, 실행 명령어 등을 확인할 때 유용