샤딩된 클러스터를 Atlas로 라이브 마이그레이션(끌어오기)(MongoDB 6.0.13 이전 버전)

마이그레이션 경로

Atlas 실시간 마이그레이션(끌어오기)은 다음 마이그레이션 경로를 지원합니다.

네트워크 액세스

다음 구성 요소에 대한 네트워크 권한을 구성합니다.

마이그레이션 전 유효성 검사

Atlas는 실시간 마이그레이션 절차를 시작하기 전에 소스 클러스터와 대상 클러스터에 대해 여러 가지 유효성 검사를 수행합니다.

• 소스 클러스터는 샤드 클러스터여야 합니다.

  소스가 복제본 세트 클러스터인 경우 풀 타입(pull-type) 실시간 마이그레이션을 사용하여 먼저 이 클러스터를 Atlas 복제본 세트로 마이그레이션한 다음, 샤딩된 클러스터로의 클러스터 확장을 실행하세요.

  소스가 독립형 인 경우 끌어오기 유형 실시간 마이그레이션 을 사용하기 전에먼저 독립형 을 복제본 세트 로 변환하세요 . 그런 클러스터 확장하다 를 샤딩된 클러스터 로 확장합니다.

• 소스 클러스터는 CSRS(구성 MongoDB 서버 복제본 세트)를 사용해야 합니다. 복제본 세트 구성 서버를 참조하세요.

• Atlas의 소스 클러스터는 각 노드의 호스트 이름 및 포트에 연결되어 있어야 합니다.

• Atlas는 소스 클러스터에서 샤딩된 클러스터 밸런서를 중지 및 시작할 수 있어야 합니다.

• 소스 클러스터의 기능 호환성 버전 및 주요 MongoDB 버전은 대상 cluster와 동일합니다. 전체 5.0.x 의 주요 MongoDB 버전 버전은 5.0 입니다.

  소스 클러스터에 있는 호스트의 기능 호환성 버전을 확인하려면 mongosh에서 다음 명령을 실행합니다.

  db.runCommand( { getParameter : 1, "featureCompatibilityVersion" : 1 } )

  setFeatureCompatibilityVersion 데이터베이스 명령을 사용하여 필요에 따라 featureCompatibilityVersion 플래그를 설정합니다.

• 대상 Atlas 샤딩된 클러스터의 샤드 수는 소스 샤딩된 클러스터와 동일해야 합니다.

소스 클러스터 보안.

다양한 기본 제공 역할이 충분한 권한을 제공합니다. 예시:

• 소스 클러스터의 경우 사용자는 readAnyDatabase, clusterMonitor, backup 역할이 있어야 합니다.

  실시간 마이그레이션 프로세스를 실행할 데이터베이스 사용자에게 이러한 역할이 있는지 확인하려면 admin 데이터베이스에서 db.getUser() 명령을 실행합니다.

  use admin
  db.getUser("admin")
  {
    "_id" : "admin.admin",
    "user" : "admin",
    "db" : "admin",
    "roles" : [
      {
        "role" : "backup",
        "db" : "admin"
      },
      {
        "role" : "clusterMonitor",
        "db" : "admin"
      }
      {
        "role" : "readAnyDatabase",
        "db" : "admin"
      }
    ]
  } ...

  이외에도 소스 클러스터의 데이터베이스 사용자는 데이터베이스의 oplog를 읽을 수 있는 역할이 있어야 admin 합니다. 자세히 알아보려면 Oplog 액세스를참조하십시오.

• MongoDB 3.4를 실행하는 소스 클러스터의 경우 사용자는 최소한 clusterMonitor 및 readAnyDatabase 역할을 모두 가지고 있어야 합니다. 예를 들면 다음과 같습니다.

   use admin
   db.createUser(
     {
       user: "mySourceUser",
       pwd: "mySourceP@$$word",
       roles: [ "clusterMonitor", "readAnyDatabase" ]
     }
   )

• MongoDB 3.2를 실행하는 소스 클러스터의 경우 사용자는 최소한 clusterManager 및 readAnyDatabase 역할과 local 데이터베이스에 대한 읽기 액세스 권한이 모두 있어야 합니다. 여기에는 사용자 지정 역할이 필요합니다. 이 역할은 다음 명령을 사용해서 생성할 수 있습니다.

    use admin
    db.createRole(
         {
           role: "migrate",
           privileges: [
             { resource: { db: "local", collection: "" }, actions: [ "find" ] }
           ],
           roles: ["readAnyDatabase", "clusterManager"]
         }
       )
     db.createUser(
         {
           user: "mySourceUser",
           pwd: "mySourceP@$$word",
           roles: [ "migrate" ]
         }
       )

