MongoDB 6 을(를) 실시간 마이그레이션(푸시)합니다.0.13+ 또는 7.0.8+ Cloud Manager가 Atlas로 모니터링하는 클러스터

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

1. 조직 페이지의 왼쪽 패널에서 Live Migration 을(를) 클릭합니다.

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

   참고

   UI 레이블에 Ops Manager가 언급되어 있지만, 이 절차에서는 Atlas MongoDB deployment 6 로만 마이그레이션할 수 있습니다.0. Cloud Manager가 모니터링하는 13 이상입니다.

3. 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가 언급되어 있지만, 이 절차에서는 Atlas MongoDB deployment 6 로만 마이그레이션할 수 있습니다.0. Cloud Manager가 모니터링하는 13 이상입니다.

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

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

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

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

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

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

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

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

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

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

   • 비공개 엔드포인트를 사용하지 않을 경우 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는 인증서가 있으며 읽을 수 있는지를 확인합니다.

   • 대상 cluster에 데이터가 있고 이를 보존하려면 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.13 이상에서는 단일 클라우드 제공자 및 단일 리전 내에 배포된 클러스터에 대해서만 비공개 엔드포인트가 지원됩니다.

   • 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를 클릭합니다.

컷오버를 준비합니다.

지연 타이머와 Prepare to Cutover 버튼이 녹색으로 바뀌면 이를 클릭하여 다음 단계로 진행합니다.

컷오버를 수행합니다.

소스 클러스터와 대상 클러스터가 거의 동기화되었다는 것이 감지될 경우, Atlas는 120시간(5일)까지 연장 가능한 타이머를 시작하여 실시간 마이그레이션 절차의 전환 단계를 개시합니다. 120시간이 지나면 Atlas가 소스 클러스터와의 동기화를 중지합니다. 1} 타이머 아래의 을 클릭하여 남은 시간을 24시간 연장할 수 Extend time 있습니다.<time> left to cut over

1. Prepare to Cutover 을(를) 클릭합니다. Atlas는 다음과 같은 안내 화면을 표시합니다. Your migration is almost complete! 안내 화면에는 전환 프로세스를 진행하는 방법에 대한 다음 지침이 표시됩니다.

   1. 애플리케이션을 중지하세요. 이렇게 하면 소스 클러스터에서 쓰기가 더 이상 발생하지 않습니다.

   2. optime 격차가 0이 될 때까지 기다리세요. 카운터가 0이 되면 소스 클러스터와 대상 클러스터가 서로 동기화됩니다.

   3. 다음과 같은 확인란을 선택합니다. I confirm that I am ready to cut over the application to the destination cluser. By proceeding, Atlas will finalize the migration. This process will take a few seconds. Once it is complete you can point your application at the destination cluster and begin writing to it.

2. Cutover 을(를) 클릭합니다. Atlas가 마이그레이션을 완료하고 Connect 페이지를 표시합니다.

3. 대상 클러스터에서 쓰기를 재개할 시기를 결정합니다. 다음 중 하나를 수행할 수 있습니다.

   • 당신의 cluster 카드의 배너에 Your cluster migration is complete 상태가 표시될 때까지 기다린 다음 대상 cluster에서 쓰기를 재개합니다. 마이그레이션이 완료될 때까지 기다리기로 선택하면 마이그레이션을 완료하는 데 필요한 기간 동안 애플리케이션의 쓰기가 일시적으로 일시 중지됩니다.

     또는

   • 마이그레이션이 완료될 때까지 기다리지 않고 대상 클러스터에 대한 애플리케이션의 쓰기를 시작하고 클러스터 카드 배너에 Your destination cluster in Atlas is ready to accept writes, but we are still finalizing the migration. 다음과 같이 명시되어 있습니다. 마이그레이션 프로세스가 끝날 때까지 기다리지 않고 대상 클러스터로 쓰기를 이동하도록 선택하고 실시간 마이그레이션이 실패하는 경우 최종 단계에서 오류가 발생하면 쓰기를 소스 클러스터로 다시 리디렉션하고 실시간 마이그레이션 프로세스를 다시 시작해야 합니다.

4. Atlas의 대상 클러스터로 쓰기를 리디렉션할 준비가 되면 다음을 수행합니다.

   1. 대상 클러스터의 연결 문자열을 사용하여 애플리케이션에 연결합니다.

   2. 애플리케이션이 대상 Atlas 클러스터에서 작동하는지 확인합니다.

Atlas는 다음 조치를 수행하여 프로세스를 완료합니다.

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

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

• 마이그레이션 프로세스를 완료로 표시합니다.