Docker 이미지를 빌드하면 생성된 이미지를 구분하기 위한 이름과 버전 정보가 필요합니다.
Docker에서는 이미지 이름과 버전을 관리하기 위해 Tag(태그) 개념을 사용합니다.
예:
nginx:latest
my-app:v1.0
company/backend:2026여기서:
nginx→ 이미지 이름latest→ Tag
입니다.
Docker Buildx Build에서는 --tag 옵션을 사용하여 생성할 이미지 이름과 Tag를 지정할 수 있습니다.
예:
docker buildx build \
--tag my-app:v1 .빌드된 이미지를 원하는 이름으로 관리할 수 있습니다.
이번 글에서는 Docker Buildx Build –tag의 개념부터 이미지 이름 구조, Tag 관리 방법, Registry Push 활용, 운영 환경 Best Practice까지 자세히 알아보겠습니다.
Docker Buildx Build –tag란 무엇인가?
--tag는 Docker 이미지 이름과 Tag를 지정하는 옵션입니다.
기본 형식:
docker buildx build \
--tag 이미지이름:태그 .또는 짧은 형태:
-t 이미지이름:태그두 방식은 동일합니다.
Docker 이미지 Tag 구조 이해하기
Docker 이미지 이름은 일반적으로 다음 구조입니다.
Registry / Repository : Tag예:
docker.io/company/app:v1.0구성:
docker.io
↓
company/app
↓
v1.0각 부분은 이미지를 구분하는 역할을 합니다.
Docker Buildx Build –tag 기본 사용법
예:
docker buildx build \
--tag app:v1 .생성 이미지:
app:v1확인:
docker images이미지 이름과 Tag를 확인할 수 있습니다.
Docker Buildx Build -t와 –tag 차이
두 옵션은 같은 기능입니다.
긴 형식:
docker buildx build \
--tag app:v1 .짧은 형식:
docker buildx build \
-t app:v1 .실무에서는 짧은 -t 옵션을 많이 사용합니다.
Docker Tag 이름 작성 규칙
일반적인 형식:
이름:버전예:
web:v1
api:2.0
backend:latest권장 Tag:
app:1.0.0
app:2026.07.28
app-production:v1버전 정보를 포함하면 관리가 쉬워집니다.
Docker Buildx Build –tag와 Registry Push
Registry에 Push하려면 Tag에 Registry 주소를 포함합니다.
예:
docker buildx build \
--tag registry.example.com/app:v1 \
--push .저장 위치:
registry.example.com/app:v1Docker Hub:
docker buildx build \
--tag username/app:v1 \
--push .형태로 사용합니다.
여러 개의 Tag 지정하기
하나의 이미지에 여러 Tag를 지정할 수 있습니다.
예:
docker buildx build \
-t app:v1 \
-t app:latest .결과:
app:v1
app:latest두 개의 이름으로 관리할 수 있습니다.
Docker Buildx Build –tag 실무 활용 예제
버전별 이미지 관리
빌드:
docker buildx build \
--tag company/app:1.0.0 \
--push .결과:
company/app:1.0.0특정 버전으로 배포할 수 있습니다.
개발·운영 환경 Tag 분리
개발:
docker buildx build \
-t app:dev .운영:
docker buildx build \
-t app:prod .환경별 이미지를 구분할 수 있습니다.
CI/CD Tag 자동 생성
CI 환경:
docker buildx build \
-t company/app:${VERSION} \
--push .예:
company/app:2026.07.28자동 버전 관리가 가능합니다.
Linux 서버 문제 해결
운영 서버에서 이미지 업데이트를 진행했습니다.
기존:
docker buildx build .문제:
이미지 이름 확인 어려움
버전 관리 불가Tag 추가:
docker buildx build \
-t company/app:v2.0 .확인:
docker images결과:
company/app
v2.0명확한 이미지 관리가 가능해졌습니다.
Docker Buildx Build –tag 사용 시 주의사항
첫 번째는 latest Tag만 사용하는 것을 피하는 것이 좋습니다.
두 번째는 운영 환경에서는 버전 Tag 사용을 권장합니다.
세 번째는 Registry Push 전 이미지 이름을 확인해야 합니다.
네 번째는 Tag 변경은 새로운 이미지 생성이 아니라 이름 지정 방식입니다.
Best Practice
Docker Buildx Build –tag 활용 방법:
- 의미 있는 Tag 사용
- 버전 번호 포함
- 개발·운영 Tag 분리
- CI/CD 자동 Tag 생성
- Registry 규칙 통일
- latest 단독 사용 피하기
자주 묻는 질문
Docker Buildx Build –tag는 무엇인가요?
생성할 Docker 이미지 이름과 Tag를 지정하는 옵션입니다.
-t와 –tag 차이는 무엇인가요?
기능은 동일하며 표기 방식만 다릅니다.
하나의 이미지에 여러 Tag를 사용할 수 있나요?
가능합니다.
여러 개의 -t 옵션을 사용할 수 있습니다.
latest Tag를 사용해도 되나요?
가능하지만 운영 환경에서는 버전 Tag를 함께 사용하는 것이 좋습니다.
마무리
Docker Buildx Build –tag는 Docker 이미지 관리를 위한 가장 기본적이면서 중요한 옵션입니다.
이미지 이름과 버전을 명확하게 지정하면 개발 환경부터 운영 배포, CI/CD 자동화까지 안정적으로 관리할 수 있습니다.
특히 Kubernetes와 같은 운영 환경에서는 명확한 Tag 전략이 중요하며, 버전 기반 이미지 관리를 통해 롤백과 배포 추적을 쉽게 구성할 수 있습니다.