Docker 이미지를 빌드하면 기본적으로 다양한 진행 정보가 터미널에 출력됩니다.
예:
[+] Building 20.5s
=> [internal] load build definition
=> [1/5] FROM ubuntu
=> RUN npm install
=> exporting layers이러한 정보는 개발자가 빌드 과정을 확인할 때 유용합니다.
하지만 자동화 환경에서는 불필요한 로그가 많아질 수 있습니다.
예:
- CI/CD 로그 용량 증가
- 자동화 스크립트 출력 복잡
- 필요한 결과만 확인 필요
- 배포 로그 간소화
이때 사용하는 옵션이 바로 **--quiet**입니다.
docker buildx build --quiet는 Docker 이미지 빌드 과정의 상세 출력을 숨기고 최종 결과만 표시하는 옵션입니다.
예:
docker buildx build \
--quiet \
-t app:v1 .이번 글에서는 Docker Buildx Build –quiet의 개념부터 기본 사용법, –progress와 차이점, 자동화 환경 활용 방법까지 자세히 알아보겠습니다.
Docker Buildx Build –quiet란 무엇인가?
--quiet는 Docker Buildx 빌드 과정의 출력 내용을 최소화하는 옵션입니다.
기본 형식:
docker buildx build \
--quiet .동작:
Docker Build 실행
↓
빌드 진행 로그 숨김
↓
최종 결과 출력필요한 정보만 확인할 수 있습니다.
Docker Buildx Build –quiet이 필요한 이유
기본 빌드에서는 많은 로그가 출력됩니다.
예:
Step 1/10
Step 2/10
Installing package
Downloading files자동화 환경에서는 이러한 로그가 오히려 방해가 될 수 있습니다.
--quiet 사용:
sha256:xxxxxx최종 결과 중심으로 확인할 수 있습니다.
Docker Buildx Build –quiet 기본 사용법
예:
docker buildx build \
--quiet \
-t app:v1 .빌드 과정은 표시하지 않고 결과만 출력합니다.
Docker Buildx Build –quiet과 –progress 차이
두 옵션은 출력 제어 기능이지만 목적이 다릅니다.
–progress
출력 형식 변경:
docker buildx build \
--progress plain .용도:
- 로그 확인
- 오류 분석
- CI 기록
–quiet
출력 최소화:
docker buildx build \
--quiet .용도:
- 결과만 확인
- 자동화 출력 감소
정리:
--progress = 어떻게 보여줄 것인가
--quiet = 얼마나 보여줄 것인가Docker Buildx Build –quiet 실무 활용 예제
자동 배포 스크립트
기본:
docker buildx build \
-t app:v1 .출력:
Build Step
Package Install
Layer 생성
완료자동화에서는 불필요할 수 있습니다.
변경:
IMAGE=$(docker buildx build \
--quiet \
-t app:v1 .)결과:
sha256:abcdef스크립트에서 바로 사용할 수 있습니다.
CI/CD 로그 최적화
CI 환경:
docker buildx build \
--quiet \
-t company/app:${VERSION} \
--push .장점:
- 로그 크기 감소
- 결과 확인 쉬움
- 자동 처리 편리
Docker Buildx Build –quiet과 이미지 ID 활용
예:
IMAGE_ID=$(docker buildx build \
--quiet \
-t app:v1 .)변수 저장:
IMAGE_ID
↓
sha256:xxxx다음 단계에서 사용할 수 있습니다.
Linux 서버 문제 해결
배포 자동화 서버에서 Docker 빌드 로그가 너무 많았습니다.
기존:
docker buildx build \
-t app:v1 .문제:
CI 로그 용량 증가해결:
docker buildx build \
--quiet \
-t app:v1 .결과:
sha256:image-id필요한 결과만 받아 자동화 처리가 쉬워졌습니다.
Docker Buildx Build –quiet 사용 시 주의사항
첫 번째는 오류 원인 확인이 어려울 수 있습니다.
두 번째는 개발 중에는 상세 로그가 필요한 경우가 많습니다.
세 번째는 문제 발생 시 --progress plain으로 변경하는 것이 좋습니다.
네 번째는 운영 자동화 환경에서 주로 활용하는 것이 적합합니다.
Best Practice
Docker Buildx Build –quiet 활용 방법:
- 자동화 스크립트에서 활용
- CI 로그 최소화
- 결과 값 저장 목적 사용
- 개발 환경에서는 신중하게 사용
- 오류 분석 시 상세 로그 활성화
- –progress plain과 상황별 구분 사용
자주 묻는 질문
Docker Buildx Build –quiet은 무엇인가요?
Docker 빌드 과정의 상세 출력을 숨기는 옵션입니다.
–quiet을 사용하면 빌드가 빨라지나요?
아닙니다.
출력만 줄이며 실제 빌드 속도에는 큰 영향을 주지 않습니다.
오류 확인이 가능한가요?
가능하지만 상세 원인 확인은 어렵기 때문에 필요하면 --progress plain을 사용하는 것이 좋습니다.
CI/CD에서 사용할 수 있나요?
가능합니다.
특히 결과 값만 필요한 자동화 환경에서 유용합니다.
마무리
Docker Buildx Build –quiet은 Docker 이미지 빌드 과정의 불필요한 출력을 줄이고 필요한 결과만 확인하기 위한 옵션입니다.
개발 환경에서는 상세 로그가 중요하지만, CI/CD 자동화 환경에서는 로그 관리와 결과 처리 효율성이 더 중요할 수 있습니다.
따라서 상황에 따라 --quiet, --progress plain을 구분하여 사용하면 더욱 효율적인 Docker 빌드 환경을 구성할 수 있습니다.