Docs Menu
Docs Home
/
MongoDB Atlas
/ /

로컬로 다운로드한 스냅샷에서 복원하기

이 페이지의 내용

  • 다운로드 고려 사항
  • 복원 고려 사항
  • 필요한 액세스 권한
  • 절차

Atlas는 전용 클러스터, 공유 클러스터, 레거시 백업 스냅샷을 압축 파일로 다운로드할 수 있는 메커니즘을 제공합니다.

Atlas 는 복원 전에 대상 클러스터 의 모든 기존 데이터를 삭제합니다. 대상 클러스터 는 복원 기간 동안 사용할 수 있습니다.

백업 스냅샷 의 수동 다운로드 가 실패할 경우, Atlas 는 요청 을 유지하고 가장 최근 다운로드 실패가 발생한 지 1시간 이내인 한 백업 을 다시 시작할 수 있도록 허용합니다.

Atlas Amazon Web Services AzureAtlas Amazon Web Services 또는 Azure 에 배포된 Atlas 클러스터의 경우, 비공개 엔드포인트 를 구성한 경우 Atlas 를 사용하여 스냅샷 샷과 동일한 리전 에 있는 비공개 엔드포인트 를 통해 스냅샷 을 다운로드 할 수 있습니다. 비공개 엔드포인트를 통해 스냅샷 을 다운로드하면 요금이 발생할 수 있습니다. 학습 내용은 비공개 엔드포인트를 참조하세요.

로컬로 다운로드한 스냅샷에서 복원할 때는 전제 조건 외에도 다음 요구 사항 및 제한 사항을 고려합니다.

  • 소스 스냅샷의 DefaultRWConcern 값이 대상 클러스터의 DefaultRWConcern 값과 다른 경우 Atlas는 소스 스냅샷의 값을 대상 클러스터의 값으로 재정의합니다. 대상 클러스터의 DefaultRWConcern 에 대해 구성된 값이 없는 경우 Atlas는 명시적인 구성 없이 스냅샷에서 DefaultRWConcern 의 값을 유지합니다. 이는 해당 MongoDB 버전의 기본값과 다를 수 있습니다.

  • 이 기능 은 M0 클러스터에서는 사용할 수 없습니다.

  • 다운로드한 파일은 data 디렉토리 에서 복사한 원시 파일로 구성됩니다. mongorestore 는 이러한 파일과 호환되지 않습니다. 데이터 파일에 액세스 하려면 다음 절차 를 사용하여 mongod 인스턴스 를 시작하고 추출 디렉토리 를 점 .

  • cloud 제공자의 비공개 엔드포인트에 있거나 근처에 있는 경우 비공개 엔드포인트를 통해 스냅샷 을 다운로드 하지 못할 수 있습니다. 이 경우 Atlas 에서 제공하는 공개 다운로드 엔드포인트를 사용하세요.

백업 스냅샷을 다운로드하려면 프로젝트에 대한 Project Owner 이상의 액세스 권한이 있어야 합니다.

1
  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.

    Clusters(클러스터) 페이지가 표시됩니다.

2
  1. 클러스터 이름을 클릭합니다.

  2. Backup 탭을 클릭합니다.

    클러스터 에 Backup 탭 이 없으면 해당 클러스터 에 대해 Atlas 백업이 비활성화되며 스냅샷을 사용할 수 없습니다. 클러스터 를 확장하다할 때 백업을 활성화 할 수 있습니다.

    백업 페이지가 표시됩니다.

3
  1. Snapshots 하위 탭을 클릭합니다.

  2. Actions 열에서 Actions 메뉴를 펼치고 다운로드하려는 스냅샷의 Download를 클릭합니다.

    Atlas 는 생성 후 1 시간 이내에 만료되는 일회성 다운로드 링크를 생성합니다. Amazon Web Services 또는 Azure 의 경우, Atlas Azure 는 스냅샷 과 동일한 리전 에 구성된 Amazon Web ServicesAtlas 모든 비공개 엔드포인트 에 대한 일회성 다운로드 링크도 생성합니다.

    이 링크를 만드는 데 걸리는 시간은 Atlas 클러스터의 크기에 따라 증가합니다.

다운로드가 준비되면 Atlas는 다음을 수행합니다.

  • 스냅샷 다운로드가 준비되었다는 알림을 이메일로 전송합니다.

  • Restores & Downloads 탭에 다운로드 링크를 표시합니다.

참고

API를 통해 사용 가능

다른 옵션으로 API 를 사용하여 복원 스냅샷 을 요청 수 있습니다. Atlas Administration API 는 스냅샷 과 동일한 리전 에 있는 공용 인터넷을 통한 다운로드의 경우 deliveryUrl 필드 에, 비공개 엔드포인트를 통한 다운로드의 경우 privateDownloadDeliveryUrls 필드 에 다운로드 링크를 반환합니다.

4

현재 프로젝트 IP 액세스 목록 범위가 대상 클라이언트 IP 또는 CIDR 주소를 포함하지 않는 경우 Add or Modify your IP Addresses를 클릭하여 Atlas 프로젝트 IP 액세스 목록을 변경합니다.

5
  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 아직 표시되지 않은 경우 사이드바에서 Clusters를 클릭합니다.

    Clusters(클러스터) 페이지가 표시됩니다.

6
  1. 클러스터 이름을 클릭합니다.

  2. Backup 탭을 클릭합니다.

    클러스터 에 Backup 탭 이 없으면 해당 클러스터 에 대해 Atlas 백업이 비활성화되며 스냅샷을 사용할 수 없습니다. 클러스터 를 확장하다할 때 백업을 활성화 할 수 있습니다.

    백업 페이지가 표시됩니다.

7
  1. Restores & Downloads 하위 탭을 클릭합니다.

  2. 생성한 복원 스냅샷으로 이동합니다.

  3. Download를 클릭합니다.

8

Atlas가 스냅샷을 .tar.gz 파일로 압축합니다. 이 아카이브에는 스냅샷과 mongod 로그가 포함되어 있습니다.

  1. 아카이브에서 파일을 압축 해제합니다.

    예시

    다음 명령은 tar 유틸리티를 사용하여 tar``archive with ``gzip 압축을 추출합니다.

    tar -xvzf ~/Downloads/mongodb-snapshots/my-cluster-snapshot.tar.gz
  2. 호스트에서 mongod 인스턴스를 시작하고 --dbpath 옵션을 사용하여 추출 디렉토리를 가리키면 데이터 파일에 액세스할 수 있습니다. 자세한 내용은 mongod 프로세스 시작을 참조하세요.

    예시

    다음 명령은 추출된 데이터 파일 디렉토리를 사용하여 mongod 인스턴스를 시작합니다.

    mongod --dbpath ~/Downloads/mongodb-snapshots/my-cluster-snapshot/

돌아가기

다른 프로젝트에서 복원