<div id="readability-page-1" class="page"><div>
<article>
<header>


</header>
<nav>
<ul>
<li><a href="#docker-ps-%EB%AA%85%EB%A0%B9%EC%96%B4%EB%8A%94">docker ps 명령어는?</a></li>
<li><a href="#docker-ps-%EA%B8%B0%EB%B3%B8-%EC%82%AC%EC%9A%A9%EB%B2%95">docker ps 기본 사용법</a></li>
<li><a href="#l-%EA%B0%80%EC%9E%A5-%EC%B5%9C%EA%B7%BC%EC%97%90-%EC%8B%A4%ED%96%89%ED%95%9C-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-%EC%B6%9C%EB%A0%A5"><code>-l</code>: 가장 최근에 실행한 컨테이너 출력</a></li>
<li><a href="#last--n-%EC%B5%9C%EA%B7%BC%EC%97%90-%EC%8B%A4%ED%96%89%ED%95%9C-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-n%EA%B0%9C-%EC%B6%9C%EB%A0%A5"><code>--last</code>, <code>-n</code>: 최근에 실행한 컨테이너 n개 출력</a></li>
<li><a href="#q-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-id%EB%A7%8C-%EC%B6%9C%EB%A0%A5"><code>-q</code>: 컨테이너 ID만 출력</a></li>
<li><a href="#size-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88%EC%9D%98-%EC%82%AC%EC%9D%B4%EC%A6%88-%EC%B6%9C%EB%A0%A5"><code>--size</code>: 컨테이너의 사이즈 출력</a></li>
<li><a href="#no-trunc-%ED%92%80-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-id-%EC%B6%9C%EB%A0%A5"><code>--no-trunc</code>: 풀 컨테이너 ID 출력</a></li>
<li><a href="#format-%EC%BB%A4%EC%8A%A4%ED%85%80-%EC%B6%9C%EB%A0%A5-%ED%8F%AC%EB%A7%B7"><code>--format</code>: 커스텀 출력 포맷</a></li>
<li><a href="#filter-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-%EB%AA%A9%EB%A1%9D-%ED%95%84%ED%84%B0%EB%A7%81"><code>--filter</code>: 컨테이너 목록 필터링</a></li>
<li><a href="#%EC%B6%94%EC%B2%9C-%EB%AC%B8%EC%84%9C">추천 문서</a></li>
</ul>
</nav>
<h2 id="docker-ps-명령어는">docker ps 명령어는?</h2>
<p><a href="/ko/article/docker/">Docker</a>에서는 docker run이나 docker create 명령어로 <a href="/ko/article/linux-container/">리눅스 컨테이너</a>를 실행할 수 있습니다. Docker로 실행한 컨테이너 목록을 볼 수 있는 명령어가 바로 docker ps입니다. Docker를 사용하면 docker run만큼이나 많이 실행하는 명령어 중 하나입니다. 이 글에서는 docker ps의 사용법과 옵션들에 대해서 소개합니다.</p>
<h2 id="docker-ps-기본-사용법">docker ps 기본 사용법</h2>
<p>docker ps는 필수 인자가 없습니다. 따라서 인자 없이 사용하는 경우가 많습니다. 인자 없이 실행하면 현재 실행중인 컨테이너 목록을 출력합니다. 이 명령어는 <code>docker contanier ls</code>, <code>docker container 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>총 4개의 컨테이너가 출력됩니다. STATUS가 “Up”으로 시작되는 건 현재 실행중이라는 의미입니다. 그 외에도 컨테이너 목록을 통해 Container의 ID, 이름, 이미지 이름, 실행한 명령어, 컨테이너가 만들어진 시간 등을 확인할 수 있습니다.</p>
<p>나머지 2개는 어떻게 출력할 수 있을까요? 모든 상태의 컨테이너를 출력할 때는 <code>-a</code> 옵션을 사용합니다.</p>
<pre><code>docker ps -a
CONTAINER ID   IMAGE           COMMAND                  CREATED         STATUS                     PORTS                  NAMES
9b37b52ddaba   debian:latest   "whoami"                 3 minutes ago   Exited (0) 2 minutes ago                          debian
e1f0107fa6e5   alpine:latest   "sleep 10000"            4 minutes ago   Up 4 minutes                                      festive_perlman
232630b4e4d4   ubuntu:latest   "sleep 10000"            4 minutes ago   Up 4 minutes                                      ubuntu
d59b48958792   nginx:latest    "/docker-entrypoint.…"   4 minutes ago   Created                                           unruffled_diffie
1ed31a27944b   nginx:latest    "/docker-entrypoint.…"   4 minutes ago   Up 4 minutes               0.0.0.0:8081-&gt;80/tcp   nginx-8081
06b17d8c5cfd   nginx:latest    "/docker-entrypoint.…"   4 minutes ago   Up 4 minutes               0.0.0.0:8080-&gt;80/tcp   naughty_dubinsky</code></pre>
<p>이제 모든 컨테이너가 출력됩니다. STATUS 컬럼을 통해 실행중이지 않은 컨테이너를 확인할 수 있습니다. debian 컨테이너는 Exited(종료) 상태입니다. 괄호 안의 0은 리눅스 Exit code를 의미합니다. 이 값이 0이면 정상 종료된 것이고, 그렇지 않으면 비정상적으로 종료된 상태입니다. 다음으로 unruffled_diffie 컨테이너는 Created(생성) 상태입니다. docker create 명령어는 컨테이너를 생성만 하고 실행은 하지 않습니다. 컨테이너를 실행하고 싶을 때는 다음과 같이 <code>start</code> 명령을 사용해 실행할 수 있습니다.</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>
<pre><code>$ docker strat unruffled_diffie</code></pre>
<p>여기서는 생성 상태로 남겨두겠습니다.</p>
<p>docker ps는 출력 목록이나 형식을 다루는 옵션들을 지원하고 있습니다. 여기서부터는 옵션들에 대해서 하나씩 알아보겠습니다.</p>
<h2 id="l-가장-최근에-실행한-컨테이너-출력">
<code>-l</code>: 가장 최근에 실행한 컨테이너 출력</h2>
<p><code>-l</code> 옵션을 사용하면 가장 최근에 실행한 컨테이너 1개를 출력할 수 있습니다.</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>이 옵션은 컨테이너를 실행한 직후에 많이 사용합니다. 특히 컨테이너가 실행중이 아니더라도 목록에서 보여주기 때문에 매우 유용합니다.</p>
<h2 id="last--n-최근에-실행한-컨테이너-n개-출력">
<code>--last</code>, <code>-n</code>: 최근에 실행한 컨테이너 n개 출력</h2>


