Docker Hub에 이미지 푸시하기

공식 문서

Docker Hub 가이드

Docker Hub에 이미지 올리기

1단계: Docker Hub에 로그인

터미널에서 아래 명령어를 실행하고 Docker Hub 계정 인증을 진행합니다.

docker login

터미널 실행 결과 예시

$ docker login
Authenticating with existing credentials...
 
Info → To login with a different account, run 'docker logout' followed by 'docker login'
 
Username: myusername
Password: ••••••••••
 
Login Succeeded

2단계: 이미지 태그 추가

로컬에 있는 이미지에 Docker Hub 리포지토리명과 태그를 붙여줍니다.

docker tag <로컬이미지명:태그> <Docker_Hub_ID>/<이미지명>:<태그>
 
# 예시
docker tag nowinseoul:v1.0.0 myusername/nowinseoul:v1.0.0

Docker Hub ID 확인 방법

• https://hub.docker.com/repositories 접속
• 오른쪽 상단 프로필 아이콘 → 드롭다운 메뉴에서 사용자 이름 확인
• 또는 https://hub.docker.com/repositories/myusername

3단계: 이미지 푸시 (업로드)

태그를 붙인 이미지를 Docker Hub에 푸시합니다.

docker push <Docker_Hub_ID>/<이미지명>:<태그>
 
# 예시
docker push myusername/nowinseoul:v1.0.0

터미널 실행 결과 예시

$ docker push myusername/nowinseoul:v1.0.0
The push refers to repository [docker.io/myusername/nowinseoul]
abc1234def56: Pushing  15.11MB/63.39MB
fed7890abc12: Pushed
cba3456def78: Pushed
efg9012abc34: Pushing  34.19MB/63.38MB
ghi5678def90: Pushing  36.06MB/409.8MB
jkl2345ghi67: Pushed
mno8901jkl23: Pushed
pqr4567mno89: Mounted from library/python
v1.0.0: digest: sha256:a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1
size: 2626

4단계: Docker Hub 웹사이트에서 확인

Docker Hub에 로그인 후 Repositories에서 정상 업로드 여부를 확인할 수 있습니다.

경로: https://hub.docker.com/repositories/myusername

---

Docker Hub에서 이미지 다운받기

1단계: 이미지 검색 (선택사항)

Docker Hub에서 원하는 이미지를 이름으로 검색할 수 있습니다.

docker search <이미지명>
 
# 예시
docker search nowinseoul

터미널 실행 결과 예시

$ docker search nowinseoul
NAME                 DESCRIPTION   STARS     OFFICIAL
myusername/nowinseoul               0

2단계: 이미지 다운로드

Docker Hub에 등록된 이미지를 로컬로 가져올 때는 다음 명령어를 사용합니다.

docker pull <Docker_Hub_ID>/<이미지명>:<태그>
 
# 예시
docker pull myusername/nowinseoul:v1.0.0

터미널 실행 결과 예시

$ docker pull myusername/nowinseoul:v1.0.0
v1.0.0: Pulling from myusername/nowinseoul
9a6263cdeaa5: Pull complete
154984c62312: Pull complete
72eefd466169: Pull complete
099d892ea0b1: Pull complete
eef255fb6b3e: Pull complete
455a3172108c: Pull complete
32748a8b4cbb: Extracting [=================================>  ] 78.54MB/116.9MB
0cd18e947c59: Download complete
6e3a9214858e: Download complete
779bb3e44290: Download complete
11c756d64020: Download complete
 
Status: Downloaded newer image for myusername/nowinseoul:v1.0.0

3단계: 다운로드된 이미지 확인

docker images

출력 예시

REPOSITORY                  TAG              IMAGE ID       CREATED        SIZE
myusername/nowinseoul       v1.0.0    abc1234def56   2 hours ago    450MB
nowinseoul                  latest           xyz9876uvw54   1 day ago      450MB
python                      3.13-slim        fed5678abc90   1 week ago     125MB

---

이미지 테그 관리 전략

버전 태깅의 중요성

같은 이미지에 여러 태그를 붙여서 버전을 관리합니다:

# 빌드한 이미지
docker tag nowinseoul:v1.0.0 myusername/nowinseoul:v1.0.0
 
# 최신 버전도 함께 태깅
docker tag nowinseoul:v1.0.0 myusername/nowinseoul:latest
 
# 푸시
docker push myusername/nowinseoul:v1.0.0
docker push myusername/nowinseoul:latest

태그 네이밍 규칙

권장 패턴

1. 날짜 기반: v1.0.0 (연_월_일_시)
2. 의미 있는 버전: v1.0, v1.0.1, v2.0
3. 최신 버전: latest (항상 최신 빌드 가리킴)

예시

# 날짜 기반
docker tag my-app:local myusername/my-app:2025_03_30_14
 
# 의미 있는 버전
docker tag my-app:local myusername/my-app:v1.2.3
 
# 최신
docker tag my-app:local myusername/my-app:latest
 
# 모두 같은 이미지를 가리킴
docker push myusername/my-app:2025_03_30_14
docker push myusername/my-app:v1.2.3
docker push myusername/my-app:latest

---

주요 명령어 요약

명령어	설명
docker login	Docker Hub에 로그인
docker logout	Docker Hub에서 로그아웃
docker tag 로컬이미지 리포지토리/이미지	이미지에 태그 추가
docker push 리포지토리/이미지	이미지를 Docker Hub에 올리기
docker pull 리포지토리/이미지	Docker Hub에서 이미지 다운로드
docker search 이미지명	Docker Hub에서 이미지 검색

---

참고 링크

• Docker 빌드 및 실행하기
• Docker 명령어 레퍼런스
• nowinseoul - 이 튜토리얼의 실제 적용 프로젝트