Docker를 운영하다 보면 인터넷이 연결되지 않은 서버에 이미지를 전달하거나, 중요한 이미지를 백업해야 하는 상황이 자주 발생합니다. 또한 운영 서버 이전, 재해 복구, 오프라인 환경 구축 등에서도 Docker 이미지를 파일 형태로 보관하는 작업이 필요합니다.
이럴 때 사용하는 명령어가 바로 docker image save입니다.
Docker Image Save는 Docker 이미지를 TAR 파일로 저장하는 명령어입니다. 저장된 TAR 파일은 다른 서버로 복사하거나 백업 파일로 보관할 수 있으며, 이후 docker image load 명령을 이용해 언제든지 복원할 수 있습니다.
이번 글에서는 Docker Image Save의 개념부터 기본 사용법, 여러 이미지 저장, 백업 전략, 실무 활용 사례까지 자세히 알아보겠습니다.
Docker Image Save란 무엇인가?
Docker Image Save는 로컬 Docker 이미지를 TAR 파일로 저장하는 명령어입니다.
이미지를 하나의 파일로 백업하기 때문에 인터넷이 없는 환경에서도 다른 서버로 쉽게 이동할 수 있습니다.
이미지 백업과 서버 이전 작업에서 자주 사용하는 기능입니다.
Docker Image Save는 언제 사용하는가?
다음과 같은 상황에서 많이 사용됩니다.
- Docker 이미지 백업
- 서버 이전
- 오프라인 환경 구축
- 인터넷이 없는 서버
- 이미지 보관
- 재해 복구(DR)
운영 환경에서는 이미지 백업 용도로 자주 활용됩니다.
Docker Image Save 기본 사용법
가장 기본적인 사용 방법은 다음과 같습니다.
docker image save nginx -o nginx.tar또는 다음과 같이 작성할 수도 있습니다.
docker save nginx -o nginx.tar두 명령은 동일하게 동작합니다.
실행이 완료되면 현재 디렉터리에 nginx.tar 파일이 생성됩니다.
특정 버전 저장
원하는 태그만 저장할 수도 있습니다.
docker image save nginx:1.27 -o nginx-1.27.tar운영 환경에서는 버전별로 백업하는 것이 좋습니다.
여러 이미지 한 번에 저장
여러 이미지를 하나의 파일로 저장할 수도 있습니다.
docker image save nginx ubuntu alpine -o images.tar하나의 TAR 파일 안에 여러 이미지가 함께 저장됩니다.
저장된 파일 확인
생성된 파일을 확인합니다.
ls -lh *.tar출력 예시는 다음과 같습니다.
-rw-r--r-- nginx.tar
-rw-r--r-- images.tar백업 파일이 정상적으로 생성된 것을 확인할 수 있습니다.
압축하여 저장
이미지는 TAR 파일로 저장되므로 gzip으로 압축하면 용량을 줄일 수 있습니다.
docker save nginx | gzip > nginx.tar.gz대용량 이미지를 보관할 때 많이 사용하는 방법입니다.
저장 가능한 이미지
Docker Image Save는 다음과 같은 이미지를 저장할 수 있습니다.
- Docker Hub 이미지
- Private Registry 이미지
- 직접 생성한 이미지
- 여러 버전 이미지
- 여러 Repository 이미지
로컬에 존재하는 모든 Docker 이미지를 저장할 수 있습니다.
Docker Image Save의 특징
Docker Image Save는 다음과 같은 특징을 가지고 있습니다.
- TAR 파일 생성
- 이미지 전체 저장
- 여러 이미지 저장 가능
- 오프라인 전송 가능
- Docker Image Load로 복원 가능
이미지 백업과 서버 이전 작업에 매우 유용한 기능입니다.
Docker Image Save 실무 활용 예제
Docker Image Save는 Docker 이미지를 파일로 저장하여 다른 서버로 이동하거나 백업할 때 사용하는 명령어입니다. 인터넷이 없는 환경이나 폐쇄망 서버 구축, 재해 복구(DR) 환경에서도 매우 자주 활용됩니다.
Nginx 이미지 백업
가장 기본적인 이미지 백업 방법입니다.
docker image save nginx -o nginx.tar현재 디렉터리에 nginx.tar 파일이 생성됩니다.
특정 버전 백업
운영 서버에서 사용하는 버전만 백업하는 예제입니다.
docker image save nginx:1.27 -o nginx-1.27.tar버전별 이미지를 개별적으로 관리할 수 있습니다.
여러 이미지 함께 백업
여러 이미지를 하나의 파일로 저장합니다.
docker image save nginx ubuntu alpine -o backup-images.tar운영 서버 이전 시 자주 사용하는 방법입니다.
압축하여 저장
백업 용량을 줄이려면 gzip과 함께 사용할 수 있습니다.
docker save nginx | gzip > nginx.tar.gz압축 후에는 저장 공간을 더욱 효율적으로 사용할 수 있습니다.
백업 파일 확인
생성된 파일을 확인합니다.
ls -lh *.tar*출력 예시입니다.
-rw-r--r-- nginx.tar
-rw-r--r-- nginx.tar.gz
-rw-r--r-- backup-images.tar백업 파일이 정상적으로 생성되었는지 확인할 수 있습니다.
Linux 서버 문제 해결
인터넷이 연결되지 않은 운영 서버에 Docker 이미지를 배포해야 하는 상황이 발생했습니다.
운영 서버에서는 Docker Hub에 접근할 수 없었기 때문에 이미지를 파일로 백업하기로 했습니다.
먼저 개발 서버에서 이미지를 저장했습니다.
docker image save company/backend:v2.0 -o backend.tar생성된 backend.tar 파일을 SCP를 이용하여 운영 서버로 전송했습니다.
scp backend.tar admin@server:/backup/운영 서버에서는 이후 docker image load 명령으로 이미지를 복원하여 정상적으로 컨테이너를 실행할 수 있었습니다.
인터넷이 없는 환경에서도 문제없이 서비스를 배포할 수 있었습니다.
Docker Image Save 사용 시 주의사항
Docker Image Save를 사용할 때는 다음 사항을 알아두는 것이 좋습니다.
첫 번째는 TAR 파일에는 이미지 전체 Layer가 저장됩니다.
이미지 크기가 클 경우 백업 파일도 상당히 커질 수 있습니다.
두 번째는 여러 이미지를 하나의 파일에 저장할 수 있습니다.
운영 서버 이전 시 매우 편리합니다.
세 번째는 이미지를 저장한다고 컨테이너 정보까지 함께 저장되는 것은 아닙니다.
컨테이너 설정은 별도로 관리해야 합니다.
네 번째는 장기 보관 시 gzip으로 압축하는 것이 저장 공간 절약에 도움이 됩니다.
Best Practice
Docker Image Save를 사용할 때는 다음과 같은 방법을 추천합니다.
- 운영 환경에서는 버전별 이미지를 백업합니다.
- 백업 파일 이름에 버전과 날짜를 함께 기록합니다.
- 장기 보관 시 gzip으로 압축합니다.
- 백업 후 테스트 서버에서 복원 여부를 확인합니다.
- 컨테이너 설정은 Docker Compose 또는 Kubernetes YAML과 함께 보관합니다.
- 중요한 이미지는 정기적으로 백업합니다.
이러한 방법을 적용하면 Docker 이미지를 안전하게 보관하고 장애 발생 시 빠르게 복구할 수 있습니다.
자주 묻는 질문
Docker Image Save와 Docker Export는 무엇이 다른가요?
Docker Image Save는 이미지를 저장합니다.
Docker Export는 실행 중인 컨테이너의 파일 시스템만 저장하며 이미지 정보는 포함하지 않습니다.
여러 이미지를 한 번에 저장할 수 있나요?
가능합니다.
여러 이미지 이름을 함께 입력하면 하나의 TAR 파일로 저장됩니다.
저장한 이미지는 다른 서버에서도 사용할 수 있나요?
네.
docker image load 명령으로 다른 서버에서 동일한 이미지를 복원할 수 있습니다.
압축해서 저장해도 복원할 수 있나요?
가능합니다.
gzip으로 압축한 파일도 압축을 해제하거나 파이프를 이용하여 복원할 수 있습니다.
마무리
Docker Image Save는 Docker 이미지를 TAR 파일로 백업하는 핵심 명령어입니다.
운영 서버 이전, 오프라인 환경 구축, 재해 복구 등 다양한 상황에서 활용되며, Docker Image Load와 함께 사용하면 인터넷 연결 없이도 동일한 이미지를 손쉽게 다른 서버로 이동할 수 있습니다.
운영 환경에서는 버전별 백업과 압축 저장을 함께 활용하면 더욱 안정적이고 효율적인 이미지 관리가 가능합니다.