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


</header>

<p><a href="/ko/article/docker/">Docker</a>에서는 자체적인 이미지 레지스트리 Docker Hub를 함께 서비스하고 있습니다. Docker Hub는 Docker 명령어와 기본적으로 통합되어있으며 별도의 설정 없이도 사용할 수 있습니다. Docker Hub에서 공개 이미지를 다운로드 받을 수 있을뿐만 아니라, 계정이 있다면 직접 만든 이미지를 업로드하는 것도 가능합니다. 이 글에서는 <code>docker push</code> 명령어로 도커 이미지를 업로드하는 방법을 소개합니다.</p>
<nav>
<ul>
<li><a href="#%EC%98%88%EC%A0%9C-%EC%9D%B4%EB%AF%B8%EC%A7%80%EC%99%80-%EC%9D%B4%EB%AF%B8%EC%A7%80-%EC%9D%B4%EB%A6%84">예제 이미지와 이미지 이름</a></li>
<li><a href="#docker-hub%EC%97%90%EC%84%9C-%EC%9D%B4%EB%AF%B8%EC%A7%80-%EC%A0%80%EC%9E%A5%EC%86%8C-%EB%A7%8C%EB%93%A4%EA%B8%B0">Docker Hub에서 이미지 저장소 만들기</a></li>
<li><a href="#docker-push-%EB%AA%85%EB%A0%B9%EC%96%B4%EB%A1%9C-%EC%9D%B4%EB%AF%B8%EC%A7%80-%EC%97%85%EB%A1%9C%EB%93%9C">docker push 명령어로 이미지 업로드</a></li>
<li><a href="#a---all-tags-%EB%AA%A8%EB%93%A0-%ED%83%9C%EA%B7%B8-%EC%97%85%EB%A1%9C%EB%93%9C"><code>-a</code>, <code>--all-tags</code>: 모든 태그 업로드</a></li>
<li><a href="#%EC%B6%94%EC%B2%9C-%EB%AC%B8%EC%84%9C">추천 문서</a></li>
</ul>
</nav>
<h2 id="예제-이미지와-이미지-이름">예제 이미지와 이미지 이름</h2>
<p>여기서는 Docker Hub에 업로드할 간단한 이미지를 만들어보겠습니다. 먼저 다음 내용을 <code>Dockerfile</code>로 저장합니다.</p>
<pre><code>FROM ubuntu:latest
RUN apt update
RUN apt install -y git</code></pre>
<p>Dockerfile이 저장된 디렉터리에서 <code>docker build</code> 명령어로 이미지를 빌드합니다.</p>
<pre><code>$ docker build -t lainyzine/ubuntu:git .</code></pre>
<p><code>-t</code> 옵션에 이미지 이름을 지정할 수 있습니다. 이미지 이름은 <code>lainyzine/tools:git</code>으로 지정했습니다.</p>
<ul>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/how-to-name-a-docker-image/">Docker 이미지에 이름을 지정하는 방법</a>
</li>
</ul>
<p>로컬 환경에서는 이미지 이름을 자유롭게 사용해도 무방합니다만, Docker Hub에 업로드하기 위해서는 다음과 같은 형식에 따라 이름을 지어야합니다.</p>
<pre><code>&lt;USER_ID&gt;/&lt;REPO&gt;:&lt;TAG&gt;</code></pre>
<p><code>USER_ID</code>는 Docker Hub 아이디를 의미합니다. 자신의 아이디나 업로드 권한을 가진 ID를 지정해야합니다. 아직 Docker Hub 계정이 없다면, 지금 하나 만들어주세요.</p>
<ul>
<li>공식 웹사이트: <a href="https://hub.docker.com/">Docker Hub Container Image Library</a>
</li>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/how-to-create-a-docker-hub-account/">Docker Hub 계정 생성하는 방법</a>
</li>
</ul>
<p>다음으로 <code>&lt;REPO&gt;</code>는 이미지 저장소를 의미합니다. 이미지의 이름이라고 생각해도 무방합니다. 하나의 이미지 저장소(이미지 이름)는 <code>&lt;TAG&gt;</code>(태그)로 구분되는 다수의 이미지를 저장할 수 있습니다. 이미지 이름 규칙에 대한 더 상세한 다음 글에서 소개합니다.</p>
<ul>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/docker-image-naming-conventions/">Docker 이미지 이름 규칙</a>
</li>
</ul>
<p>업로드하고자 하는 이미지가 이미 있다면, <code>docker tag</code> 명령어로 Docker Hub 형식에 맞게 이름만 변경해도 무방합니다. 다음 명령어는 로컬의 <code>git:latest</code> 이미지를 Docker Hub의 형식에 맞게 이름을 변경하는 예제입니다.</p>
<pre><code>## git:latest 이미지에 lainyzine/ubunte:git 이름을 추가
$ docker tag git:latest lainyzine/ubuntu:git

