복제본 세트를 Atlas로 라이브 마이그레이션(끌어오기)(MongoDB 6.0.13 이전 버전)

마이그레이션 경로

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

네트워크 액세스

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

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

Atlas는 풀 실시간 마이그레이션 절차를 시작하기 전에 소스 클러스터 및 대상 클러스터에서 유효성 검사를 실행합니다.

• 소스 클러스터는 복제본 세트입니다.

  소스 클러스터가 독립형인 경우pull-type 실시간 마이그레이션을 사용하기 전에먼저 독립형을 복제본 세트로 변환합니다.

• 대상 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 인증을 활성화하지 않고도 풀 실시간 마이그레이션을 사용하여 마이그레이션할 수 있습니다.

소스 클러스터가 다른 인증 메커니즘을 사용하여 연결한다면 mongomirror 를 사용해서 소스 클러스터에서 대상 Atlas 클러스터로 데이터를 마이그레이션할 수 있습니다.

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을 사용합니다. 자세한 내용은 데이터베이스 사용자 구성을 참조하세요.

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

대상 클러스터 구성

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

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

  유럽

  • 프랑크푸르트

  • 아일랜드

  • 런던 (미국)

  미주

  • 미국 동부

  • 미국 서부

  APAC

  • 뭄바이

  • 싱가포르

  • 시드니

  • 도쿄

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

• The destination cluster in Atlas must match or exceed the source deployment in terms of RAM, CPU, and storage. Provision a destination cluster of an adequate size so that it can accommodate both the migration process and the expected workload, or scale up the destination cluster to a tier with more processing power, bandwidth or disk IO.

• 마이그레이션 성능을 극대화하려면 대상 클러스터에 최소한 M40 클러스터를 사용하세요. 대규모 데이터 세트를 마이그레이션할 경우 디스크가 6,000IOPS 이상인 M80 클러스터를 사용하세요.

  마이그레이션 프로세스 기간 동안 대상 Atlas 클러스터의 크기를 일시적으로 늘리도록 선택할 수도 있습니다.

  애플리케이션의 워크로드를 Atlas의 클러스터로 마이그레이션한 후 지원팀에 문의 하여 비용을 최소화하기 위한 대상 클러스터의 추가 성능 조정 및 크기 조정에 대한 도움을 받으세요.

• 예기치 않은 크기 변경을 방지하려면 대상 클러스터에서 자동 확장을 비활성화하세요. 자세한 내용은 클러스터 관리를 참조하세요.

• 무제한 oplog 컬렉션 증가를 방지하고 실시간 마이그레이션의 지연 창이 oplog 복제 지연 창의 경계 내에 유지되도록 하려면 실시간 마이그레이션 프로세스 기간 동안 oplog 크기를 충분히 큰 고정 값으로 설정합니다 .

  자세한 내용은 다음을 참조하세요.

  • 클러스터 확장

  • Atlas 구성 옵션

  • 클러스터 간동기화 문서의 oplog 크기 조정 을 참조하세요.

  이러한 권장 사항을 따른 후에도 성능 문제가 관찰되는 경우 지원팀에 문의하세요.

• 대상 Atlas 클러스터는 복제본 세트여야 합니다.

• M0 (무료 계층) 또는 M2/M5 공유 계층 클러스터는 실시간 마이그레이션의 대상 클러스터로 선택할 수 없습니다.

• 이 페이지의 절차에 따라 클러스터를 MongoDB v6.0 이상으로 마이그레이션할 수는 없습니다.

  소스 및 대상 클러스터가 MongoDB 6 을(를) 실행 중인 경우.0.13 이상에서는 이 절차를 사용하여 Atlas로 실시간 마이그레이션할 수 있습니다.

• Atlas 실시간 마이그레이션이 실행되는 동안에는 플래그를 변경하지 마세요.featureCompatibilityVersion

대상 클러스터에서 워크로드 피하기

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

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

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

클라우드 백업 피하기

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

네임스페이스 변경 방지

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

선거 피하기

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

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

가져오기 프로세스를 시작하기 전에

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

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

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

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

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

절차