Cloud Manager로 모니터링되는 MongoDB 6.0.17+ 또는 7.0.13+ 클러스터를 Atlas로 실시간 마이그레이션(푸시)

Atlas에서 Organization Settings 페이지로 이동합니다.

1. 아직 표시되지 않은 경우 다음 목록에서 원하는 조직 을 선택하세요. 탐색 표시줄의 Organizations 메뉴.

2. 1} 메뉴 옆에 있는 아이콘을 클릭합니다.Organization Settings Organizations

   조직 설정 페이지가 표시됩니다.

Live Migration to Atlas 페이지로 이동합니다.

사이드바에서 Live Migration를 클릭합니다.

Atlas 로 실시간 마이그레이션 페이지가 표시됩니다.

마이그레이션 프로세스를 시작합니다.

1. Migrate from Ops Manager or Cloud Manager를 클릭합니다.

   참고

   UI 라벨에는 Ops Manager가 명시되어 있습니다. 다만 이 절차에서는 Cloud Manager가 모니터링하는 6.0.17 이상의 Atlas MongoDB 배포로만 마이그레이션할 수 있습니다.

2. I'm Ready to Start를 클릭합니다.

이 프로세스를 진행하는 방법에 대한 지침이 포함된 실시간 마이그레이션 마법사가 Atlas에 나타납니다. 이 프로세스는 소스 클러스터의 데이터를 새 대상 클러스터로 푸시합니다. 마법사의 단계가 완료되면 애플리케이션이 새 클러스터를 가리키도록 할 수 있습니다.

Atlas와 연결합니다.

1. Generate Link-Token를 클릭합니다. 링크 토큰 생성에 관한 페이지가 Atlas에 나타납니다.

2. Next 을(를) 클릭하면 생성된 링크 토큰이 포함된 페이지를 볼 수 있습니다.

3. 링크 토큰을 복사하여 안전한 위치에 저장하세요. 링크 토큰의 내용은 절대 Atlas에 표시되지 않습니다. 게다가 링크 토큰은 생성된 후에도 Atlas에 표시되지 않습니다. 링크 토큰을 공개적으로 공유하지 마세요.

   참고

   Cloud Manager 조직 한 개의 모든 프로젝트를 Atlas로 실시간 마이그레이션하려면 고유한 링크 토큰 한 개를 사용하세요.

4. Done를 클릭합니다.

링크 토큰을 Cloud Manager에 붙여넣습니다.

1. Cloud Manager에서 조직에 액세스합니다.

   Cloud Manager를 열고 Atlas로 실시간 마이그레이션할 프로젝트의 클러스터가 속해 있는 조직으로 이동하세요.

2. 왼쪽 탐색 패널에서 Settings을 클릭합니다.

3. Live Migration: Connect to Atlas 섹션에서 Connect to Atlas 을 클릭합니다. Connect to Atlas 대화 상자가 열립니다.

4. 실시간 마이그레이션 마법사의 이전 단계에서 생성한 링크 토큰을 붙여넣고 Connect to Atlas 을(를) 클릭하세요. Cloud Manager는 Atlas에 대한 연결을 설정합니다. 필요한 경우 Refresh 버튼을 사용하여 Atlas로 업데이트를 전송합니다.

대상 Atlas cluster를 생성합니다.

아직 생성하지 않았다면 Atlas에서 대상 클러스터를 생성합니다. 필수 액세스 권한을 참조하세요.

대상 cluster에서 마이그레이션을 시작합니다.

1. Select Target Cluster from Projects를 클릭합니다.

2. 대상 Atlas 클러스터의 프로젝트로 이동하여 원하는 대상 클러스터를 찾으세요.

3. 클릭 을 클릭하고 드롭다운 목록에서 Migrate Data to this Cluster 을(를) 선택하여 마이그레이션을 시작합니다. Migrate Data to This Cluster 페이지가 열립니다.

