[Docker] 도커 이미지를 tar 파일로 저장 (export / import / save / load)

💡 본 문서는 '도커 이미지를 tar 파일로 저장 (export / import / save / load)'에 대해 정리해놓은 글입니다.
docker build나 commit으로 만들어진 이미지는 일반적으로 docker hub와 같은 registry에 push되고, 이를 다시 pull 받는 방식으로 사용됩니다. 하지만, 간혹 docker 이미지를 registry를 거치지 않고 이동해야 할 때가 있습니다. 또한 Volume 설정을 하지 않고 컨테이너를 종료하면 컨테이너 내의 모든 작업 내역이 유실됩니다. 이럴 때 사용자는 docker 이미지 혹은 컨테이너를 tar파일로 만들 수 있습니다.

1. docker save (docker image -> tar)

docker 이미지를 tar파일로 저장하기 위해서는 docker save 커맨드를 사용합니다.

$ docker save -o xxx.tar [이미지명]

저장할 파일명을 지정하는 옵션은 -o 를 사용합니다.

2. docker load (tar -> docker image)

tar파일로 만들어진 이미지를 다시 docker image로 되돌리기 위해서는 docker load 커맨드를 사용합니다.

$ docker load -i xxx.tar

3. docker export (docker container -> tar)

docker는 이미지 뿐 아니라 container를 tar파일로 저장하는 명령어를 제공합니다.

$ docker export <컨테이너명 or 컨테이너ID> > xxx.tar

4. docker import (tar -> docker image)

export 커맨드를 통해 만들어진 tar 파일을 다시 docker image로 생성하는 명령어입니다.

$ docker import <xxx.tar or URL> [image name[:tag name]]

※ root 권한으로 실행하지 않을 경우, 액세스 권한이 없는 파일들이 포함되지 않는 문제가 발생할 수 있습니다.

+ import한 이미지 실행하기

이미지가 정상적으로 만들어진다면 아래와 같이 이미지를 실행해봅시다.

docker run -dit ubuntu

정상적으로 실행되지 않고 아래와 같이 오류가 발생합니다.

docker: Error response from daemon: No command specified.

그 이유는 우리는 컨테이너의 파일 시스템을 아카이빙 하고 다시 이미지로 만든 것이므로 Docker는 이 이미지의 엔트리포인트가 무엇인지 알지 못합니다. 그래서 우리는 이렇게 만든 이미지를 실행할 때 엔트리 포인트를 직접 지정해주어야 합니다.

아래와 같이 명령어 뒤에 엔트리포인트를 지정하면 정상적으로 컨테이너가 실행됩니다.

docker run -dit ubuntu /bin/bash

결론: export - import 와 save - load의 차이

앞서 얘기했듯, save는 이미지를 export는 컨테이너를 저장한다는 차이점이 있습니다. 그 외에 두 가지의 큰 차이점은 메타 정보도 함께 저장되는지 아닌지에 따라 다르다는 점입니다.

Docker 이미지는 파일의 다른 정도가 레이어로 중첩되어 있는 구조가 되어 있어, save는 레이어의 정보 등도 포함된 상태로 저장합니다. 한편 export는 Docker로써의 구조나 메타 정보가 저장되지 않고, 파일 시스템만 저장됩니다. 즉, tar파일에 컨테이너의 루트 파일시스템 전체가 들어있는 것입니다. 물론, 파일사이즈는 save보다 export쪽이 적습니다.

즉, 기반이 되는 이미지가 같더라도 export와 save는 압축되는 파일 구조와 디렉터리가 다릅니다.

추가로, export를 통해 생성한 tar 파일은 import로, save로 생성한 파일은 load로 이미지화 해야 합니다.

참고

• [Blog] docker image를 tar 파일로 저장 (export / import / save / load): https://www.leafcats.com/240
• [Blog] 실행 중인 Docker 컨테이너를 파일로 저장하고 다시 불러오기: https://xo.dev/articles/export-and-import-docker-container