Docker Builder

빌드 cache 정리와 docker build alias 관점에서 이해하기 좋은 docker builder 관리 페이지.

• 현재 Docker에서는 docker build 가 사실상 Buildx/BuildKit 기반으로 동작하는 경우가 많다.
• docker builder build 는 docker build 와 같은 빌드 엔진 alias로 보는 편이 실무적으로 맞다.
• docker builder prune 는 build cache를 정리하는 대표 명령이다.

docker builder COMMAND

• build: 이미지 빌드. 실제 옵션 범위는 docker buildx build 와 거의 겹친다.
  • 주요 옵션: -f, -t, –build-arg, –target, –platform, –pull, –push, –load, –secret, –cache-from, –cache-to
• prune: build cache 정리
  • 주요 옵션: -a, -f, –filter, –max-used-space, –min-free-space, –reserved-space, –verbose

# 빌드
docker builder build -t example/app:latest .
 
# 오래된 build cache 정리
docker builder prune -f

• 빌드 산출물이 로컬 이미지 store에 안 보이면 –load 없이 multi-platform build를 했을 가능성이 있다.
• cache 정리는 빌드 시간을 늘릴 수 있으므로 CI 캐시 전략과 함께 판단한다.

• 새 기능은 대체로 buildx 쪽 문서와 옵션 설명을 기준으로 보는 편이 정확하다.
• docker builder 는 개념적으로는 남아 있지만, 실무 문맥에서는 buildx 노출이 더 많다.

+ docker builder prune --help

Usage:  docker buildx prune
 
Remove build cache
 
Options:
  -a, --all                    Include internal/frontend images
      --builder string         Override the configured builder instance
                               (default "default")
  -D, --debug                  Enable debug logging
      --filter filter          Provide filter values
  -f, --force                  Do not prompt for confirmation
      --max-used-space bytes   Maximum amount of disk space allowed to
                               keep for cache
      --min-free-space bytes   Target amount of free disk space after pruning
      --reserved-space bytes   Amount of disk space always allowed to
                               keep for cache
      --timeout duration       Override the default timeout for loading
                               builder status (default 20s)
      --verbose                Provide a more verbose output

+

• docker
• buildx
• image
• system

• codex:: 2026-07-06 Added docker builder subpage focusing on build alias semantics and cache pruning.