{{tag>[docker cli builder buildkit]}}

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

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

===== Usage =====
<code bash>
docker builder COMMAND
</code>

===== Command Groups =====
  * ''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''

===== Examples =====
<code bash>
# 빌드
docker builder build -t example/app:latest .

# 오래된 build cache 정리
docker builder prune -f
</code>

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

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

===== Help =====
+++ docker builder prune --help |
<code text>
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
</code>
+++

===== See Also =====
  * [[docker:ko]]
  * [[docker:buildx]]
  * [[docker:image]]
  * [[docker:system]]

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