4. Migrate from Ops Manager or Cloud Manager를 클릭합니다.

   참고

   UI 라벨에는 Ops Manager가 명시되어 있습니다. 다만 이 절차에서는 Cloud Manager가 모니터링하는 6.0.17 이상의 Atlas MongoDB 배포로만 마이그레이션할 수 있습니다.

   다음과 같이 필드를 입력합니다.

   • 아직 선택되지 않은 경우 Cloud Manager에서 소스 프로젝트를 선택합니다.

   • 드롭다운에서 소스 클러스터를 선택합니다.

   • 복제본 세트를 샤딩된 클러스터로 마이그레이션하는 경우:

     • 컬렉션을 샤드 하려면 Include sharding parameters 의 확인 표시를 클릭하고 샤딩 예시 를 사용하여 샤딩 구성 JSON 을 텍스트 상자에 붙여넣습니다. 나중에 참조할 수 있도록 이 구성을 외부의 파일 에 저장합니다.

       샤딩 구성 JSON은 샤딩할 컬렉션과 샤딩에 사용할 키를 지정하는 shardingEntries 배열을 정의합니다. MongoDB는 이 배열에 포함된 컬렉션만 샤딩합니다. 자세한 내용은 샤딩을 참조하세요.

       샤딩 구성 지정을 생략하면 클러스터를 Atlas로 마이그레이션한 후 대상 클러스터에서 컬렉션을 샤딩할 수 있습니다.

     • 샤딩 구성 외에도, 지정된 샤딩 키에 대한 호환 인덱스가 서비스 중인 대상 클러스터에 존재해야 합니다.

       MongoDB가 Atlas의 대상 클러스터에 지원 샤드 키 인덱스를 자동으로 생성하도록 Create supporting indexes에 체크 표시를 클릭합니다.

   • 마이그레이션을 처리할 마이그레이션 호스트를 선택합니다.

   • 비공개 엔드포인트를 사용하지 않을 경우 IP 주소 액세스 목록을 검토하고, 마이그레이션 호스트의 외부 IP 주소가 이 목록에 포함되어 있는지 확인하세요. 해당 주소가 추가되지 않았다면 지금 추가하세요.

     • 클릭 Set Network Access for Host

     • 클릭 + Add IP Address

     • 실시간 마이그레이션 마법사로 돌아갑니다. 드롭다운에서 소스 클러스터를 선택하고 아래에서 Migrate data to this cluster 을(를) 선택합니다..

   • 드롭다운에서 소스 클러스터를 선택합니다.

   • 소스 클러스터에서 인증을 시행하면 제공된 텍스트 상자에 사용자 이름 및 비밀번호를 입력하세요.

     Atlas 실시간 마이그레이션에 필요한 사용자 권한에 대한 지침은 소스 클러스터 보안 을 참조하세요.

   • Cloud Manager에서 소스 클러스터의 자동화가 일시 중단된 상태에서도 모니터링 에이전트로 소스 클러스터를 계속 모니터링할 경우 Username 및 Password가 표시됩니다. 원하는 배포서버에 사용자 인증이 필요하다면 해당 필드에 사용자 이름과 비밀번호를 입력하세요. 입력한 자격 증명에 해당하는 데이터베이스 사용자는 관리 데이터베이스에서 최소한 백업 역할이 있어야 하며 SCRAM-SHA-1 및 SCRAM-SHA-256 모두를 사용하여 인증되어야 합니다.

   • 소스 cluster가 TLS/SSL 을 사용하는 경우 Is encryption in transit enabled? 버튼을 토글합니다.

   • 소스 클러스터가 사용자 지정 루트 인증 기관(CA, Certificate Authority)과 함께 TLS/SSL을 사용할 경우, 마이그레이션 호스트에서 CA 파일의 경로를 복사한 후 제공된 텍스트 상자에 이 경로를 붙여 넣으세요. 이 파일이 마이그레이션 호스트에 있어야 마이그레이션 호스트가 인증서를 읽을 수 있습니다. Atlas는 인증서가 있으며 읽을 수 있는지를 확인합니다.

   • 대상 클러스터 에 보존하려는 데이터가 있는 경우 Clear any existing data on your destination cluster 옵션을 선택 취소한 상태로 유지합니다. 실시간 마이그레이션 서비스는 유효성 검사 중에 문서 샘플 을 확인하고 중복 네임스페이스를 찾으면 경고합니다. 기존 데이터를 삭제 하려면 이 옵션을 선택한 다음 대상 클러스터 의 이름을 입력합니다.

   • 이 cluster에 연결할 연결을 선택하세요. Standard connection 는 항상 UI에서 사용 가능한 상태로 표시됩니다. 단, 이외의 연결 옵션은 cluster에 대해 이전에 VPC Peering 연결 또는 비공개 엔드포인트를 구성한 적이 있는 경우에만 허용됩니다. VPC 연결 또는 비공개 엔드포인트가 구성되지 않은 것을 Atlas가 감지하면 해당 옵션이 회색으로 표시됩니다.

     • VPC Peering 또는 비공개 엔드포인트를 사용하지 않는 경우 Standard connection 를 클릭하고 이 단계의 Validation 단계로 진행하세요.

     • 마이그레이션 호스트 와 Atlas 복제본 세트 간에 VPC 피어링 연결 을 구성한 경우 VPC Peering 옵션이 활성화됩니다. 실시간 마이그레이션 을 위해 VPC 피어링을 사용하여 연결하려면 VPC Peering 을(를) 클릭합니다. VPC Peering 옵션이 회색으로 표시된 경우 이 절차를 시작하기 전에 VPC 피어링 연결을 구성하세요 . 학습 내용 은 VPC 피어링 및 비공개 엔드포인트 지원을 참조하세요.

     • 마이그레이션 호스트와 Atlas 클러스터 간에 비공개 엔드포인트를 구성한 경우 Private Endpoint 옵션이 활성화됩니다. Private Endpoint를 클릭하여 비공개 엔드포인트에 연결한 다음 드롭다운에서 이전에 구성된 비공개 엔드포인트를 선택합니다. AVAILABLE 상태의 비공개 엔드포인트만 사용 가능합니다. Private Endpoint 옵션이 회색으로 표시되면 이 절차를 시작하기 전에 비공개 엔드포인트를 구성하세요. 자세한 내용은 VPC 피어링 및 비공개 엔드포인트 지원을 참조하세요.

       참고

       소스 클러스터 및 대상 클러스터가 MongoDB 6.0.17 이상을 실행 중인 푸시 실시간 마이그레이션인 경우, 비공개 엔드포인트는 단일 클라우드 제공자 및 단일 리전 안에 배포된 클러스터에서만 지원됩니다.

   • Validate를 클릭합니다. 유효성 검사 프로세스에서는 마이그레이션 호스트에 연결할 수 있는지 확인하고, 다음과 같은 유효성 검사를 수행하여 Atlas로의 실시간 마이그레이션이 시작될 수 있게 합니다.

     다음과 같은 유효성 검사를 활용하려면 최신 버전으로 Cloud Manager의 MongoDB Agent를 업그레이드하세요. 실시간 마이그레이션 중에는 다음과 같은 유효성 검사가 실행됩니다.

     • 마이그레이션 호스트는 대상 cluster에 연결할 수 있습니다.

     • 소스 클러스터가 사용자 지정 루트 인증 기관(CA)과 함께 TLS/SSL을 사용할 경우, 마이그레이션 호스트는 TLS/SSL을 사용하여 소스 클러스터에 액세스할 수 있습니다.

     • 데이터베이스 사용자 자격 증명이 유효합니다. 이 유효성 검사는 Cloud Manager에서 소스 클러스터의 자동화가 일시 중단되더라도 Monitoring Agent로 소스 클러스터를 계속 모니터링하는 경우에만 실행됩니다.

     • 이 마이그레이션 프로세스에서는 대상 클러스터에 압축된 데이터의 저장 용량을 기준으로 충분한 디스크 공간이 있는지 검증합니다. 데이터 및 스토리지 크기에 대해 자세히 알아보려면 dbStats를 참조하세요.

   • 유효성 검사에 실패하면 마이그레이션 호스트, 외부 IP 주소 또는 CIDR 블록의 유효성 및 링크 토큰을 확인하세요. 아울러 데이터베이스 사용자 자격 증명, TLS/SSL 인증서, 대상 클러스터의 디스크 저장 용량도 확인하세요.

   • 유효성 검사가 성공하면 Next 을 클릭합니다.

