Docker Build & Push 과정 요약 정리

Docker 이미지 빌드와 푸시(push) 과정을 단계별로 설명합니다. 핵심은 빌드 후 푸시 오류를 방지하고, 필요 시 빌드와 푸시를 동시에 실행하는 방법을 익히는 것입니다.

 1. 기본 빌드 명령어

docker buildx build --platform linux/amd64 -t 이미지이름 .

 강의 중에는 직접 입력하지 말고 과정을 관찰만 하세요.

• buildx build : 다중 플랫폼용 빌드 명령어입니다.

• --platform linux/amd64 : 리눅스 환경용으로 이미지 빌드.

• -t : 이미지에 태그를 붙입니다.

 2. 푸시(push) 시 에러가 나는 경우

빌드 후 이미지를 푸시할 때 "이미지가 없습니다" 라는 에러가 날 수 있습니다. 이때는 태그(tag) 를 명시적으로 추가해야 합니다.

docker buildx build --platform linux/amd64 -t 이미지이름:latest .

:latest 태그를 붙이면 푸시 시 정상적으로 동작합니다.

3. 빌드와 푸시를 동시에 실행하기

두 단계를 합쳐 한 번에 처리할 수도 있습니다.

docker buildx build --platform linux/amd64 -t 이미지이름:latest . --push

• --push : 빌드 완료 후 자동으로 Docker Hub(또는 레지스트리)에 푸시.

• 한 번에 처리되어 편리하지만, 학습 목적으로는 나눠서 하는 것이 좋습니다.

✅ 정리

상황명령어설명

일반 빌드docker buildx build -t myapp .로컬 빌드

빌드 시 태그 추가docker buildx build -t myapp:latest .푸시용 태그 지정

빌드 + 푸시 동시 실행docker buildx build -t myapp:latest . --push자동 푸시까지 처리