Huny's Dev Blog
huny.dev

Docker Compose ps에서 컨테이너가 안 보일 때: 중지 상태와 로그 확인

docker compose ps -a로 중지된 컨테이너를 찾고 상태 필터, 로그와 프로젝트 범위를 점검한다.

Hun Jang
Hun Jang Nov 16, 2026

Compose 서비스가 목록에서 사라졌다면 먼저 docker compose ps -a로 중지된 컨테이너까지 확인한다. 기본 ps는 실행 중인 컨테이너만 보여 주므로 빈 목록이 곧 서비스가 생성된 적이 없다는 뜻은 아니다.

실행 중인 컨테이너와 중지된 컨테이너를 나타낸 AI 생성 개념 이미지

이 글은 2026년 11월 16일 확인한 Docker Compose ps 공식 문서를 기준으로 한다. 명령은 문서 기반 예제이며 이 환경에 Docker가 없어 실제 데몬에서 실행하지 않았다.

1. 실행 중인 항목과 중지된 항목을 함께 확인한다

Compose 파일이 있는 프로젝트 디렉터리에서 실행한다.

첫 명령은 현재 실행 중인 컨테이너와 상태, 공개 포트를 보여 준다. -a는 중지된 컨테이너와 compose run으로 만든 중지 컨테이너도 포함한다. 출력의 SERVICE, STATUS, PORTS를 함께 살펴본다. 특정 서비스만 보려면 docker compose ps -a web처럼 실제 서비스 이름을 지정한다.

exited (0)은 프로세스가 성공 코드로 종료됐다는 뜻일 수 있다. 일회성 작업이라면 정상일 수 있지만 계속 떠 있어야 하는 웹 서버라면 원인을 살펴봐야 한다. restarting은 반복 재시작 중인 상태다. 종료 코드만으로 원인을 단정하지 않는다.

2. 종료 항목을 좁히고 로그를 읽는다

web은 실제 서비스 이름으로 바꾼다. 첫 명령은 종료 상태를 필터링하고 두 번째 명령은 해당 서비스의 최근 로그를 보여 준다. 로그에 비밀값이 포함될 수 있으므로 공유 전에 확인한다. 상태 필터와 옵션은 ps 문서, 로그 옵션은 logs 문서에서 확인할 수 있다.

컨테이너가 실행 중이어도 애플리케이션이 요청을 처리할 준비가 됐다는 보장은 없다. healthcheck가 구성돼 있으면 건강 상태를 확인하고, 실제 요청과 애플리케이션 로그도 점검한다. 데이터베이스 준비 순서에 대해서는 Docker Compose에서 DB 준비 전에 앱이 시작될 때: depends_on과 healthcheckDocker Compose에서 DB 준비 전에 앱이 시작될 때: depends_on과 healthcheck를 참고한다.

3. 그래도 보이지 않으면 프로젝트를 확인한다

ps는 Compose 프로젝트 범위에서 동작한다. 다른 디렉터리, -f 파일, 프로젝트 이름 또는 Docker context를 사용했다면 다른 목록을 볼 수 있다. 기존 실행에 사용한 설정을 확인하고 동일하게 지정한다.

myproject는 확인한 실제 프로젝트 이름으로 바꾼다. 컨테이너가 삭제됐거나 생성에 실패했다면 -a에도 나타나지 않는다. 이때는 실행 당시 출력과 배포 기록을 살펴본다. Compose 프로젝트 이름

4. 자동 처리에는 JSON Lines를 사용한다

현재 공식 문서는 JSON 형식을 컨테이너당 객체 한 줄인 JSON Lines로 설명한다. 위 명령은 별도 설치된 jq가 필요하며, 출력 필드와 옵션은 설치된 Compose 버전에서 확인한다. 목록은 조회 시점의 스냅샷이므로 이후 상태가 달라질 수 있다.

English version: Docker Compose ps: Find Stopped Containers and Check LogsDocker Compose ps: Find Stopped Containers and Check Logs

추천 글