익스포터 개요
익스포터 개요 (Exporters overview)
--output(또는 -o) CLI 옵션으로 빌드 결과를 다양한 형식으로 내보낼 수 있어요. Buildx가 지원하는 익스포터는 다음과 같아요:
- image: 빌드 결과를 컨테이너 이미지로 내보내요.
- registry: 빌드 결과를 컨테이너 이미지로 만들어 지정한 레지스트리에 push해요.
- local: 빌드 결과의 루트 파일시스템을 로컬 디렉터리로 내보내요.
- tar: 빌드 결과의 루트 파일시스템을 로컬 tarball로 묶어요.
- oci: 빌드 결과를 OCI image layout 형식으로 로컬 파일시스템에 내보내요.
- docker: 빌드 결과를 Docker Image Specification v1.2.0 형식으로 로컬 파일시스템에 내보내요.
- cacheonly: 빌드 출력을 내보내지 않지만 빌드를 실행하고 캐시를 만들어요.
출처: 문서
본문
익스포터 사용하기 (Using exporters)
익스포터를 지정하려면 다음 명령 문법을 사용해요:
$ docker buildx build --tag <registry>/<image> \
--output type=<TYPE> .
--push나 --load 옵션이 익스포터 설정을 추론하게 할 수도 있어요. 예를 들어 --push 플래그는 push=true인 image 익스포터를 사용하고, 결과를 지정한 레지스트리로 push하도록 구성해요. --output 플래그로 익스포터 옵션을 세밀하게 구성할 수도 있어요.
사용 사례 (Use cases)
각 익스포터 유형은 서로 다른 사용 사례를 위해 설계됐어요. 다음 섹션들에서 일반적인 시나리오와 익스포터로 필요한 출력을 만드는 방법을 설명해요.
- 컨테이너 이미지로 배포하거나 레지스트리에 push →
image/registry - 이미지가 아닌 산출물(바이너리 등) 생성 →
local/tar - OCI/Docker 이미지 레이아웃으로 파일시스템에 저장 →
oci/docker - 빌드만 하고 출력은 원하지 않을 때 →
cacheonly