docker buildx history export

docker buildx history export

docker buildx history export는 빌드 기록을 Docker Desktop 번들로 내보내는 명령이에요. .dockerbuild 아카이브 파일 형태로 저장돼요.

출처: 문서

본문

docker buildx history export는 하나 이상의 빌드 기록을 .dockerbuild 아카이브 파일로 내보내요. 이 아카이브에는 메타데이터·로그·빌드 출력이 포함되며, Docker Desktop으로 가져오거나 다른 환경과 공유할 수 있어요.

지원하는 옵션은 다음과 같아요.

옵션 기본값 설명
--all 모든 항목을 보여줘요 (기본은 실행 중만)
--finalize 내보내기 전에 빌드 기록을 마무리해요
-o, --output 파일로 저장해요 (기본은 stdout)

Export all build records to a file (--all)

--all 플래그를 쓰고 출력을 리다이렉트해요.

docker buildx history export --all > all-builds.dockerbuild

또는 --output 플래그를 사용해요.

docker buildx history export --all -o all-builds.dockerbuild

Use a specific builder instance (--builder)

docker buildx history export --builder builder0 ^1 -o builder0-build.dockerbuild

Enable debug logging (--debug)

docker buildx history export --debug qu2gsuo8ejqrwdfii23xkkckt -o debug-build.dockerbuild

Ensure build records are finalized before exporting (--finalize)

클라이언트는 동시에 자신의 trace를 보고할 수 있는데, 내보내기 시점에 모든 trace가 아직 저장되지 않았을 수 있어요. 내보내기 전에 모든 trace가 마무리되도록 하려면 --finalize 플래그를 사용해요.

docker buildx history export --finalize qu2gsuo8ejqrwdfii23xkkckt -o finalized-build.dockerbuild

Export a single build to a custom file (--output)

docker buildx history export qu2gsuo8ejqrwdfii23xkkckt --output mybuild.dockerbuild

빌드 ID는 다음으로 찾을 수 있어요.

docker buildx history ls

두 빌드를 각각 다른 파일로 내보내려면:

# Using build IDs
docker buildx history export qu2gsuo8ejqrwdfii23xkkckt qsiifiuf1ad9pa9qvppc0z1l3 -o multi.dockerbuild

# Or using relative offsets
docker buildx history export ^1 ^2 -o multi.dockerbuild

또는 셸 리다이렉션을 사용해요.

docker buildx history export ^1 > mybuild.dockerbuild
docker buildx history export ^2 > backend-build.dockerbuild

더 알아보기