## 기존 이미지 이름 삭제
$ docker rmi git:latest</code></pre>
<ul>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/how-to-rename-docker-image-with-docker-tag/">도커 이미지 이름을 변경하는 방법(docker tag)</a>
</li>
</ul>
<p>이미지 저장소는 Docker Hub 웹사이트에서 직접 만들 수 있습니다. 아직 존재하지 않는 이미지 저장소 이름을 지정하면 자동적으로 공개 이미지 저장소가 만들어집니다만, 이렇게 이미지 저장소를 생성하면 기본적으로 이미지가 공개되니 주의가 필요합니다.</p>
<h2 id="docker-hub에서-이미지-저장소-만들기">Docker Hub에서 이미지 저장소 만들기</h2>
<p>먼저 Docker Hub 웹사이트에 접속합니다. 로그인을 하면, 오른쪽 상단에서 Create repository 버튼을 볼 수 있습니다. 이 버튼을 클릭합니다.</p>
<figure>
<img src="https://www.lainyzine.com/ko/article/how-to-upload-docker-images-with-docker-push/assets/image.png" alt="Docker Hub 이미지 저장소 생성">
</figure>
<p>Namespace는 앞에서 <code>&lt;USER_ID&gt;</code>에 해당합니다. Namespace는 기본적으로 로그인한 계정이 됩니다. 이 계정이 다른 조직에 속해 있고 권한이 있다면 다른 Namespace를 선택하는 것도 가능합니다.</p>
<p>다음으로 저장소 이름(Repository Name)을 입력합니다. 여기서는 <code>ubuntu</code>를 입력하겠습니다. Description은 지금은 생략해도 무방합니다.</p>
<p>마지막으로 Visibility를 확인합니다. 기본값은 Public입니다. 즉, 이미지를 업로드하면 누구나 접근 가능하므로 주의가 필요합니다. 무료 플랜에서는 Private 이미지 저장소를 하나만 생성할 수 있습니다.</p>
<figure>
<img src="https://www.lainyzine.com/ko/article/how-to-upload-docker-images-with-docker-push/assets/image%202.png" alt="생성할 이미지 저장소 정보 입력">
</figure>
<p>여기서는 Public으로 지정하겠습니다. 오른쪽 아래의 Create 버튼을 클릭합니다.</p>
<h2 id="docker-push-명령어로-이미지-업로드">docker push 명령어로 이미지 업로드</h2>


<p>도커 허브에 이미지를 업로드 하려면 먼저 <code>docker login</code> 명령어로 로그인을 해야합니다. 다음 명령어로 로그인을 진행합니다. 여기서 <code>-u</code> 옵션의 값은 자신의 아이디로 변경합니다.</p>
<pre><code>$ docker login -u lainyzine</code></pre>
<ul>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/how-to-sign-in-to-docker-from-the-command-line/">docker login 사용법: Docker 로그인하는 방법</a>
</li>
</ul>
<p>이미지는 미리 준비해두었으니 <code>docker push</code> 명령어로 이미지를 업로드하기만 하면 됩니다.</p>
<pre><code>$ docker push lainyzine/ubuntu:git
The push refers to repository [docker.io/lainyzine/ubuntu]
ac2fec2b7693: Pushed
f84de4d1aa57: Pushed
61bbeda53374: Mounted from library/ubuntu
git: digest: sha256:b7793a00424b7a4bb91fc50dfb9b0cb5a69eeae805aca7770bb24b26359696ed size: 953</code></pre>
<p>성공적으로 업로드 되었습니다. 업로드된 이미지는 웹에서도 확인할 수 있습니다.</p>
<ul>
<li><a href="https://hub.docker.com/repository/docker/lainyzine/ubuntu/general">lainyzine/ubuntu general | Docker Hub</a></li>
</ul>
<figure>
<img src="https://www.lainyzine.com/ko/article/how-to-upload-docker-images-with-docker-push/assets/image%203.png" alt="업로드된 도커 이미지 정보">
</figure>
<p>이제 Dokcer Hub에 접근할 수 있다면 어디서나 이 이미지를 다운로드 받을 수 있습니다. 이 이미지를 다운로드 받으로면 <code>docker pull</code> 명령어를 사용합니다.</p>
<pre><code>$ docker pull lainyzine/ubuntu:git</code></pre>
<ul>
<li>관련 글: <a href="https://www.lainyzine.com/ko/article/docker-pull/">docker pull 사용법: 도커 이미지 다운로드</a>
</li>
</ul>

<p><code>docker push</code> 명령어는 많은 옵션을 가지고 있지 않습니다만, 모든 태그를 업로드하는 유용한 옵션이 있습니다. 예를 들어 운영체제 별로 <code>git</code>이 설치된 다음과 같은 이미지들이 있다고 가정해보겠습니다.</p>
<ul>
<li><code>lainyzine/git:ubuntu</code></li>
<li><code>lainyzine/git:debian</code></li>
<li><code>lainyzine/git:centos</code></li>
<li><code>lainyzine/git:alpine</code></li>
</ul>
<p>다음 명령어로 <code>lainyzine/git</code> 이미지의 모든 태그를 한꺼번에 업로드할 수 있습니다. 이 때 태그는 지정하지 않습니다.</p>
<pre><code>$ docker image push --all-tags lainyzine/git</code></pre>
<h2 id="추천-문서">추천 문서</h2>
<p>여기까지 <code>docker push</code> 명령어로 도커 이미지를 업로드하는 방법을 알아보았습니다.</p>
<p>다음은 <code>docker push</code> 명령어의 공식 레퍼런스 문서입니다.</p>
<ul>
<li><a href="https://docs.docker.com/engine/reference/commandline/push/">docker push | Docker Docs</a></li>
</ul>
<p>Docker가 처음이라면 튜토리얼과 함께 차근차근 공부해보시기 바랍니다.</p>
<ul>
<li><a href="https://www.lainyzine.com/ko/article/docker-tutorial/">따라하면서 시작하는 Docker 입문 튜토리얼</a></li>
</ul>

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

LZ: 프로그래머 가이드

LainyZine

Docker Hub에는 직접 빌드한 이미지를 업로드할 수 있습니다. 이 글에서는 docker push 명령어로 이미지를 업로드하는 방법을 소개합니다.
전체 기사는 이 링크에서 읽을 수 있습니다.

docker push로 이미지 업로드하는 방법

댓글