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