Docker CLI 필터

Docker CLI 필터 (Filter)

docker ps, docker images 같은 명령의 출력을 --filter 플래그로 필터링하는 방법을 설명한 문서예요.

출처: Filter output

본문

다양한 Docker CLI 명령은 --filter(또는 -f) 플래그를 지원해 출력을 필터링할 수 있어요. 이 기능은 많은 컨테이너/이미지 중에서 조건에 맞는 것만 골라내야 할 때 유용해요.

기본 사용법

--filter키=값 형식으로 조건을 지정해요.

$ docker ps --filter "status=running"
$ docker images --filter "dangling=true"

필터 조건 예시 (docker ps)

  • name=<이름>: 이름으로 필터. 예: --filter "name=web"
  • status=<상태>: 상태로 필터(running, exited, paused 등).
  • exited=<코드>: 특정 종료 코드로 필터.
  • label=<레이블>: 라벨로 필터. 예: --filter "label=environment=production"
  • ancestor=<이미지>: 특정 이미지에서 파생된 컨테이너만.

이미지 필터 예시 (docker images)

  • dangling=true: 태그가 없는 dangling 이미지만.
  • reference=<패턴>: 이름/태그 패턴으로 필터.

여러 조건을 반복해 지정하면 모두 만족하는 결과만 나와요. 필터 능력이 있는 명령과 지원되는 필터 키는 각 명령의 레퍼런스 문서를 참고하세요.

더 알아보기