• MongoDB 2.6 또는 3.0을 실행하는 소스 클러스터의 경우 사용자에게는 최소한 readAnyDatabase 역할이 있어야 합니다. 예를 들면 다음과 같습니다.

    use admin
       db.createUser(
         {
           user: "mySourceUser",
           pwd: "mySourceP@$$word",
           roles: [ "readAnyDatabase" ]
         }
       )

실시간 마이그레이션 절차 중 프롬프트가 나타나면 Atlas의 사용자 이름과 비밀번호를 지정하세요.

Atlas는 인증을 적용하는 소스 클러스터에 연결할 때 SCRAM만 지원합니다.

SCRAM 인증에 대한 지원은 MongoDB 3.0부터 시작되었습니다. 소스 클러스터에서 MongoDB 2.6을 실행 중이라면 SCRAM 인증을 활성화하지 않고도 풀 실시간 마이그레이션을 사용하여 마이그레이션할 수 있습니다.

MongoDB가 라이브 마이그레이션 서버를 보호하는 방법

Atlas로의 어떤 풀 타입 실시간 마이그레이션에서든 Atlas는 실시간 마이그레이션을 실행하고 소스의 데이터를 대상 클러스터로 전송하는 서버를 관리합니다.

MongoDB는 Atlas로 전송되는 데이터의 무결성과 기밀성을 보호하기 위해 다음과 같은 조치를 취합니다.

• MongoDB는 Atlas 관리형 실시간 마이그레이션 서버와 대상 클러스터 간에 전송되는 데이터를 암호화합니다. 소스 클러스터와 Atlas 관리형 마이그레이션 서버 간에 전송되는 데이터를 암호화해야 하는 경우 소스 클러스터에서 TLS를 구성하세요.

• MongoDB는 Atlas의 다른 부분에 대한 액세스 권한을 보호하듯이 Atlas 관리형 마이그레이션 서버 인스턴스에 대한 액세스 권한을 보호합니다.

• 드문 일이지만 중요 서비스를 조사하고 복원하는 데 개입이 필요한 경우, MongoDB는 최소 권한 원칙을 준수하면서 중요 문제의 해결에 필요한 최소한의 제한 시간 동안 권한이 있는 소수의 사용자에게만 Atlas 클러스터에 액세스할 수 있는 권한을 부여합니다. MongoDB는 이러한 사용자가 Atlas 클러스터에 로그인하고 Bastion host를 통해 SSH 연결을 설정할 수 있도록 MFA를 요구합니다. 권한이 있는 사용자에게 이 유형의 액세스 권한을 부여하려면 MongoDB 고위 경영진의 승인을 받아야 합니다. MongoDB는 다른 MongoDB 담당자가 MongoDB Atlas 클러스터에 액세스하도록 허용하지 않습니다.

• MongoDB는 권한이 있는 사용자 계정을 권한이 있는 활동에만 사용할 수 있도록 허용합니다. 권한이 없는 활동을 수행하려면 권한이 있는 사용자가 별도의 계정을 사용해야 합니다. 권한 있는 사용자 계정은 공유 자격 증명을 사용할 수 없습니다. 권한이 있는 사용자 계정은 Atlas 보안 백서 4.3.3절에 설명된 비밀번호 요구 사항을 따라야 합니다.

• Atlas에서 권한 있는 사용자를 포함한 모든 MongoDB 담당자가 클러스터에 액세스하는 것을 제한할 수 있습니다. 이러한 액세스 권한을 제한하기로 했는데 MongoDB의 판단에 따라 지원 문제 해결에 해당 액세스가 필요한 경우, MongoDB는 먼저 사용자의 권한을 요청해야 합니다. 그런 다음 사용자는 최대 24시간 동안 권한이 있는 사용자의 액세스 권한을 일시적으로 복원할지 여부를 결정할 수 있습니다. 이 임시 24시간 액세스 권한의 허용은 언제든지 취소할 수 있습니다. 이 제한을 활성화하면 지원 문제의 응답 및 해결에 소요되는 시간이 길어질 수 있으며, 결과적으로 Atlas 클러스터의 가용성에 악영향을 미칠 수 있습니다.

• MongoDB는 분기별로 권한이 있는 사용자의 액세스 권한 허용을 검토합니다. MongoDB는 해당 권한이 더 이상 필요 없는 경우(예: 권한이 있는 사용의 역할 변경 또는 퇴사 후 24시간 이내) 권한이 있는 사용자의 액세스 권한을 취소합니다.뿐만 아니라 MongoDB 담당자의 모든 액세스를 Atlas 클러스터에 기록하고, 최소 6년 동안 감사 로그를 보관하며 타임스탬프, 작업자, 작업 및 결과를 기록합니다. MongoDB는 자동 검토 및 수동 검토를 조합해서 이러한 감사 로그를 스캔합니다.