마이그레이션을 시작합니다.

1. 소스 조직, 프로젝트 및 클러스터, 실시간 마이그레이션 프로세스에서 사용할 마이그레이션 호스트가 명시된 보고서를 검토하세요.

2. Start the Migration를 클릭합니다.

   마이그레이션 프로세스가 시작되면 대상 Atlas 클러스터에 대해 Migrating Data 자세한 설명 화면이 Atlas UI에 표시됩니다. 이 안내 화면은 대상 클러스터가 마이그레이션 프로세스를 진행할 때 업데이트됩니다. 마이그레이션 프로세스에 포함되는 작업은 다음과 같습니다.

   • 소스 클러스터 데이터에 대한 새 쓰기를 대상 클러스터 데이터에 적용합니다.

   • 소스 클러스터에서 대상 클러스터로 데이터 복사.

   • 대상 클러스터에서 마이그레이션을 마무리합니다.

   이 마이그레이션 프로세스의 마지막 단계에서는 지연 시간 값이 표시됩니다. 이 값은 소스 클러스터와 대상 클러스터 간의 현재 지연을 나타냅니다.

   지연 타이머가 0에 가깝고 마이그레이션 프로세스 가 따라 Atlas 가 Cutover to your destination cluster 버튼을 활성화하여 소스 클러스터와 대상 클러스터가 동기화 되었음을 나타냅니다. 다음 단계로 진행합니다.

