docker ps
100%

Docker · 레슨 4

docker ps

Docker 컨테이너 목록을 보고 실행 중인 컨테이너와 종료된 컨테이너를 구분합니다.

Docker에서 시작한 웹 서버가 아직 실행 중인가요? docker ps로 확인해 봅시다. Docker 이미지에는 프로그램과 필요한 파일이 들어 있습니다. 컨테이너는 그 이미지로 만든 인스턴스입니다. 이 명령어는 실행한 시점의 컨테이너 목록을 보여 줍니다.

실행 중인 컨테이너 확인하기

기본적으로 docker ps는 실행 중인 컨테이너를 나열합니다. 아래 예제는 준비된 Docker 환경의 출력에서 몇 개 열만 보여 주므로 Docker를 따로 설정하지 않아도 읽을 수 있습니다. 터미널에서 따라 할 때는 $ 프롬프트 뒤의 명령어를 입력하세요.

$ docker ps
IMAGE         STATUS         NAMES
nginx:alpine  Up 4 minutes   web
nginx:alpine  Up 30 seconds  demo

열 제목만 나온다면 실행 중인 컨테이너 목록이 비어 있다는 뜻입니다. 같은 환경에 중지된 컨테이너가 남아 있을 수는 있습니다.

docker ps 실행 후 열 제목만 나타났습니다. 무엇을 알 수 있나요?

이름과 상태 읽기

NAMES 열에서 원하는 컨테이너를 찾습니다. 두 행의 IMAGE 열에는 모두 nginx:alpine이 표시됩니다. 오른쪽 끝에서 web을 찾고 같은 행에서 STATUS를 읽으세요. Up 4 minutes는 해당 컨테이너가 약 4분 동안 실행됐다는 뜻입니다.

약 30초 동안 실행된 컨테이너는 어느 행에 있나요?

종료된 컨테이너도 표시하기

찾던 컨테이너가 없다면 docker ps -a를 사용해 보세요. -a는 --all의 짧은 표기입니다. 중지되었지만 남아 있는 컨테이너도 포함합니다. 예제에는 미리 준비한 preview라는 작업도 있습니다.

$ docker ps -a
IMAGE         STATUS                         NAMES
nginx:alpine  Up 4 minutes                   web
nginx:alpine  Up 30 seconds                  demo
busybox:1.36  Exited (0) 2 minutes ago       report
busybox:1.36  Exited (1) About a minute ago  preview

컨테이너는 웹 서버나 스크립트와 같은 주 프로그램을 실행합니다. Exited는 해당 프로그램이 멈췄다는 뜻입니다. 괄호 안의 숫자는 프로그램이 끝날 때 반환한 종료 코드입니다. 일반적으로 0은 성공을, 0이 아닌 코드는 오류를 나타냅니다. report의 Exited (0)은 짧은 작업이 성공적으로 끝났을 때의 정상적인 결과입니다.

실행 중과 종료 상태의 컨테이너, report의 종료 코드 0과 preview의 종료 코드 1을 보여 주는 LabEx 터미널

LabEx 화면에는 예제 컨테이너 네 개의 이름과 상태만 표시됩니다. 경과 시간은 실행 시점에 따라 달라집니다.

종료 코드로 판단할 때 어느 행의 오류를 조사해야 하나요?

다음 확인 항목 고르기

종료 코드는 어디를 조사할지 알려 주는 단서입니다. preview가 오류 메시지를 출력했는지 보려면 docker logs 뒤에 그 이름을 적으세요. Docker가 그 컨테이너에서 수집한 출력이 표시됩니다.

$ docker logs preview

실행 중인 웹 서버의 페이지를 실제 방문자가 열 수 있는지도 확인할 수 있습니다. 페이지를 이용해야 하는 컴퓨터에서 직접 열어 보세요. Up은 컨테이너 내부 프로그램의 상태입니다. 브라우저 요청이 성공하면 테스트한 컴퓨터에서 페이지에 도달할 수 있다는 뜻입니다.

Docker가 실행되는 컴퓨터에서는 페이지가 열립니다. 다른 컴퓨터를 쓰는 동료도 페이지를 열어야 합니다. 어떤 확인으로 알 수 있나요?

레슨 완료

docker ps 완료

이제 컨테이너 목록에서 대상을 찾고 상태를 읽은 뒤 다음에 확인할 항목을 선택할 수 있습니다.

  • docker ps로 실행 중인 컨테이너를 표시합니다.

  • 이름으로 컨테이너를 찾고 상태를 읽습니다.

  • docker ps -a로 종료된 컨테이너도 포함합니다.

  • 상태만으로 확인하기 어렵다면 로그나 브라우저 요청을 사용합니다.

학습 진행 상황 저장

무료 계정을 만들어 이 레슨을 저장하고 어떤 기기에서든 계속 학습하세요.

무료 계정 만들기
다음 수업
Docker(으)로 돌아가기