<p><code>--last</code> 혹은 <code>-n</code> 옵션은 출력할 컨테이너 개수를 인자로 받아 최근에 실행한 컨테이너 n개를 출력합니다.</p>
<pre><code>$ docker ps --last 2
CONTAINER ID   IMAGE           COMMAND         CREATED          STATUS                      PORTS     NAMES
9b37b52ddaba   debian:latest   "whoami"        10 minutes ago   Exited (0) 10 minutes ago             debian
e1f0107fa6e5   alpine:latest   "sleep 10000"   11 minutes ago   Up 11 minutes                         festive_perlman</code></pre>
<p><code>-l</code> 옵션과 비슷하게 실행중이지 않은 컨테이너 목록도 출력해줍니다.</p>
<h2 id="q-컨테이너-id만-출력">
<code>-q</code>: 컨테이너 ID만 출력</h2>
<p><code>-q</code> 옵션은 주로 다른 옵션과 조합해서 사용하는 옵션으로, 컨테이너 목록에서 컨테이너 ID 값만 출력합니다. 다음 명령어는 현재 실행중인(Up) 컨테이너의 ID만 출력합니다.</p>
<pre><code>$ docker ps -q
e1f0107fa6e5
232630b4e4d4
1ed31a27944b
06b17d8c5cfd</code></pre>
<p><code>-l</code> 옵션과 조합해서 사용하면 가장 최근에 실행한 컨테이너의 ID를 출력합니다.</p>
<pre><code>$ docker ps -lq
9b37b52ddaba</code></pre>
<h2 id="size-컨테이너의-사이즈-출력">
<code>--size</code>: 컨테이너의 사이즈 출력</h2>
<p><code>--size</code> 옵션을 지정하면, 각 컨테이너의 용량을 출력해줍니다.</p>
<pre><code>$ docker ps -n 2 --size
CONTAINER ID   IMAGE           COMMAND                  CREATED          STATUS          PORTS                  NAMES              SIZE
e1f0107fa6e5   alpine:latest   "sleep 10000"            22 minutes ago   Up 22 minutes                          festive_perlman    0B (virtual 7.66MB)
232630b4e4d4   ubuntu:latest   "sleep 10000"            22 minutes ago   Up 22 minutes                          ubuntu             0B (virtual 69.2MB)
1ed31a27944b   nginx:latest    "/docker-entrypoint.…"   23 minutes ago   Up 22 minutes   0.0.0.0:8081-&gt;80/tcp   nginx-8081         1.09kB (virtual 192MB)
06b17d8c5cfd   nginx:latest    "/docker-entrypoint.…"   23 minutes ago   Up 23 minutes   0.0.0.0:8080-&gt;80/tcp   naughty_dubinsky   1.09kB (virtual 192MB)</code></pre>
<p>내용이 많아서, 출력 내용을 조금 정리해보았습니다.</p>
<pre><code>CONTAINER ID   IMAGE           SIZE
e1f0107fa6e5   alpine:latest   0B (virtual 7.66MB)
232630b4e4d4   ubuntu:latest   0B (virtual 69.2MB)
1ed31a27944b   nginx:latest    1.09kB (virtual 192MB)
06b17d8c5cfd   nginx:latest    1.09kB (virtual 192MB)</code></pre>
<p>출력 내용에서 알 수 있듯이 컨테이너 자체 용량은 매우 작습니다. 위의 두 컨테이너는 용량을 전혀 사용하지 않고 있고, 아래 nginx 컨테이너는 1.09kB를 사용하고 있습니다. 버추얼로 표시된 용량은 컨테이너에서 사용한 이미지의 용량을 포함한 크기입니다.</p>
<h2 id="no-trunc-풀-컨테이너-id-출력">
<code>--no-trunc</code>: 풀 컨테이너 ID 출력</h2>
<p><code>docker ps</code>에서 보여주는 컨테이너 ID는 전체 ID의 앞부분 일부를 자른 ID입니다. <code>--no-trunc</code> 옵션을 사용하면 ID를 자르지 않고, 전체 ID를 출력합니다.</p>
<pre><code>$ docker ps --no-trunc
CONTAINER ID                                                       IMAGE           COMMAND                                          CREATED          STATUS          PORTS                  NAMES
e1f0107fa6e54f3701657a1bda375869071b919f38e7891b290d4c5cc4e0c553   alpine:latest   "sleep 10000"                                    15 minutes ago   Up 15 minutes                          festive_perlman
232630b4e4d48cc5b90a7b5ead55d59724e88c9875739324cf30785b11a585f0   ubuntu:latest   "sleep 10000"                                    15 minutes ago   Up 15 minutes                          ubuntu
1ed31a27944bac8887e0893dc0dd83d3271827f1cb81219625b92b9407e98062   nginx:latest    "/docker-entrypoint.sh nginx -g 'daemon off;'"   15 minutes ago   Up 15 minutes   0.0.0.0:8081-&gt;80/tcp   nginx-8081
06b17d8c5cfd5520afd20976b92acb3291f933fbc39578add664a8da62e17ef0   nginx:latest    "/docker-entrypoint.sh nginx -g 'daemon off;'"   15 minutes ago   Up 15 minutes   0.0.0.0:8080-&gt;80/tcp   naughty_dubinsky</code></pre>
<p><code>-q</code>와 함께 사용하면 풀 컨테이너 ID만 출력해줍니다.</p>
<pre><code>$ docker ps --no-trunc -q
e1f0107fa6e54f3701657a1bda375869071b919f38e7891b290d4c5cc4e0c553
232630b4e4d48cc5b90a7b5ead55d59724e88c9875739324cf30785b11a585f0
1ed31a27944bac8887e0893dc0dd83d3271827f1cb81219625b92b9407e98062
06b17d8c5cfd5520afd20976b92acb3291f933fbc39578add664a8da62e17ef0</code></pre>
<h2 id="format-커스텀-출력-포맷">
<code>--format</code>: 커스텀 출력 포맷</h2>


