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


</header>

<p>Docker는 리눅스 컨테이너를 손쉽게 사용할 수 있도록 도와주는 도구입니다. Docker에서 컨테이너를 조작할 때는 컨테이너 ID나 컨터이너 이름을 사용합니다. 의미 있는 이름을 지정하면, Docker를 좀 더 편리하게 사용할 수 있습니다. 이 글에서는 Docker 컨테이너에 이름을 지정하는 방법과 이름을 변경하는 방법을 소개합니다.</p>
<nav>
<ul>
<li><a href="#%EC%9E%90%EB%8F%99-%EC%83%9D%EC%84%B1-%EB%90%98%EB%8A%94-docker-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-%EC%9D%B4%EB%A6%84">자동 생성 되는 Docker 컨테이너 이름</a></li>
<li><a href="#docker-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88%EC%97%90-%EC%9D%B4%EB%A6%84-%EC%A7%80%EC%A0%95%ED%95%98%EB%8A%94-%EB%B0%A9%EB%B2%95">Docker 컨테이너에 이름 지정하는 방법</a></li>
<li><a href="#%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-%EC%9D%B4%EB%A6%84%EC%9D%84-%EB%B3%80%EA%B2%BD%ED%95%98%EB%8A%94-%EB%B0%A9%EB%B2%95">컨테이너 이름을 변경하는 방법</a></li>
<li><a href="#%EC%B6%94%EC%B2%9C-%EB%AC%B8%EC%84%9C">추천 문서</a></li>
</ul>
</nav>
<h2 id="자동-생성-되는-docker-컨테이너-이름">자동 생성 되는 Docker 컨테이너 이름</h2>
<p>Docker 컨테이너는 <code>docker create</code>나 <code>docker run</code> 명령어로 생성할 수 있습니다. <code>run</code> 명령어는 컨테이너를 생성하고 바로 실행합니다. 이름을 지정하지 않으면, Docker가 랜덤한 이름을 붙여줍니다.</p>
<pre><code>$ docker run -d ubuntu:latest sleep 20
$ docker run -d ubuntu:latest sleep 20
$ docker run -d ubuntu:latest sleep 20

