<div id="readability-page-1" class="page"><div>
<article>
<header>
<h2>
  <a href="https://www.lainyzine.com/ko/article/how-to-automatically-restart-docker-containers/">
    도커 컨테이너 자동으로 재시작하는 방법
  </a>
</h2>

</header>

<p><a href="/ko/article/docker/">도커</a> 컨테이너는 <a href="/ko/article/linux-container/">리눅스 컨테이너</a> 기능들을 사용해, 특정 프로세스를 격리된 환경에서 실행해줍니다. 도커 컨테이너는 리눅스 프로세스로서 동작하며, 실행되고 작업을 마치면 종료됩니다. 서버 애플리케이션의 경우, 프로세스가 실행된 상태에서 특정한 요청을 받고 응답을 반환합니다. 도커에서는 컨테이너가 의도치 않게 종료되었을 때, 컨테이너를 자동으로 재시작하는 기능을 제공하고 있습니다.</p>
<p>이 글에서는 도커 컨테이너를 자동으로 재시작하는 방법들에 대해서 소개합니다.</p>
<nav>
<ul>
<li><a href="#docker-run%EA%B3%BC-restart-%EC%98%B5%EC%85%98">docker run과 restart 옵션</a></li>
<li><a href="#%EB%B9%84%EC%A0%95%EC%83%81-%EC%A2%85%EB%A3%8C-%EC%8B%9C-n%EB%B2%88-%EC%9E%AC%EC%8B%9C%EC%9E%91-%EC%8B%9C%EB%8F%84-on-failuren">비정상 종료 시 n번 재시작 시도: <code>on-failure:n</code></a></li>
<li><a href="#%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-%EC%A2%85%EB%A3%8C%EC%8B%9C-%EB%AC%B4%EC%A1%B0%EA%B1%B4-%EC%9E%AC%EC%8B%9C%EC%9E%91-always">컨테이너 종료시 무조건 재시작: <code>always</code></a></li>
<li><a href="#docker-compose%EC%97%90%EC%84%9C-%EC%9E%AC%EC%8B%9C%EC%9E%91-%EC%A0%95%EC%B1%85-%EC%A0%81%EC%9A%A9%ED%95%98%EA%B8%B0">Docker Compose에서 재시작 정책 적용하기</a></li>
</ul>
</nav>
<h2 id="docker-run과-restart-옵션">docker run과 restart 옵션</h2>
<p>도커 컨테이너는 기본적으로 컨테이너가 종료되더라도 재시작을 하지 않습니다. 하지만 docker run 명령어의 restart 옵션을 지정해서, 재시작 정책을 명시적으로 지정할 수 있습니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/docker-run/">docker run 사용법: 컨테이너 생성 및 실행</a></li>
</ul>
<p><code>restart</code> 옵션에 지정할 수 있는 옵션은 다음과 같습니다.</p>
<ul>
<li>
<code>no</code>: 컨테이너 종료 시 재시작을 하지 않습니다. 기본값입니다.</li>
<li>
<code>on-failure:n</code>: exit 코드가 0이 아닌 경우 n번 재시작을 시도합니다. 여기서 n은 숫자로 지정합니다.</li>
<li>
<code>unless-stopeped</code>: 명시적으로 중지했거나, Docker가 중지/재시작 되는 경우가 아니라면 컨테이너를 재시작합니다.</li>
<li>
<code>always</code>: exit 코드에 상관없이 항상 재시작합니다.</li>
</ul>
<p>기본값은 <code>no</code>입니다. 여기서는 자주 사용하는 <code>on-failure</code>와 <code>always</code> 옵션에 대해서 좀 더 자세히 알아보겠습니다.</p>
<h2 id="비정상-종료-시-n번-재시작-시도-on-failuren">비정상 종료 시 n번 재시작 시도: <code>on-failure:n</code>
</h2>
<p><code>on-failure:n</code>은 컨테이너(프로세스)가 비정상 종료할 경우 n번 재시작을 시도하는 재시작 정책입니다. 여기서 <code>n</code>은 재시도하기 원하는 숫자를 지정합니다.</p>
<p>이 때 컨테이너의 비정상 종료란, 프로세스가 0이 아닌 exit 코드로 종료한 경우를 말합니다. exit 코드 0은 프로세스가 정상적으로 작업을 마치고 종료했다는 의미를 가지고 있습니다. 반면에 0이 아닌 모든 값은 비정상적인 종료를 의미합니다. 이 정책에서는 비정상적으로 컨테이너가 종료된 경우에만 컨테이너를 재시작합니다.</p>
<pre><code>$ docker run -d --restart on-failure:10 batch_job:latest</code></pre>
<p>이 정책은 배치 작업을 수행하는 컨테이너를 실행할 때 유용합니다. 즉, 배치 작업을 실행하다가 프로세스가 비정상적으로 종료하는 경우 3번 재시작을 시도합니다. 반드시 10번 재시작하지 않고, 2번째에서 정상적으로 작업을 수행하고 exit 코드 0으로 종료한다면 재시작을 하지 않습니다.</p>
<h2 id="컨테이너-종료시-무조건-재시작-always">컨테이너 종료시 무조건 재시작: <code>always</code>
</h2>
<p><code>on-failure</code>가 배치 잡을 실행할 때 유용하다면, <code>always</code> 옵션은 서버 컨테이너를 실행할 때 유용합니다. 서버 컨테이너는 특별한 이유가 없다면 계속 실행된 채로 요청을 받고 응답을 해야합니다. 따라서 어떤 이유로든 서버 컨테이너가 종료된다면 재시작을 하는 것이 좋습니다.</p>
<pre><code>$ docker run -d -p 8080:80 --restart alawys nginx:latest</code></pre>
<p>단, 이 옵션이 서버 컨테이너의 정상적인 실행을 보장하는 것은 아닙니다. 따라서 서버가 실행되지 못 하는 특별한 원인이 있다면, 무한 재시작에 빠질 수도 있습니다.</p>
<h2 id="docker-compose에서-재시작-정책-적용하기">Docker Compose에서 재시작 정책 적용하기</h2>


<p>Docker Compose는 여러 컨테이너를 정의하고 한꺼번에 관리할 때 유용합니다. 다음은 Docker Compose에서 특정 컨테이너를 항상 재시작하는 예제입니다.</p>
<pre><code>version: '3'
services:
  nginx:
    image: nginx:latest
    restart: always
    ports:
      - "3000:80"</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

도커로 컨테이너를 실행할 때 종료 시 재시작 정책을 설정할 수 있습니다. 이 글에서는 도커 컨테이너를 자동으로 재시작하는 방법에 대해서 소개합니다.
전체 기사는 이 링크에서 읽을 수 있습니다.

도커 컨테이너 자동으로 재시작하는 방법

댓글