Atlas 보안에 대해 자세히 알아보려면 Atlas 보안 백서를 참조하세요. 특히 'MongoDB Atlas 클러스터에 대한 MongoDB 담당자 액세스 권한' 섹션을 잘 읽어 보세요.

인덱스 키 제한

MongoDB 배포에 인덱스 키 제한을 초과하는 키가 있는 인덱스가 포함된 경우 실시간 마이그레이션 프로시저를 시작하기 전에 크기가 큰 키가 포함되지 않도록 인덱스를 수정합니다.

네트워크 암호화

풀 실시간 마이그레이션 중에 소스 클러스터가 그 데이터에 TLS 암호화를 사용하지 않을 경우, 소스 클러스터에서 Atlas로 전송되는 트래픽은 암호화되지 않습니다. 풀 실시간 마이그레이션 절차를 시작하기 전에 이 작업이 허용되는지 확인하세요.

데이터베이스 사용자 및 역할

Atlas는 어떤 사용자 또는 역할 데이터도 대상 클러스터로 마이그레이션하지 않습니다.

소스 클러스터가 인증을 사용하지 않는 경우, Atlas가 인증 없이 실행하는 것을 지원하지 않으므로 Atlas로 사용자를 생성해야 합니다.

소스 클러스터가 인증을 시행하는 경우 애플리케이션이 대상 Atlas 클러스터에서 사용하는 자격 증명을 다시 생성해야 합니다. Atlas는 사용자 인증에 SCRAM 을 사용합니다. Atlas에서 데이터베이스 사용자를 생성하는 방법을 알아보려면 데이터베이스 사용자 구성을 참조하세요.

SCRAM 인증에 대한 지원은 MongoDB 3.0부터 시작되었습니다. 소스 클러스터에서 MongoDB 2.6을 실행 중이라면 SCRAM 인증을 활성화하지 않고도 풀 실시간 마이그레이션을 사용하여 마이그레이션할 수 있습니다.

소스 클러스터 밸런서

Atlas 실시간 마이그레이션은 절차 시작 시 소스 클러스터에서 샤딩된 클러스터 밸런서를 중지하고 절차 종료 시 밸런서를 시작합니다.

실시간 마이그레이션을 취소하면 Atlas가 소스 클러스터에서 밸런서를 다시 시작합니다.

대상 클러스터 구성

대상 Atlas 클러스터를 구성할 경우 다음 사항을 고려하세요.

• 실시간 마이그레이션 프로세스는 MongoDB 관리형 실시간 마이그레이션 서버를 통해 데이터를 스트리밍합니다. 각 서버는 소스 클러스터와 가장 가까운 리전에 호스팅되는 인프라에서 실행됩니다. 사용 가능한 리전은 다음과 같습니다.

  유럽

  • 프랑크푸르트

  • 아일랜드

  • London

  Americas

  • 미국 동부

  • 미국 서부

  APAC

  • 뭄바이

  • 싱가포르

  • 시드니

  • Tokyo

• Atlas의 대상 클러스터(애플리케이션 서버 또는 소스 클러스터에 호스팅된 배포에 비해 네트워크 지연 시간이 가장 짧음)에 클라우드 리전을 사용합니다. 대상 Atlas 클러스터의 기본 리전과 동일한 리전의 클라우드에서 애플리케이션의 서버를 실행하는 것이 가장 좋습니다. 자세한 내용은 클라우드 공급자를 참조하세요.

• oplog 컬렉션의 무제한 증가를 방지하려면 실시간 마이그레이션 프로세스 기간 동안 고정된 oplog 크기를 설정합니다 . 자세히 알아보려면 필수 액세스 및 Atlas 구성 옵션을 참조하세요.

• Global cluster 를 실시간 마이그레이션의 대상으로 지정할 수 없습니다.

  중요

  실시간 마이그레이션 프로세스가 시작되면 대상 Atlas 클러스터를 수정할 수 없습니다. 대상 클러스터를 확장하려면 실시간 마이그레이션 프로세스를 취소 하고 클러스터를 확장한 후 실시간 마이그레이션 프로세스를 다시 시작하세요.

대상 cluster 네트워크 액세스

실시간 마이그레이션 중에는 대상 클러스터의 mongos 프로세스가 종료되고 mongos 서버를 통한 클러스터 연결이 일시 중단됩니다. 마이그레이션이 완료되면 mongos 프로세스가 자동으로 다시 시작됩니다.