$ docker ps
CONTAINER ID   IMAGE           COMMAND                  CREATED          STATUS          PORTS                  NAMES
d8e9fd3aadca   ubuntu:latest   "sleep 20"               4 seconds ago    Up 3 seconds                           epic_moser
68c71462ac3f   ubuntu:latest   "sleep 20"               5 seconds ago    Up 4 seconds                           mystifying_kepler
d771d35fdcbd   ubuntu:latest   "sleep 20"               14 seconds ago   Up 13 seconds                          kind_sutherland</code></pre>
<p><code>epic_moser</code>, <code>mystifying_kepler</code>, <code>kind_sutherland</code>이라는 이름이 붙은 것을 확인할 수 있습니다. 컨테이너 이름은 왼쪽의 형용사와 오른쪽에 위인의 이름을 따서 <code>_</code>으로 연결해서 만들어집니다.</p>
<ul>
<li><a href="https://github.com/docker/docker-ce/blob/master/components/engine/pkg/namesgenerator/names-generator.go">docker-ce/components/engine/pkg/namesgenerator/names-generator.go at master · docker/docker-ce · GitHub</a></li>
</ul>
<p>소스 코드를 보면 조선 시대의 과학자 장영실의 <code>jang</code>도 사용되는 것을 알 수 있습니다. 컨테이너를 만들다 보면 우연히 이 이름을 만났을지도 모릅니다.</p>
<h2 id="docker-컨테이너에-이름-지정하는-방법">Docker 컨테이너에 이름 지정하는 방법</h2>
<p>하지만 랜덤하게 만들어진 이름으로는 컨테이너의 용도나 의미를 알기 어렵습니다. <code>--name</code>을 적극적으로 활용하면 컨테이너를 좀 더 편리하게 사용할 수 있습니다. 예를 들어 8080포트에 정적 페이지를 서빙하는 <code>ngnix</code>를 실행한다면 <code>ngninx-static-8080</code>과 같이 이름 붙일 수 있습니다. 이름을 짓는 어떤 규칙이 있는 것은 아닙니다. 본인이나 팀원이 잘 이해할 수 있는 이름을 사용해주세요.</p>
<pre><code>$ docker run -d -v my-project:/usr/share/nginx/html --name nginx-static-8080 -p 8080:80 nginx:latest
a3c99991349967c501b50fd683842923d8a727dd77cfc3c619025714874</code></pre>
<p>Docker 컨테이너를 조작할 때는, 컨테이너를 생성할 때 출력되는 컨테이너 ID나 이름을 사용할 수 있습니다. 이름을 지정했으니 <code>nginx-static-8080</code>으로 컨테이너를 조작할 수 있습니다. 이 컨테이너를 재시작해보겠습니다.</p>
<pre><code>$ docker restart nginx-static-8080
nginx-static-8080</code></pre>
<p>로그를 볼 때도 이 이름을 사용할 수 있습니다.</p>
<pre><code>$ docker logs nginx-static-8080</code></pre>
<p>컨테이너를 더 이상 사용하지 않을 때도, 이 이름을 지정해 종료할 수 있습니다.</p>
<pre><code>$ docker stop nginx-static-8080
nginx-static-8080</code></pre>
<p>컨테이너의 이름은 고유합니다. 같은 이름의 컨테이너를 만들면 충돌이 나고 컨테이너가 생성되지 않습니다.</p>
<pre><code>$ docker run -d --name nginx-static-8080 nginx:latest
docker: Error response from daemon: Conflict. The container name "/nginx-static-8080" is already in use by container "c1b9bab29bc6733c140c9ddab6e0fe16fb3db6c6a255e8df7be1c75e8b9f8be9". You have to remove (or rename) that container to be able to reuse that name.
See 'docker run --help'.</code></pre>
<p>이 이름을 사용하고 싶다면, 기존 컨테이너를 삭제하거나 컨테이너 이름을 변경해야합니다.</p>
<h2 id="컨테이너-이름을-변경하는-방법">컨테이너 이름을 변경하는 방법</h2>
<p>컨테이너 이름을 바꾸고 싶거나, 컨테이너 생성 시 이름 충돌을 해결하고 싶을 때는 <code>rename</code> 명령어로 기존 컨테이너의 이름을 변경할 수 있습니다. <code>my-database</code> 이름을 붙여 컨테이너를 하나 만들어보겠습니다.</p>
<pre><code>$ docker create --name my-database mysql:8.0
$ docker ps
CONTAINER ID   IMAGE       COMMAND                  CREATED         STATUS    PORTS     NAMES
b02580a241d1   mysql:8.0   "docker-entrypoint.s…"   3 seconds ago   Created             my-database</code></pre>
<p>이 컨테이너를 <code>great-database</code>로 변경해보겠습니다. <code>rename</code> 명령어의 형식은 다음과 같습니다.</p>
<pre><code>docker rename &lt;CONATINER&gt; &lt;NEW_NAME&gt;</code></pre>
<p><code>CONTAINER</code>에는 ID나 이름을 지정해주고, <code>NEW_NAME</code>에는 새로운 이름을 지정합니다.</p>
<pre><code>$ docker rename my-database greate-database
$ docker ps
CONTAINER ID   IMAGE       COMMAND                  CREATED         STATUS    PORTS     NAMES
b02580a241d1   mysql:8.0   "docker-entrypoint.s…"   2 minutes ago   Created             greate-database</code></pre>
<p>정상적으로 이름이 변경된 것을 확인할 수 있습니다. Docker 컨테이너 이름은 <code>docker</code> 명령어를 사용할 때 사용하는 이름이며, 컨테이너 실행중에도 변경할 수 있습니다.</p>
<h2 id="추천-문서">추천 문서</h2>
<p>docker run 명령어에 대한 자세한 해설은 다음 글을 참고해주세요.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/docker-run/">docker run 사용법: 컨테이너 실행</a></li>
</ul>
<p>다음은 도커 컨테이너의 이름을 변경하는 <code>rename</code> 명령어의 공식 문서입니다.</p>
<ul>
<li><a href="https://docs.docker.com/engine/reference/commandline/rename/#examples">docker rename | Docker Documentation</a></li>
</ul>

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

LZ: 프로그래머 가이드

LainyZine

Docker에서는 컨테이너를 조작할 때 컨테이너 ID나 이름을 사용합니다. 컨테이너에는 원하는 이름을 붙이거나 한 번 붙인 이름을 변경할 수 있습니다. 이 글에서는 컨테이너에 이름을 지정하는 방법을 알아봅니다.
전체 기사는 이 링크에서 읽을 수 있습니다.

Docker 컨테이너 이름 지정 및 변경

댓글