컷오버를 수행합니다.

컷오버는 애플리케이션의 읽기 및 쓰기를 소스 클러스터 에서 대상 클러스터 로 지시하는 3단계 프로세스 입니다.

소스 클러스터와 대상 클러스터가 거의 동기화 되어 있음을 감지한 Atlas 는 연장 가능한 120 시간(5 일) 타이머를 시작하여 실시간 마이그레이션 절차의 전환 단계를 시작합니다. 120 시간이 지나면 Atlas 가 소스 클러스터 와의 동기화를 중지합니다.

마이그레이션 프로세스 의 이 단계에서는 컷오버를 진행하거나 동기화 기간을 연장한 후 컷오버를 진행할 수 있습니다.

• I'm ready to cutover 를 클릭하면 Atlas 가 전환 프로세스 를 시작합니다.

• Extend Sync 을(를) 클릭하고 확장 동기화 가 성공적으로 완료되면 Atlas 에서 소스 클러스터와 대상 클러스터가 동기화 되었는지 확인합니다. 전환 프로세스 를 진행합니다. 동기화 시간이 만료되면 마이그레이션 을 다시 시도할 수 있습니다.

  마이그레이션이 만료되려고 하는 경우 Atlas는 다음 예와 유사한 이메일을 보냅니다.

  A migration to your Atlas cluster will expire in <number> hours!
  Navigate to your destination cluster to start the cutover process. If
  you don't take any action within <number> hours, the migration will be
  cancelled and you will need to start again. You can also extend the
  migration process if you need more time.

1. I'm ready to cutover 을(를) 클릭합니다. 3단계 전환 프로세스 를 빠르게 진행하여 애플리케이션 가동 중단 시간 최소화 하세요.

2. Proceed to cutover 을(를) 클릭합니다. 3단계 전환 프로세스 가 시작됩니다.

   1. 소스 클러스터 에 대한 쓰기를 중지합니다. I confirm that I've stopped writes to my source cluster 을(를) 클릭합니다. 계속하려면 Finalize migration 을 클릭합니다.

   2. Atlas 가 마이그레이션 을 완료하는 동안 몇 분 정도 기다립니다. Atlas 는 다음 조치를 수행하여 프로세스 를 완료합니다.

      • 대상 클러스터의 IP 액세스 목록에서 MongoDB 실시간 마이그레이션 서버 서브넷을 제거합니다.

      • 실시간 마이그레이션 도중 데이터를 대상 클러스터로 가져오는 데 사용된 데이터베이스 사용자를 제거합니다.

      컷오버 프로세스가 12시간 이상 진행 중인 경우 Atlas는 마이그레이션 프로세스를 확인하거나 지원팀에 문의할 것을 제안하는 이메일을 보냅니다.

   3. 마이그레이션 이 성공하면 You have successfully migrated to Atlas 페이지가 표시됩니다. Atlas 는 동기화된 변경 사항의 상태, 애플리케이션 다운타임, 마이그레이션 프로세스 기간, 복사된 초기 데이터의 양, 복사된 컬렉션의 수를 표시합니다.

      • 문서 수를 비교하고 해시 비교를 실행 하여 데이터가 대상 클러스터 로 전송되는지 확인합니다. 학습 내용 은 데이터 전송의 Cluster-to-Cluster Sync 확인을 참조하세요.

      • Connect to your new cluster 을(를) 클릭합니다. Atlas 가 연결 방법을 선택할 수 있는 Connect to Atlas 페이지로 리디렉션합니다.

      • 클러스터 에 연결한 후 대상 클러스터 에 대한 쓰기를 다시 시작합니다.