대상 클러스터의 워크로드 방지

대상 클러스터에서 어떤 워크로드(실시간 마이그레이션 프로세스와 겹치지 않는 네임스페이스에서 실행 중인 워크로드 포함)도 실행하지 마세요. 이 작업을 수행하면 실시간 마이그레이션 프로세스 중에 발생 가능한 잠금 충돌 및 성능 저하를 방지할 수 있습니다.

여러 마이그레이션을 동일한 대상 클러스터로 동시에 실행하지 마세요.

실시간 마이그레이션 프로세스가 동기화되는 동안 대상 클러스터에 대한 애플리케이션의 전환 프로세스를 시작하지 마세요.

클라우드 백업 피하기

Atlas는 라이브 마이그레이션 중에 대상 클러스터의 온디맨드 클라우드 백업 스냅샷 생 성을 중단합니다. 이 페이지의 실시간 마이그레이션 절차에서 컷오버 단계를 완료하면 Atlas는 백업 정책에 따라 클라우드 백업 스냅샷 촬영을 재개합니다.

네임스페이스 변경 방지

마이그레이션 프로세스 중에는 renameCollection 명령을 사용하거나 $out 집계 단계가 포함된 집계 파이프라인을 실행하는 등 네임스페이스를 변경하지 마세요.

선거 피하기

실시간 마이그레이션 프로세스는 일시적인 네트워크 중단과 소스 클러스터 또는 대상 클러스터에서의 투표 기간 동안 마이그레이션을 계속하기 위한 최선의 방법입니다. 다만 이러한 이벤트로 인해 실시간 마이그레이션 프로세스가 실패할 수 있습니다. 실시간 마이그레이션 프로세스가 자동으로 복구되지 않으면 프로세스를 처음부터 다시 시작하세요.

롤링 재시작

마이그레이션 프로세스가 완료되면 클러스터는 각 구성원을 한 번에 하나씩 다시 시작합니다. 이를 롤링 재시작이라고 하며 결과적으로 기본에서 장애 조치가 발생합니다. 원활한 마이그레이션을 보장하려면 데이터를 대상 클러스터로 마이그레이션하기 전에 기본 장애 조치(failover) 테스트 절차를 실행하는 것이 좋습니다.

실시간 마이그레이션 취소

Cancel 을 클릭하여 언제든지 프로세스를 취소할 수 있습니다. Atlas는 cluster에 대한 정상적 액세스가 가능해질 때까지 대상 cluster에 대해 Sharded Cluster Live Import in Progress 메시지를 표시합니다.

완료되기 전에 실시간 마이그레이션 프로세스를 취소하면 Atlas에서 해당 시점까지 마이그레이션된 데이터가 제거되지 않습니다. 대상 클러스터와 동일한 Atlas 클러스터를 사용하여 실시간 마이그레이션 프로세스를 다시 시작하면 Atlas가 해당 클러스터에서 모든 데이터를 지웁니다.

대상 cluster 테스트

대상 클러스터로 데이터를 마이그레이션한 다음, 마이그레이션 프로세스를 중지하고 대상 클러스터를 떠나는 동안 대상 클러스터를 테스트하는 동시에, 소스 클러스터를 실행 중인 상태로 두고 애플리케이션에 데이터를 제공하는 것이 좋습니다.

프로덕션 데이터로 대상 클러스터 를 테스트하려면 테스트 단계까지 마이그레이션 절차 를 따르세요. 전체 마이그레이션 프로세스 를 수행할 준비가 되면 테스트 단계를 건너뛰고 전환 단계로 진행하세요.

마이그레이션 전 체크리스트

실시간 마이그레이션 절차를 시작하기 전에

• 대상 클러스터가 아직 없다면 새 Atlas 배포를 생성하고 필요에 따라 구성하세요. Atlas 클러스터 생성에 대한 전체 설명서는 클러스터 생성 단원을 참조하세요.

• Atlas 클러스터가 배포된 후에는 애플리케이션이 실행되는 모든 클라이언트 하드웨어에서 해당 클러스터로 연결할 수 있는지 확인하세요. 연결 문자열을 테스트하면 가동 중지 시간을 최소화하면서 데이터 마이그레이션 프로세스를 완료할 수 있습니다.

  1. 대표 클라이언트 컴퓨터에 mongosh를 다운로드하여 설치합니다(아직 설치하지 않은 경우).

  2. Atlas UI의 연결 문자열을 사용하여 대상 클러스터에 연결하세요. 자세한 내용은 mongosh통해 연결을 참조하세요.

  대상 클러스터에 연결된 것을 확인하고 나면 실시간 마이그레이션 절차를 시작하세요.

절차