Docker CLI 출력 포맷팅

Docker CLI 출력 포맷팅 (Formatting)

docker ps, docker images 같은 명령의 출력을 --format 플래그로 사용자 지정하는 방법을 설명한 문서예요.

출처: Format command and log output

본문

Docker CLI 명령은 --format 플래그를 지원해서 출력 형식을 Go 템플릿으로 지정할 수 있어요. 이 기능은 스크립트에서 특정 필드만 추출하거나 출력을 원하는 형태로 정리할 때 유용해요.

기본 사용법

--format은 Go 템플릿 문법을 사용해요. 템플릿 안에서 .ID, .Names, .Image 같은 플레이스홀더(필드)를 사용해요.

$ docker ps --format "table {{.ID}}\t{{.Names}}\t{{.Status}}"

예시

  • JSON 출력: docker ps --format '{{json .}}'
  • 특정 필드만: docker inspect --format '{{.Name}} {{.State.Status}}' <컨테이너>
  • table 접두사를 쓰면 헤더를 포함한 표 형식 출력을 얻을 수 있어요.

공통 플레이스홀더

  • .ID, .Image, .Names, .Status, .Ports 등은 docker ps에서.
  • .Name, .State, .Config, .NetworkSettings 등은 docker inspect에서.

템플릿 문법의 자세한 내용은 Go 템플릿 문서를 참고하세요. 포맷팅을 활용하면 컨테이너/이미지 정보를 원하는 형태로 뽑아 자동화에 활용할 수 있어요.

더 알아보기