HOWTO · Docker

Docker의 컨테이너 나열

이 튜토리얼은 시스템에서 생성한 도커 컨테이너를 나열하는 방법을 보여줍니다.

이 페이지의 내용

Docker CLI로 컨테이너를 나열한 다음, 실행 중인 컨테이너나 중지된 컨테이너가 필요한지, 결과 수를 제한할지, 특정 필드만 볼지에 따라 옵션을 선택합니다. 이 명령은 현재 컨텍스트에서 선택된 Docker 데몬에 질의합니다. 아래 예시는 명령어 형식이며 결과는 해당 데몬에 있는 컨테이너에 따라 달라지므로, 고정된 출력은 제시하지 않습니다.

Docker에서 실행 중인 모든 컨테이너 나열

현재 실행 중인 컨테이너를 나열하려면 docker ps를 실행합니다. 같은 기능을 하는 명령은 docker container ls입니다.

docker ps

기본 표에는 컨테이너 ID, 이미지, 시작 명령, 생성된 시점, 상태, 게시되었거나 노출된 포트, 이름이 표시됩니다. STATUS 필드에는 실행 중인 컨테이너가 얼마나 오래 가동되었는지가 나타납니다. 포트 항목은 포트 매핑이나 노출 상태를 나타내며, 이것만으로 서비스가 현재 컴퓨터에서 연결 가능한지는 알 수 없습니다.

명령 그룹 형식을 선호한다면 docker container ls를 사용하면 됩니다. 이 명령은 docker ps와 동일한 기본 컨테이너 집합과 열을 표시합니다.

Docker에서 실행 및 종료된 컨테이너 나열

실행 중인 컨테이너뿐 아니라 중지된 컨테이너도 포함하려면 -a 또는 --all을 추가합니다.

docker ps -a

중지된 컨테이너는 Exited (0)과 같은 상태로 계속 표시되며, 괄호 안의 숫자는 종료 코드입니다. 실행 중인 컨테이너의 상태는 Up으로 시작합니다. 이 옵션은 표시할 상태의 범위를 바꾸지만 중지된 컨테이너를 시작하지는 않습니다. 데몬에 컨테이너가 없으면 표에는 머리글만 표시됩니다.

Docker에서 컨테이너 수 지정해 나열

-n 뒤에 개수를 지정하면 가장 최근에 생성된 컨테이너 중 최대 그 수만큼 표시합니다. 컨테이너 상태와 관계없이 포함됩니다. 예를 들어 docker container ls -n 2는 컨테이너를 최대 두 개 표시하며, 이 옵션에서는 중지된 컨테이너를 포함하기 위해 -a를 추가할 필요가 없습니다. 지정한 수는 최대치이므로 컨테이너가 더 적으면 표시되는 행도 적습니다. 종료된 컨테이너만 대상으로 개수를 제한하려면 --filter "status=exited"를 함께 사용합니다. 예를 들면 docker ps -n 2 --filter "status=exited"입니다.

Docker에서 종료된 컨테이너만 나열

상태로 필터링하면 기록된 상태가 종료인 중지된 컨테이너를 찾을 수 있습니다.

docker container ls -a --filter "status=exited"

-a 옵션은 실행 중이 아닌 컨테이너도 후보에 포함하고, 상태 필터는 그중 상태가 종료인 컨테이너를 선택합니다. 이 필터는 다른 중지 상태까지 포함하지 않습니다. Docker 필터는 함께 사용할 수 있습니다. 각 조건이 찾으려는 결과에 맞는지 확인하세요.

Docker에서 최근 생성된 컨테이너 나열

--latest 또는 -l을 사용하면 가장 최근에 생성된 컨테이너 하나를 표시합니다.

docker container ls --latest

이 옵션은 중지된 컨테이너를 포함해 가장 최근 컨테이너 항목을 확인할 때 유용합니다. 최근 항목 여러 개를 표시하는 옵션은 아니므로, 개수를 지정하려면 -n을 사용하세요. 모든 상태에서 가장 최근 항목을 찾으려면 docker ps -a --latest처럼 -a를 명시할 수 있습니다.

Docker에서 컨테이너 ID 나열

컨테이너 ID만 출력하려면 -q 또는 --quiet을 추가합니다.

docker container ls -q

이 간결한 형식은 표시된 ID를 다른 명령에 전달하거나 셸 변수에 저장할 때 편리합니다. 기본적으로 실행 중인 컨테이너만 나열하며, 중지된 컨테이너도 포함하려면 -a를 추가합니다. 조용한 출력에는 이름, 상태 및 나머지 표 필드가 표시되지 않으므로, 그런 세부 정보를 확인하려면 일반 목록 형식을 사용하세요.

Docker에서 크기와 함께 컨테이너 나열

목록에 크기 정보를 포함하려면 -s 또는 --size를 추가합니다.

docker container ls -s

SIZE 열에는 컨테이너의 쓰기 가능 계층 크기와 가상 크기가 표시됩니다. 쓰기 가능 계층 크기는 해당 컨테이너에서 변경한 내용을 나타내고, 가상 크기에는 컨테이너가 사용하는 이미지 계층도 포함됩니다. 이 값은 저장 공간을 나타내며 현재 메모리 사용량을 뜻하지 않습니다. RAM 사용량이 필요하면 모니터링 명령이나 도구를 사용하세요. 기본 목록과 마찬가지로, -a를 추가하지 않으면 이 명령은 실행 중인 컨테이너를 표시합니다.