기본 패턴
bash
docker build -t myname/my-app:1.0.0 .
docker push myname/my-app:1.0.0설명
- 이미지 태그는 사람이 읽는 버전 라벨이면서, 동시에 어느 레지스트리에 어떤 이름으로 배포할지를 정하는 식별자입니다.
repository:tag형태가 기본이며, 태그를 생략하면latest가 기본값으로 붙습니다.- 하지만
latest는 최신 안정 버전이라는 보장이 없으므로, 실제 운영에선 명시적 버전 태그를 붙이는 편이 좋습니다. docker push는 태그 기준으로 레지스트리에 업로드하므로, 태그 설계가 곧 배포 전략과 연결됩니다.- 일반적으로는
1.0.0,2026-03-19,commit-sha같은 재현 가능한 태그가latest보다 안전합니다.
짧은 예제
bash
docker build -t myteam/api:2026-03-19 .
docker image tag myteam/api:2026-03-19 myteam/api:latest
docker push myteam/api:2026-03-19
docker push myteam/api:latest빠른 정리
| 요소 | 의미 |
|---|---|
myteam/api | 이미지 저장소 이름 |
:1.0.0 | 버전 또는 변형 태그 |
docker build -t | 빌드하면서 이름과 태그 지정 |
docker image tag | 기존 이미지에 다른 태그 추가 |
docker push | 태그 기준으로 레지스트리에 업로드 |
주의할 점
latest만 믿으면 어떤 이미지가 배포됐는지 추적하기 어렵습니다. 운영 환경이나 팀 협업에서는
항상 재현 가능한 태그를 하나 이상 같이 남기는 편이 좋습니다.
참고 링크
2 sources