도커 볼륨(Volume) 복사, ‘왜’ 그렇게 해야 할까?

가장 흔한 시나리오입니다. 운영 중인 db_data 볼륨을 테스트용 db_data_test 볼륨으로 복제하고 싶을 수 있습니다.

🤔 WHY: 왜 임시 컨테이너를 사용할까?

도커 볼륨은 호스트 파일 시스템 어딘가( /var/lib/docker/volumes/... 등)에 저장되지만, 도커 데몬이 이 경로를 관리합니다. 이 경로에 직접 접근해 cp 명령어를 사용하는 것은 권장되지 않으며, 권한 문제나 데이터 일관성 문제를 일으킬 수 있습니다.

대신, 우리는 두 개의 볼륨을 동시에 마운트한 임시 컨테이..너를 실행합니다.

1. 컨테이너가 /from 경로에 원본 볼륨(source_volume)을 마운트합니다.

2. 컨테이너가 /to 경로에 대상 볼륨(new_volume)을 마운트합니다.

3. 컨테이너는 실행되자마자 /from의 모든 데이터를 /to로 복사하는 간단한 리눅스 명령어(cp 또는 tar)를 실행합니다.

4. 명령이 끝나면 컨테이너는 자동으로 파기됩니다(--rm 옵션).

이 컨테이너는 오직 데이터 복사만을 위한 '도구'로 사용됩니다.

🚀 HOW: 명령어 예제

source_data 볼륨의 데이터를 target_data 볼륨으로 복사하는 예제입니다.

1. 테스트용 볼륨 생성 (선택 사항)

docker volume create source_data
docker volume create target_data
# (source_data에 데이터가 있다고 가정합니다.)

1. 임시 컨테이너를 이용한 복사

docker run --rm \
       -v source_data:/from \
       -v target_data:/to \
       alpine \
       sh -c "cp -a /from/. /to/"

💡 명령어 해설

• docker run --rm: --rm 플래그는 컨테이너가 작업을 완료하고 종료될 때 즉시 컨테이너를 삭제하라는 의미입니다. 임시 작업에 필수입니다.

• -v source_data:/from: source_data 볼륨을 컨테이너 내부의 /from 디렉터리에 마운트합니다.

• -v target_data:/to: target_data 볼륨을 컨테이너 내부의 /to 디렉터리에 마운트합니다.

• alpine: cp나 sh 같은 기본 유틸리티를 포함하면서도 용량이 매우 작은 alpine 리눅스 이미지를 사용합니다.

• sh -c "...": alpine 컨테이너가 실행될 때 내릴 명령어입니다.

• cp -a /from/. /to/:

  • -a (archive): 이 플래그가 핵심입니다. 단순 복사(cp -r)가 아니라 소유권, 권한, 타임스탬프 등 모든 속성을 보존하며 복사합니다. 데이터베이스 파일 등 민감한 데이터를 다룰 때 매우 중요합니다.

  • /from/.: /from 디렉터리가 아닌, /from 내부의 모든 콘텐츠 (숨겨진 파일 포함)를 의미합니다.

2. 볼륨 데이터를 호스트 파일 시스템으로 복사하기 (백업)

볼륨의 데이터를 내 로컬 머신이나 서버의 특정 디렉터리에 .tar 파일 등으로 백업하고 싶을 때 사용합니다.

🤔 WHY: 어떻게 작동하는가?

원리는 1번과 동일합니다. 다만, 대상이 '도커 볼륨'이 아니라 '호스트 디렉터리'로 바뀌었을 뿐입니다.

도커는 호스트의 특정 디렉터리를 컨테이너에 마운트하는 바인드 마운트(Bind Mount) 기능을 지원합니다.

1. 컨테이너가 /data 경로에 원본 볼륨(source_volume)을 마운트합니다.

2. 컨테이너가 /backup 경로에 호스트의 특정 디렉터리($(pwd)/backup)를 마운트합니다.

3. 컨테이너는 /data의 내용을 /backup 디렉터리로 복사(또는 압축)합니다.

4. 이 작업은 컨테이너 안에서 일어났지만, /backup은 실제 호스트 디렉터리와 연결되어 있으므로 결과물은 호스트에 남게 됩니다.

🚀 HOW: 명령어 예제

source_data 볼륨의 데이터를 현재 위치($(pwd))의 backup 디렉터리로 복사합니다.

# 호스트에 백업받을 디렉터리 생성
mkdir -p $(pwd)/backup

docker run --rm \
       -v source_data:/data:ro \
       -v $(pwd)/backup:/backup \
       alpine \
       cp -a /data/. /backup/

💡 명령어 해설

• -v source_data:/data:ro: :ro (Read-Only) 플래그를 추가했습니다. 백업은 데이터를 읽기만 하면 되므로, 실수로 원본 볼륨을 수정하는 것을 방지하기 위해 읽기 전용으로 마운트하는 것이 좋습니다.

• -v $(pwd)/backup:/backup: source_data (볼륨 이름)와 달리, /로 시작하거나 $(pwd)(현재 경로)를 포함한 절대/상대 경로는 호스트의 디렉터리를 의미합니다.

3. 핵심 복사 팁 (Tips)

docker run --rm \
       -v source_data:/from \
       -v target_data:/to \
       alpine \
       sh -c "cd /from && tar -cf - . | (cd /to && tar -xf -)"

docker run --rm \
       -v source_data:/data:ro \
       -v $(pwd):/backup \
       alpine \
       tar -czf /backup/backup.tar.gz -C /data .

# $(pwd)/backup 디렉터리의 데이터를 new_data 볼륨으로 복원
docker run --rm \
       -v new_data:/data \
       -v $(pwd)/backup:/backup:ro \
       alpine \
       cp -a /backup/. /data/