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


</header>

<p><a href="/ko/article/docker/">Docker</a>에서 실행중인 컨테이너를 종료할 때는 docker stop이나 docker kill 명령어를 사용합니다. 이 글에서는 <a href="/ko/article/linux-container/">컨테이너</a>를 종료하는 방법과 이 두 명령어의 차이에 대해서 알아봅니다.</p>
<nav>
<ul>
<li><a href="#docker-stop%EC%9C%BC%EB%A1%9C-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-%EC%A2%85%EB%A3%8C%ED%95%98%EA%B8%B0">docker stop으로 컨테이너 종료하기</a></li>
<li><a href="#docker-klil%EC%9C%BC%EB%A1%9C-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-%EC%A2%85%EB%A3%8C%ED%95%98%EA%B8%B0">docker klil으로 컨테이너 종료하기</a></li>
<li><a href="#%EC%A0%95%EB%A6%AC-docker-stop%EA%B3%BC-docker-kill%EC%9D%98-%EC%B0%A8%EC%9D%B4%EC%A0%90">정리: docker stop과 docker kill의 차이점</a></li>
<li><a href="#%EC%B6%94%EC%B2%9C-%EB%AC%B8%EC%84%9C">추천 문서</a></li>
</ul>
</nav>
<h2 id="docker-stop으로-컨테이너-종료하기">docker stop으로 컨테이너 종료하기</h2>
<p>다음과 같이 ngnix 컨테이너가 실행중이 상황을 가정해보겠습니다.</p>
<pre><code>$ docker ps
CONTAINER ID   IMAGE           COMMAND                  CREATED             STATUS             PORTS                  NAMES
1ed31a27944b   nginx:latest    "/docker-entrypoint.…"   About an hour ago   Up About an hour   0.0.0.0:8081-&gt;80/tcp   nginx-8081</code></pre>
<p>이 때 컨테이너를 종료하기 위해 <code>docker stop</code> 명령어를 사용할 수 있습니다. ID나 이름을 지정해서 컨테이너를 종료할 수 있습니다. <code>docker stop</code>은 <code>docker container stop</code>과 같습니다.</p>
<pre><code>$ docker stop 1ed31a27944b
$ docker stop nginx-8081
$ docker container stop 1ed31a27944b
$ docker container stop nginx-8081</code></pre>
<p><a href="/ko/article/linux/">리눅스</a>에서 실행중인 프로세스에 특정 시그널을 전달할 수 있습니다. <code>stop</code> 명령어를 사용하면 컨테이너의 프로세스에 SIGTERM 시그널을 전달합니다. SIGTERM은 프로세스를 종료하라는 의미를 가지고 있습니다. 이 때 전달하는 시그널은 Dockerfile의 STOPSIGNAL 지시자나, <code>docker run</code>을 실행할 때 <code>--stop-signal</code>로 지정할 수 있습니다. 기본값은 SIGTERM입니다.</p>
<p>단, 특정 시간이 지나지 않아도 컨테이너가 종료되지 않는다면, 다시 SIGKILL 컨테이너를 전달합니다. SIGKILL은 프로세스를 강제 종료하는 용도로 사용됩니다. 기본값은 10초이며, <code>-t</code> 옵션을 사용해 변경할 수 있습니다.</p>
<pre><code>$ docker stop -t 30 nginx-8081</code></pre>
<p>위 명령어를 실행하면 먼저 nginx-8081 컨테이너에 SIGTERM 시그널을 전달하고, 30초간 종료되지 않으면 SIGKILL 시그널을 보냅니다.</p>
<h2 id="docker-klil으로-컨테이너-종료하기">docker klil으로 컨테이너 종료하기</h2>
<p><code>docker stop</code>이 SIGTERM 시그널로 정상 종료를 시도한다면, <code>docker kill</code>은 실행 즉시 SIGKILL 시그널을 전달해 강제 종료를 시도합니다. <code>docker kill</code>은 <code>docker container kill</code>과 같습니다.</p>
<pre><code>$ docker kill nginx-8081
$ docker container kill nginx-8081</code></pre>
<p>하지만 이름과 달리 <code>kill</code> 명령어가 항상 SIGKILL 시그널을 전달하는 것은 아닙니다. 전달하는 시그널은 <code>-s</code>나 <code>--signal</code> 옵션으로 변경할 수 있습니다. 예를 들어 SIGTERM 시그널을 전달하고자 한다면 다음과 같이 실행합니다.</p>
<pre><code>$ docker kill --signal=SIGTERM nginx-8081</code></pre>
<p>혹은 시그널 값을 <code>SIG</code>를 제외한 문자열이나, 숫자로도 지정할 수 있습니다.</p>
<pre><code>$ docker kill --signal=TERM nginx-8081
$ docker kill --signal=15 nginx-8081</code></pre>
<p>위의 세 명령어는 모두 <code>nginx-8081</code> 컨테이너에 SIGTERM 시그널을 전달합니다.</p>
<p>시그널 처리는 프로그램의 소스 코드에서 커스텀하게 정의할 수 있습니다. 따라서 <code>kill</code> 옵션은 강제 종료가 아닌 특정 시그널을 보내는 용도로 사용할 수도 있습니다.</p>
<h2 id="정리-docker-stop과-docker-kill의-차이점">정리: docker stop과 docker kill의 차이점</h2>
<p>두 명령어는 어떤 시그널을 컨테이너의 프로세스에 전달한다는 공통점을 가지고 있습니다.<code>stop</code>은 먼저 SIGTERM을 보내고 일정 시간이 지나면 SIGKILL을 전달합니다. 반면에 <code>kill</code> 명령어는 기본적으로 SIGKILL을 전달합니다. 따라서 <code>stop</code>이 종료, <code>kill</code>이 강제 종료라고 생각하고 사용해도 무방합니다만, 특정 시그널을 컨테이너 프로세스에 전달하고 싶은 경우에는 <code>kill</code> 명령어에 <code>-s</code> 옵션을 사용할 수 있습니다.</p>
<p>비슷한 또 다른 명령어로는 <code>docker rm -f</code>가 있습니다. 이 명령어는 SIGKILL 시그널을 보내고 컨테이너가 종료되면, 컨테이너를 삭제합니다.</p>
<ul>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/docker-rm-removing-docker-containers/">docker rm 사용법: Docker 컨테이너를 삭제하는 방법</a>
</li>
</ul>
<h2 id="추천-문서">추천 문서</h2>


<p>다음은 리눅스 시그널에 대한 매뉴얼 문서입니다.</p>
<ul>
<li><a href="https://man7.org/linux/man-pages/man7/signal.7.html">signal(7) - Linux manual page</a></li>
</ul>

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

LZ: 프로그래머 가이드

LainyZine

Docker에서는 실행중인 컨테이너를 docker stop이나 docker kill 명령어로 종료할 수 있습니다. 이 글에서는 컨테이너를 종료하는 방법과 두 명령어의 차이에 대해서 소개합니다.
전체 기사는 이 링크에서 읽을 수 있습니다.

컨테이너 종료 명령어: docker stop과 docker kill

댓글