<p><code>--format</code> 옵션을 사용하면 Go의 템플릿을 사용해 출력 결과를 커스터마이징할 수 있습니다.</p>
<table>
<thead>
<tr>
<th>플레이스홀더</th>
<th>설명</th>
</tr>
</thead>
<tbody>
<tr>
<td>.ID</td>
<td>컨테이너 ID</td>
</tr>
<tr>
<td>.Image</td>
<td>이미지 ID</td>
</tr>
<tr>
<td>.Command</td>
<td>실행한 명령어</td>
</tr>
<tr>
<td>.CreatedAt</td>
<td>생성 시간</td>
</tr>
<tr>
<td>.RunningFor</td>
<td>실행 시간</td>
</tr>
<tr>
<td>.Ports</td>
<td>포트 정보</td>
</tr>
<tr>
<td>.State</td>
<td>컨테이너 상태 값(created, running, exited 등)</td>
</tr>
<tr>
<td>.Status</td>
<td>컨테이너 상태와 실행 시간</td>
</tr>
<tr>
<td>.Size</td>
<td>컨테이너 크기</td>
</tr>
<tr>
<td>.Names</td>
<td>컨테이너 이름</td>
</tr>
<tr>
<td>.Labels</td>
<td>컨테이너의 모든 Label 정보</td>
</tr>
<tr>
<td>.Label</td>
<td>컨테이너의 특정 Label 값</td>
</tr>
<tr>
<td>.Mounts</td>
<td>컨테이너의 마운트 정보</td>
</tr>
<tr>
<td>.Networks</td>
<td>컨테이너의 네트워크 정보</td>
</tr>
</tbody>
</table>
<p>사용하고 싶은 플레이스홀더 값을 <code>{{PLACEHOLDER}}</code>와 같이 중괄호 2개로 감싸줍니다.</p>
<p>ID, 이름, 상태를 출력하는 예제입니다. 인자가 제대로 해석될 수 있도록 따옴표로 감싸주세요</p>
<pre><code>$ docker ps --format "{{.ID}}({{.Names}}): {{.State}}"
e1f0107fa6e5(festive_perlman): running
232630b4e4d4(ubuntu): running
1ed31a27944b(nginx-8081): running
06b17d8c5cfd(naughty_dubinsky): running</code></pre>
<p>맨 앞에 table 값을 붙이면 테이블 헤더를 출력해줍니다.</p>
<pre><code>$ docker ps --format "table {{.ID}}\t{{.Names}}\t{{.State}}"
CONTAINER ID   NAMES              STATE
e1f0107fa6e5   festive_perlman    running
232630b4e4d4   ubuntu             running
1ed31a27944b   nginx-8081         running
06b17d8c5cfd   naughty_dubinsky   running</code></pre>
<p><code>{{json .}}</code>을 지정하면 컨테이너 정보 전체를 JSON 포맷으로 출력합니다.</p>
<pre><code>$ docker ps --format {{json .}}</code></pre>
<h2 id="filter-컨테이너-목록-필터링">
<code>--filter</code>: 컨테이너 목록 필터링</h2>
<p><code>--format</code>이 출력 형식을 커스텀하는 옵션이라면 <code>--filter</code>는 출력할 컨테이너 대상을 커스텀하는 명령어입니다. 아래는 이 옵션에서 필터링 가능한 컨테이너의 속성값들입니다.</p>
<table>
<thead>
<tr>
<th><strong>필터</strong></th>
<th><strong>설명</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>컨테이너 ID</td>
</tr>
<tr>
<td>name</td>
<td>컨테이너 이름</td>
</tr>
<tr>
<td>label</td>
<td>label. key 혹은 key=value 형식을 지정</td>
</tr>
<tr>
<td>exited</td>
<td>exit code</td>
</tr>
<tr>
<td>status</td>
<td>상태 값:&nbsp;created,&nbsp;restarting,&nbsp;running 등</td>
</tr>
<tr>
<td>ancestor</td>
<td>이미지.</td>
</tr>
<tr>
<td>before</td>
<td>특정 컨테이너 이전에 실행된 컨테이너 목록</td>
</tr>
<tr>
<td>since</td>
<td>특정 컨테이너 이후에 실행된 컨테이너 목록</td>
</tr>
<tr>
<td>volume</td>
<td>볼륨</td>
</tr>
<tr>
<td>network</td>
<td>네트워크</td>
</tr>
<tr>
<td>publish&nbsp;or&nbsp;expose</td>
<td>포트.</td>
</tr>
<tr>
<td>health</td>
<td>컨테이너 헬스체크 상태:&nbsp;starting,&nbsp;healthy,&nbsp;unhealthy&nbsp;or&nbsp;none 중 하나</td>
</tr>
<tr>
<td>isolation</td>
<td>윈도에서만 사용.&nbsp;default,&nbsp;process, or&nbsp;hyperv 중 하나</td>
</tr>
<tr>
<td>is-task</td>
<td>task 여부. true&nbsp;혹은&nbsp;false</td>
</tr>
</tbody>
</table>
<p>먼저 name으로 필터링해보겠습니다.</p>
<pre><code>$ docker ps --filter "name=debian"
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES</code></pre>
<p>아무것도 출력되지 않습니다. 이는 <code>--filter</code> 옵션을 사용하더라도 기본적으로 실행중인 컨테이너만 출력하기 때문입니다. <code>-a</code> 옵션과 같이 사용해보겠습니다.</p>
<pre><code>$ docker ps -a --filter "name=debian"
CONTAINER ID   IMAGE           COMMAND    CREATED          STATUS                      PORTS     NAMES
9b37b52ddaba   debian:latest   "whoami"   41 minutes ago   Exited (0) 41 minutes ago             debian</code></pre>
<p>이번에는 <code>debian</code> 컨테이너가 출력됩니다.</p>
<p><code>ancestor</code>를 사용하면 이미지로 필터링할 수 있습니다. 이 때 이미지는 <code>image:tag</code>, <code>image</code>, <code>image@digest</code>와 같이 지정할 수 있습니다.</p>
<pre><code>$ docker ps --filter "ancestor=nginx:latest"
CONTAINER ID   IMAGE          COMMAND                  CREATED          STATUS          PORTS                  NAMES
1ed31a27944b   nginx:latest   "/docker-entrypoint.…"   44 minutes ago   Up 44 minutes   0.0.0.0:8081-&gt;80/tcp   nginx-8081
06b17d8c5cfd   nginx:latest   "/docker-entrypoint.…"   44 minutes ago   Up 44 minutes   0.0.0.0:8080-&gt;80/tcp   naughty_dubinsky</code></pre>
<p>마지막으로 <code>label</code> 필터링하는 예시입니다.</p>
<pre><code>$ docker ps --filter "label=my.name=alpine"
CONTAINER ID   IMAGE           COMMAND         CREATED          STATUS          PORTS     NAMES
e1f0107fa6e5   alpine:latest   "sleep 10000"   45 minutes ago   Up 45 minutes             festive_perlman</code></pre>
<p><code>label</code>을 사용할 때는 특정 키가 지정된 컨테이너만 필터링하는 것도 가능합니다.</p>
<pre><code>$ docker ps --filter "label=my.name"
CONTAINER ID   IMAGE           COMMAND         CREATED          STATUS          PORTS     NAMES
e1f0107fa6e5   alpine:latest   "sleep 10000"   45 minutes ago   Up 45 minutes             festive_perlman</code></pre>
<h2 id="추천-문서">추천 문서</h2>
<p>docker ps의 더 자세한 사용법에 대해서는 Docker 공식 문서를 참고해주세요.</p>
<ul>
<li><a href="https://docs.docker.com/engine/reference/commandline/ps/#no-trunc">docker ps | Docker Documentation</a></li>
</ul>

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

LZ: 프로그래머 가이드

LainyZine

docker ps는 컨테이너 목록을 출력하는 명령어입니다. 다양한 옵션을 지정해 원하는 컨테이너 목록을 출력하거나, 출력 형식을 변경할 수 있습니다.
전체 기사는 이 링크에서 읽을 수 있습니다.

docker ps 명령어로 컨테이너 목록 출력

댓글