--- title: "Object Storage" slug: "object-storage-data-migration" updated: 2026-08-20T09:03:25Z published: 2026-08-20T09:03:25Z canonical: "guide-gov.ncloud-docs.com/object-storage-data-migration" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Object Storage
Classic/VPC 환경에서 이용 가능합니다.
네이버 클라우드 플랫폼의 Object Storage를 이용하여 데이터 마이그레이션을 수행할 수 있습니다. Object Storge를 통해 데이터를 업로드 및 다운로드하려면 서버에 Amazon S3를 연동해야 합니다. :::(Info) (참고) 플랫폼(Classic/VPC), 리전 제약 없이 모두 이용할 수 있습니다. ::: ## Object Storage를 이용한 데이터 마이그레이션(Linux) Object Storage를 이용하여 서버 간 데이터를 마이그레이션하려면 다음 단계를 차례대로 진행해 주십시오. [1. Object Storage 이용 신청 및 버킷 생성](#objectstorage이용신청및버킷생성linux) [2. API 인증키 생성 및 Amazon S3 연동](#API인증키생성및AmazonS3연동linux) [3. 파일 업로드 및 다운로드](#파일업로드및다운로드linux) ### Object Storage 이용 신청 및 버킷 생성 Object Storage의 이용을 신청하고 버킷을 생성하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Storage** > **Object Storage** 메뉴를 차례대로 클릭해 주십시오. 3. **[이용 신청]** 버튼을 클릭해 주십시오. 4. 이용 신청 팝업 창이 나타나면 **[적용]** 버튼을 클릭해 주십시오. * 정상적으로 이용 신청이 완료되면 **[이용 신청]** 버튼이 **[상품 이용 중]** 버튼으로 바뀝니다. 5. Bucket Management 화면에서 **[버킷 생성]** 버튼을 클릭해 주십시오. 6. 생성할 버킷 이름을 입력하고 **[다음]** 버튼을 클릭해 주십시오. 7. 잠금 여부 및 저장 객체의 암호화 여부를 선택하고 **[다음]** 버튼을 클릭해 주십시오. * 잠금 또는 암호화를 설정하려면 [문의하기](https://www.gov-ncloud.com/support/question/service){target="_blank"}를 통해 별도로 문의해 주십시오. 8. 버킷 이용에 대한 전체 공개 여부를 선택하고 필요시 타 계정에 버킷 이용 권한을 설정한 후, **[다음]** 버튼을 클릭해 주십시오. 9. 최종 내용을 확인하고 **[버킷 생성]** 버튼을 클릭해 주십시오. ### API 인증키 생성 및 Amazon S3 연동 Amazon S3 API를 통해 Object Storage를 사용하려면 먼저 포털에서 API 인증키를 생성해야 합니다. API 인증키를 생성하고 S3를 연동하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔의 **My Account** > **계정 및 보안 관리** > **보안 관리** > **접근 관리** 메뉴를 차례대로 클릭해 주십시오. 2. **API 인증키** 항목에서 **[신규 API 인증키 생성]** 버튼을 클릭해 주십시오. * 생성된 API 인증키가 목록에 표시됩니다. 3. Linux 서버에서 s3cmd 설치를 위한 python 모듈을 다운로드해 주십시오. ``` # https://bootstrap.pypa.io/pip/get-pip.py -o get-pip.py # sudo python3 get-pip.py ``` ``` # pip3 install python-dateutil # pip3 install python-magic ``` 4. s3cmd 소스 파일을 다운로드 및 압축 해제해 주십시오. :::(info) (참고) VPC 환경은 다음의 조건에서만 외부로 통신이 가능합니다. * Public Subnet: Internet Gateway(IGW)가 구성되고 공인 IP가 할당된 경우 * Private Subnet: NAT Gateway가 구성된 경우 ::: * 소스 파일 다운로드 ``` wget https://github.com/s3tools/s3cmd/archive/master.zip ``` * 소스 파일 압축 해제 ``` unzip master.zip ``` 5. s3cmd 모듈을 배포해 주십시오. ``` cd s3cmd-master sudo python3 setup.py install ``` 6. s3cmd config를 설정해 주십시오. ``` s3cmd --configure ``` * **Access Key ID**: 콘솔의 **My Account** > **계정 및 보안 관리** > **보안 관리** > **접근 관리** 메뉴에서 생성된 인증키의 Access Key ID 값 입력 * **Secret Access Key**: 콘솔의 **My Account** > **계정 및 보안 관리** > **보안 관리** > **접근 관리** 메뉴에서 생성된 인증키의 Secret Key 값 입력 * **S3 Endpoint**: S3 Endpoint 입력 :::(info) (참고) Public Subnet/Private Subnet에 구축된 서버의 S3 Endpoint 값 * 수도권 Endpoint * 공인 도메인: kr.object.gov-ncloudstorage.com * 사설 도메인: kr.object.private.gov-ncloudstorage.com * 남부권 Endpoint * 공인 도메인: krs.object.gov-ncloudstorage.com * 사설 도메인: krs.object.private.gov-ncloudstorage.com ::: * **DNS-style bucket+hostname**: kr.object.gov-ncloudstorage.com/%(bucket)/ * **그 외 항목**: Enter 입력 8. 버킷 및 파일을 조회해 주십시오. * 버킷 조회 ``` s3cmd ls ``` * 버킷 하위 디렉터리 및 파일 조회 ``` s3cmd ls [버킷명] ``` ### 파일 업로드 및 다운로드 생성한 버킷으로 파일을 업로드 및 다운로드할 수 있습니다. 파일을 업로드 및 다운로드하는 방법은 다음과 같습니다. * 업로드 * 파일 업로드 ``` s3cmd put [업로드 파일] [버킷 경로] ``` * 버킷의 파일과 비교하여 변경된 파일만 업로드 ``` s3cmd sync [업로드 파일] [버킷 경로] ``` * 디렉터리 업로드 ``` s3cmd put -r [디렉터리명] [버킷 경로] ``` * 업로드 여부 확인 * 서버에서 확인 ``` s3cmd ls [버킷 경로] ``` * 버킷에서 확인 **Services > Storage > Object Storage > Bucket Management** 메뉴 클릭 후 버킷 선택 * 버킷에서 서버로 파일 다운로드 * s3cmd 명령어로 다운로드 ``` s3cmd get [다운로드 파일] [다운로드할 위치] ``` * 버킷의 URL 경로를 이용하여 다운로드 ``` wget -q -t 1 --timeout=3 -O [다운로드할 위치] [버킷 파일의 URL] ``` ## Object Storage를 이용한 데이터 마이그레이션(Windows) Object Storage를 이용하여 서버 간 데이터를 마이그레이션하려면 다음 단계를 차례대로 진행해 주십시오. [1. Object Storage 이용 신청 및 버킷 생성](#objectstorage이용신청및버킷생성windows) [2. API 인증키 생성 및 Amazon S3 연동](#API인증키생성및AmazonS3연동windows) [3. 파일 업로드 및 다운로드](#파일업로드및다운로드windows) ### Object Storage 이용 신청 및 버킷 생성 Object Storage의 이용을 신청하고 버킷을 생성하는 방법은 다음과 같습니다. 1.네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Storage** > **Object Storage** 메뉴를 차례대로 클릭해 주십시오. 3. **[이용 신청]** 버튼을 클릭해 주십시오. 4. 이용 신청 팝업 창이 나타나면 **[적용]** 버튼을 클릭해 주십시오. * 정상적으로 이용 신청이 완료되면 **[이용 신청]** 버튼이 **[상품 이용 중]** 버튼으로 바뀝니다. 5. Bucket Management 화면에서 **[버킷 생성]** 버튼을 클릭해 주십시오. 6. 생성할 버킷 이름을 입력하고 **[다음]** 버튼을 클릭해 주십시오. 7. 잠금 여부 및 저장 객체의 암호화 여부를 선택하고 **[다음]** 버튼을 클릭해 주십시오. * 잠금 또는 암호화를 설정하려면 [문의하기](https://www.gov-ncloud.com/support/question/service){target="_blank"}를 통해 별도로 문의해 주십시오. 8. 버킷 이용에 대한 전체 공개 여부를 선택하고 필요 시 타 계정에 버킷 이용 권한을 설정한 후, **[다음]** 버튼을 클릭해 주십시오. 9. 최종 내용을 확인하고 **[버킷 생성]** 버튼을 클릭해 주십시오. ### API 인증키 생성 및 Amazon S3 연동 Amazon S3 API를 통해 Object Storage를 사용하려면 먼저 포털에서 API 인증키를 생성해야 합니다. API 인증키를 생성하고 S3를 연동하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔의 **My Account** > **계정 및 보안 관리** > **보안 관리** > **접근 관리** 메뉴를 차례대로 클릭해 주십시오. 2. **API 인증키** 항목에서 **[신규 API 인증키 생성]** 버튼을 클릭해 주십시오. * 생성된 API 인증키가 목록에 표시됩니다. 3. Windows 서버에서 S3 브라우저를 다운로드 및 설치해 주십시오. * [다운로드](https://s3browser.com/download.aspx){target="_blank"} 페이지에서 최신 버전의 S3 브라우저를 다운로드할 수 있습니다. :::(info) (참고) * VPC 환경은 다음의 조건에서만 외부로 통신이 가능합니다. * Public Subnet: Internet Gateway(IGW)가 구성되고 공인 IP가 할당된 경우 * Private Subnet: NAT Gateway가 구성된 경우 * S3 브라우저는 Amazon S3와 Amazon CloudFront용 클라이언트입니다. 무료 버전이기는 하나, 일반적인 개인 용도나 비상업 용도로 사용할 것을 명시하고 있습니다. 따라서 라이선스와 관계없이 사용할 수 있으며, 더 많은 기능을 원한다면 유료 버전을 사용할 수 있습니다. ::: 4. S3 브라우저를 처음 실행하면 나타나는 계정 추가 팝업 창에서 다음 내용을 입력한 후 계정을 추가해 주십시오. * **Account Name**: 사용자가 사용하고자 하는 계정 입력 (<예시> NaverCloud) * **Account Type**: S3 Compatible Storage * **REST Endpoint**: REST Endpoint 입력 :::(info) (참고) Public Subnet/Private Subnet에 구축된 서버의 S3 Endpoint 값 * 수도권 Endpoint * 공인 도메인: kr.object.gov-ncloudstorage.com * 사설 도메인: kr.object.private.gov-ncloudstorage.com * 권 Endpoint * 공인 도메인: krs.object.gov-ncloudstorage.com * 사설 도메인: krs.object.private.gov-ncloudstorage.com ::: * **Access Key**: 콘솔의 **My Account** > **계정 및 보안 관리** > **보안 관리** > **접근 관리** 메뉴에서 생성된 인증키의 Access Key ID 값 입력 * **Secret Key**: 콘솔의 **My Account** > **계정 및 보안 관리** > **보안 관리** > **접근 관리** 메뉴에서 생성된 인증키의 Secret Key 값 입력 5. **[Task]** 탭에서 정상적으로 연결되었는지 확인해 주십시오. * 버킷 생성 및 삭제, 파일 업로드 및 다운로드, 폴더 생성 및 삭제가 정상적으로 동작하는지 확인해 주십시오. * 권한 부여는 네이버 클라우드 플랫폼 콘솔 또는 관련 API로 수행하기를 권장합니다. ### 파일 업로드 및 다운로드 생성한 버킷으로 파일을 업로드 및 다운로드할 수 있습니다. 파일을 업로드 및 다운로드하는 방법은 다음과 같습니다. * 업로드 * 파일 업로드: S3 브라우저에서 버킷 선택 > Files → Upload file(s) 메뉴 선택 > 업로드할 파일 선택 * 폴더 업로드: Files → Upload folder(s) 메뉴 선택 > 업로드할 폴더 선택 * 다운로드 * 파일 다운로드: S3 브라우저에서 버킷 선택 > 다운로드할 파일 선택 > Download 메뉴 클릭 * 폴더 다운로드: S3 브라우저에서 버킷 선택 > 다운로드할 폴더 선택 > Download 메뉴 클릭