오브젝트 스토리지로 파일 옮기기.
Amazon S3, Google Cloud Storage, S3 호환 스토리지 또는 서버 폴더의 파일을 버킷으로 가져오세요. 한 번에 모두 복사하거나, 중단 없이 점진적으로 옮길 수 있습니다.
이미 다른 곳에 파일을 보관하고 있나요? 두 가지 방법 중 하나로 애플리케이션의 버킷으로 옮길 수 있습니다. 둘 다 관리 패널에서 시작합니다: 애플리케이션 → 스토리지 → 버킷 → 파일 가져오기.
| 지금 모두 복사 | 중단 없이 점진적으로 이전 | |
|---|---|---|
| 동작 방식 | 모든 파일을 한 번에 복사 | 애플리케이션이 파일을 처음 읽을 때 복사 |
| 애플리케이션 전환 시점 | 복사 완료 후 | 바로 |
| 진행 상황 | 찾은 파일, 복사됨, 건너뜀, 복사 안 됨, 일시 중지, 재개, 중지 | 끌 때까지 켜져 있음 |
| 기존 스토리지 | Amazon S3, Google Cloud Storage, S3 호환 | Amazon S3, Google Cloud Storage |
복사는 저희 쪽에서 실행되므로 컴퓨터를 켜 둘 필요가 없습니다. 복사가 끝나면(또는 끝나기 전에 중단되면) 이메일과 Telegram 메시지를 보내 드립니다.
파일 이전은 계정 소유자와 애플리케이션 관리자가 할 수 있으며(팀 접근 권한 참고), API, CLI, MCP에서도 가능합니다.
시작하기 전에: 읽기 전용 키
기존 스토리지에서 해당 버킷 하나만 목록 조회와 읽기가 가능한 이번 이전 전용 키를 만드세요. 기본 키는 절대 붙여 넣지 마세요. 키는 이번 이전에만 사용되며, 보관하지 않고 다시 표시되지도 않습니다. 이전이 끝나면 기존 업체에서 키를 삭제하세요.
Amazon S3
IAM에서 다음 정책으로 사용자(또는 액세스 키가 있는 역할)를 만드세요. my-old-bucket을 내 버킷 이름으로 바꾸세요.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:List*", "s3:Get*"],
"Resource": ["arn:aws:s3:::my-old-bucket", "arn:aws:s3:::my-old-bucket/*"]
}
]
}그런 다음 액세스 키를 만드세요. 관리 패널에는 액세스 키 ID, 시크릿 액세스 키, 버킷 이름과 리전(예: eu-central-1, S3 콘솔에서 버킷 옆에 표시됨)이 필요합니다.
Google Cloud Storage
버킷 읽기 권한이 있는 서비스 계정을 만들고 JSON 키를 내려받으세요.
gcloud iam service-accounts create rivervo-move --display-name="Move files to Rivervo"
gcloud storage buckets add-iam-policy-binding gs://my-old-bucket \
--member="serviceAccount:rivervo-move@MY-PROJECT.iam.gserviceaccount.com" --role="roles/storage.objectViewer"
gcloud storage buckets add-iam-policy-binding gs://my-old-bucket \
--member="serviceAccount:rivervo-move@MY-PROJECT.iam.gserviceaccount.com" --role="roles/storage.legacyBucketReader"
gcloud iam service-accounts keys create key.json \
--iam-account="rivervo-move@MY-PROJECT.iam.gserviceaccount.com"Storage Object Viewer는 파일을 읽고, Storage Legacy Bucket Reader는 복사 작업이 버킷 자체를 읽을 수 있게 합니다. 관리 패널에 key.json의 전체 내용을 붙여 넣으세요. 이후 컴퓨터에서 키 파일을 삭제하세요.
기타 S3 호환 스토리지
S3 API가 있는 스토리지라면 같은 방법으로 작동합니다. 버킷 목록 조회와 읽기만 가능한 키(대부분의 업체에서 “read-only” 또는 “restricted” 키라고 부름)를 만들고, 버킷 리전의 S3 주소를 확인하세요. 예: https://s3.eu-central-003.backblazeb2.com. 주소는 버킷 이름 없이 입력하세요.
지금 모두 복사
- 애플리케이션 → 스토리지 → 버킷 → 파일 가져오기.
- 지금 모두 복사를 선택하고 기존 스토리지, 해당 버킷, 리전 또는 S3 주소를 지정한 뒤 키를 붙여 넣으세요.
- 선택 사항: 폴더 — 예를 들어
photos/만 복사합니다. - 이미 있는 파일: 기본적으로 버킷에 같은 이름의 파일이 있으면 기존 파일을 유지하고 기존 스토리지의 파일은 건너뜁니다. 덮어쓰려면 덮어쓰기를 켜세요.
- 복사 시작을 누르고 확인하세요.
카드에 찾은 파일, 복사됨, 건너뜀, 복사 안 됨 수가 진행 표시줄과 함께 표시되며, 로그 보기에서 건너뛰었거나 복사하지 못한 파일 이름을 확인할 수 있습니다. 일시 중지, 재개, 복사 중지가 가능하며, 이미 복사된 파일은 그대로 남습니다. 복사가 끝나면 애플리케이션을 버킷으로 전환하세요(S3_* 변수가 이미 있습니다).
파일 이름(키)은 그대로 유지됩니다. 나중에 다시 복사하면 없는 파일만 복사합니다(덮어쓰기가 꺼져 있을 때).
중단 없이 점진적으로 이전
애플리케이션이 계속 작동해야 하고 파일이 계속 추가될 때 유용합니다.
- 파일 가져오기 → 중단 없이 점진적으로 이전에서 기존 스토리지, 버킷, 키를 지정 → 점진적 이전 켜기.
- 애플리케이션을 바로 이 버킷으로 전환하고(
S3_*변수) 배포하세요. - 애플리케이션이 아직 버킷에 없는 파일을 읽으면, 그 순간 기존 스토리지에서 복사되어 제공됩니다. 새 업로드는 바로 버킷에 저장됩니다.
- 마무리: 아직 아무도 읽지 않은 파일을 위해 지금 모두 복사를 실행하고(덮어쓰기는 꺼서 최신 파일 유지), 완료될 때까지 기다린 다음 점진적 이전을 끄기하세요.
끌 때까지 기존 스토리지는 같은 키로 접근 가능해야 합니다. 끈 뒤에는 한 번도 읽히지 않았고 복사되지 않은 파일을 더 이상 가져오지 않습니다.
서버 폴더에서
VPS나 다른 서버의 파일(예: Laravel 사이트의 storage/app/public)을 옮기려면 버킷 자체 키로 rclone을 사용하세요. 키는 애플리케이션의 변수 탭에 있습니다: S3_ENDPOINT, S3_BUCKET, S3_KEY, S3_SECRET(두 번째 버킷은 이름이 앞에 붙습니다: MEDIA_S3_KEY …).
# rclone 설치 (Linux)
curl https://rclone.org/install.sh | sudo bash
# 버킷 키를 환경 변수로 지정 — 설정 파일에 남지 않습니다
export RCLONE_CONFIG_RIVERVO_TYPE=s3
export RCLONE_CONFIG_RIVERVO_PROVIDER=Other
export RCLONE_CONFIG_RIVERVO_REGION=auto
export RCLONE_CONFIG_RIVERVO_ENDPOINT='S3_ENDPOINT 값'
export RCLONE_CONFIG_RIVERVO_ACCESS_KEY_ID='S3_KEY 값'
export RCLONE_CONFIG_RIVERVO_SECRET_ACCESS_KEY='S3_SECRET 값'
# 폴더 구조를 유지하며 버킷(S3_BUCKET 값)으로 복사
rclone copy /var/www/shop/storage/app/public rivervo:BUCKET/public --progress --transfers 16
# 모든 파일이 도착했는지 확인
rclone check /var/www/shop/storage/app/public rivervo:BUCKET/public --one-wayrclone copy는 버킷의 파일을 절대 삭제하지 않고 변경되지 않은 기존 파일은 건너뛰므로, 중단 후 다시 실행해도 됩니다. 오래 걸리는 복사는 서버에서 tmux나 screen 안에서 실행하세요. SSH 연결이 끊겨도 계속 진행됩니다.
비용
이전 자체에는 요금이 없습니다. 버킷의 파일에는 일반 오브젝트 스토리지 요금이 잔액에서 결제됩니다.
- 저장: 월 GB당 US$0.025 — 50GB는 월 약 US$1.25입니다.
- 쓰기: 100만 건당 US$6 — 복사한 파일 하나가 쓰기 약 1건이므로 파일 100,000개는 약 US$0.60입니다(매우 큰 파일은 여러 부분으로 나뉘어 업로드되어 쓰기 몇 건으로 계산됨).
- 점진적 이전 중 발생하는 읽기는 일반 읽기입니다(100만 건당 US$0.50).
대부분의 클라우드 스토리지 업체는 외부로 나가는 데이터(egress)에 요금을 부과합니다. 대량의 데이터를 옮기기 전에 기존 업체의 요금표를 확인하세요.
파일 이전에는 버킷 추가와 마찬가지로 잔액이 0보다 많아야 합니다. 무료 체험 기간에는 사용할 수 없으며, 읽기 전용 상태인 버킷(크기 한도 초과 또는 잔액으로 결제 가능한 범위 초과)으로는 옮길 수 없습니다. 관리 패널에서 이유를 알려 드리고, 도움이 되는 경우 충전을 안내합니다. 복사 도중 버킷이 읽기 전용이 되면 복사가 일시 중지되며, 다시 쓸 수 있게 되면 자동으로 이어집니다.
제한
- 버킷당 복사 1개와 점진적 이전 1개를 동시에 실행할 수 있습니다.
- 1TB보다 큰 파일은 복사에서 건너뜁니다.
- 읽기 전에 복원해야 하는 아카이브 클래스(S3 Glacier Flexible Retrieval, Glacier Deep Archive)의 파일은 건너뜁니다. 먼저 복원하세요.
- 파일과 함께 옮겨지는 메타데이터는 사용자 정의 메타데이터(
x-amz-meta-*)뿐이며, 파일의 ETag는 기존과 다를 수 있습니다. - 점진적 이전이 켜진 상태에서 버킷에서 삭제한 파일은 다음에 읽을 때 다시 복사됩니다.