<div id="readability-page-1" class="page"><div>
<article>
<header>
<h2>
  <a href="https://www.lainyzine.com/ko/article/listing-docker-containers/">
    도커 컨테이너 리스트 출력하기
  </a>
</h2>

</header>

<p>도커를 사용하면서 가장 많이 하는 작업이 바로 컨테이너 목록을 출력하고, 컨테이너 상태를 확인하는 일입니다. 이 글에서는 도커에서 컨테이너 목록을 출력하는 방법에 대해서 상세히 알아봅니다.</p>
<nav>
<ul>
<li><a href="#%EB%8F%84%EC%BB%A4-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-%EB%A6%AC%EC%8A%A4%ED%8A%B8-%EC%B6%9C%EB%A0%A5%ED%95%98%EB%8A%94-%EB%B0%A9%EB%B2%95-docker-ps">도커 컨테이너 리스트 출력하는 방법: docker ps</a></li>
<li><a href="#docker-ps%EC%99%80-docker-container-ls">docker ps와 docker container ls</a></li>
<li><a href="#docker-stats%EC%9C%BC%EB%A1%9C-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-%EB%AA%A8%EB%8B%88%ED%84%B0%EB%A7%81%ED%95%98%EA%B8%B0">docker stats으로 컨테이너 모니터링하기</a></li>
<li><a href="#docker-compose-%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8%EC%9D%98-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-%EB%AA%A9%EB%A1%9D">Docker Compose 프로젝트의 컨테이너 목록</a></li>
</ul>
</nav>
<h2 id="도커-컨테이너-리스트-출력하는-방법-docker-ps">도커 컨테이너 리스트 출력하는 방법: docker ps</h2>
<p>컨테이너 목록을 출력하는 명령어는 <code>docker ps</code> 입니다. 도커를 본격적으로 사용한다면 수백번은 실행하게 될 명령어입니다. <code>docker ps</code>는 인자없이 실행하면, 현재 실행중인 컨테이너 리스트를 출력합니다.</p>
<pre><code>$ docker ps
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES</code></pre>
<p>실행한 컨테이너가 없다면, 위와 같이 컬럼명만 출력되고 종료됩니다. 예제를 위해 컨테이너들을 몇 개 실행해보겠습니다.</p>
<pre><code>$ docker run -d -p 8080:80 nginx:latest                          # 1
$ docker run -d --name nginx-8081 -p 8081:80 nginx:latest        # 2
$ docker create -p 8080:80 nginx:latest                          # 3
$ docker run -d --name ubuntu ubuntu:latest sleep 10000          # 4
$ docker run -d --name debian debian:latest whoami               # 5
$ docker run -d --label my.name=alpine alpine:latest sleep 10000 # 6</code></pre>
<p>nginx, ubuntu, debian, alpine 이미지를 사용해 총 6개의 컨테이너를 생성해보았습니다. ps 명령으로 컨테이너 목록을 다시 출력해봅니다.</p>
<ul>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/docker-run/">docker run 사용법: 컨테이너 실행</a>
</li>
</ul>
<pre><code>$ docker ps
CONTAINER ID   IMAGE           COMMAND                  CREATED              STATUS              PORTS                  NAMES
e1f0107fa6e5   alpine:latest   "sleep 10000"            About a minute ago   Up About a minute                          festive_perlman
232630b4e4d4   ubuntu:latest   "sleep 10000"            About a minute ago   Up About a minute                          ubuntu
1ed31a27944b   nginx:latest    "/docker-entrypoint.…"   About a minute ago   Up About a minute   0.0.0.0:8081-&gt;80/tcp   nginx-8081
06b17d8c5cfd   nginx:latest    "/docker-entrypoint.…"   About a minute ago   Up About a minute   0.0.0.0:8080-&gt;80/tcp   naughty_dubinsky</code></pre>
<p>이 컨테이너들은 Status의 값이 Up으로 시작하는 것을 알 수 있습니다. 상태와 상관없이 모든 컨테이너의 목록을 출력하고 싶다면 <code>-a</code> 옵션을 사용합니다.</p>
<pre><code>$ docker ps -a</code></pre>
<p>컨테이너는 격리된 프로세스라고도 할 수 있습니다만, 프로세스를 감싸고 있는 추상화 객체이기도 합니다. 예를 들어 생성되고, 실행되지 않은 컨테이너가 존재할 수 있습니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/difference-between-docker-run-and-docker-create/">docker run과 docker create의 차이점</a></li>
</ul>
<p>그리고 프로세스는 종료되면 사라집니다만, 도커 컨테이너는 종료되더라도 사라지지 않습니다. 종료된 컨테이너를 재실행하거나, 컨테이너에 저장된 파일이나 로그를 가져올 수도 있습니다. <code>-a</code> 옵션은 이런 모든 컨테이너 목록을 출력해줍니다.</p>
<p>종료된 컨테이너만 보고 싶을 때는 필터 옵션을 사용합니다. status 값은 <code>running</code>, <code>restarting</code>, <code>running</code>, <code>exited</code>를 지정할 수 있습니다.</p>
<pre><code>$ docker ps --filter "status=exited"</code></pre>
<p>새로운 컨테이너를 실행했을 때는, 가장 최근 컨테이너만 보여주는 <code>-l</code> 옵션이 유용합니다. 이 옵션으로 가장 최근에 실행한 컨테이너의 상태를 확인할 수 있습니다.</p>
<pre><code>$ docker ps -l
CONTAINER ID   IMAGE           COMMAND    CREATED         STATUS                     PORTS     NAMES
9b37b52ddaba   debian:latest   "whoami"   9 minutes ago   Exited (0) 9 minutes ago             debian</code></pre>
<p>컨테이너 ID만 출력하고 싶을 때는 <code>-q</code> 옵션을 사용합니다.</p>
<pre><code>$ docker ps -q</code></pre>
<p>이 옵션은 컨테이너 ID로 일괄작업을 수행할 때 자주 사용합니다. 예를 들어 다음 명령어는 모든 도커 컨테이너를 일괄적으로 삭제합니다.</p>
<pre><code>$ docker rm -f $(docker ps -aq)</code></pre>
<p>컨테이너 목록을 직접 확인할 때는 <code>docker ps</code>의 형식도 크게 문제는 없습니다만, 다른 프로그램과 연동해서 사용하고 싶을 때는 JSON 포맷을 사용할 수 있습니다.</p>
<pre><code>$ docker ps --format "{{json .}}"</code></pre>
<p>이 정도면 <code>docker ps</code> 명령어를 활용하기에는 충분합니다. 더 자세한 docker ps 명령어 사용법과 주요 옵션들에 대한 해설은 다음 글에서 알아봅니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/docker-ps/">docker ps 명령어 사용법(컨테이너 목록)</a></li>
</ul>
<h2 id="docker-ps와-docker-container-ls">docker ps와 docker container ls</h2>
<p><code>docker ps</code>와 <code>docker container ls</code> 명령어는 같은 명령어입니다. 처음에는 <code>docker ps</code> 명령어가 사용되었습니다만, Docker 명령어에 네임스페이스(<code>image</code>, <code>container</code>, <code>network</code> 등)가 추가 되면서 명령어 이름이 변경되었습니다. 단, 기존 방식인 <code>docker ps</code> 명령어도 그대로 사용할 수 있습니다.</p>
<pre><code>$ docker container ls</code></pre>
<p>또한, <code>docker container ls</code>와 <code>docker container ps</code> 명령어도 같습니다.</p>
<h2 id="docker-stats으로-컨테이너-모니터링하기">docker stats으로 컨테이너 모니터링하기</h2>
<p>docker stats 명령어로도 현재 실행중인 컨테이너 목록을 확인할 수 있습니다. stats 명령어는 컨테이너 목록을 출력할 뿐만 아니라, CPU, 메모리, 네트워크 I/O, 블록 I/O 등 컨테이너의 자원 상황을 실시간으로 모니터링할 수 있습니다.</p>
<pre><code>$ docker stats
CONTAINER ID   NAME                                     CPU %     MEM USAGE / LIMIT     MEM %     NET I/O         BLOCK I/O       PIDS
aed425a1aa24   elated_mayer                             0.00%     532KiB / 7.755GiB     0.01%     656B / 0B       0B / 0B         1
2f5caec63b1a   nginx-8081                               0.00%     7.227MiB / 7.755GiB   0.09%     656B / 0B       0B / 12.3kB     9
0760a289f115   focused_neumann                          0.00%     7.219MiB / 7.755GiB   0.09%     656B / 0B       0B / 12.3kB     9</code></pre>
<p>출력에서 알 수 있듯이, <code>docker ps</code> 명령어로 확인할 수 있는 정보와는 조금 차이가 있습니다.</p>
<h2 id="docker-compose-프로젝트의-컨테이너-목록">Docker Compose 프로젝트의 컨테이너 목록</h2>


<p>Docker Compose를 사용하는 경우, 현재 프로젝트에 속한 컨테이너 목록만 확인하는 것이 가능합니다. 이 때는 <code>docker-compose ps</code> 명령어를 사용합니다.</p>
<pre><code>$ docker-compose ps</code></pre>
<p>Docker Compose의 기본적인 사용법에 대해서는 다음 글에서 더 자세히 소개합니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/learning-docker-compose-by-example/">예제로 시작하는 Docker Compose 입문</a></li>
</ul>


</article>
</div></div>

LZ: 프로그래머 가이드

LainyZine

도커 컨테이너 리스트를 출력하는 명령어(docker ps, docker stats 등)들의 사용법을 알아봅니다.
전체 기사는 이 링크에서 읽을 수 있습니다.

도커 컨테이너 리스트 출력하기

댓글