Cluster-to-Cluster Sync 빠른 시작

개요

MongoDB Cluster-to-Cluster Sync 는 MongoDB 클러스터를 연결하고 클러스터 간에 데이터를 동기화할 수 있는 방법을 제공합니다. 연결을 수행하는 도구는 mongosync 입니다. 자세한 내용은 나머지 Cluster-to-Cluster Sync 문서를 참조하세요.

mongosync 두 cluster 간의 데이터를 동기화합니다.

• 각 cluster는 복제본 세트 또는 샤드 cluster일 수 있습니다. 둘 중 하나가 샤드 cluster인 경우 mongosync 에 대한 샤드 cluster 제한 사항 을 참조하세요.

• 샤드 cluster는 동일한 수의 샤드를 보유할 필요가 없습니다.

• 대상 클러스터 는 동일한 버전이거나 소스 클러스터 보다 최대 두 가지 버전 이전이어야 합니다. 최소 패치 버전 요구 사항을 충족하는 한 패치 버전은 중요하지 않습니다.

• 소스 클러스터 는 커밋 이 호출될 때까지 마이그레이션 기간 동안 mongosync 가 소스 클러스터 에 대한 쓰기를 동기화하기 때문에 커밋 될 때까지 활성 상태로 유지될 수 있습니다.

아래 지침에 따라 Cluster-to-Cluster Sync를 설정하고, cluster를 연결하고, 데이터를 동기화하세요.

설정

cluster 연결

mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]

cluster0:
mongodb://clusterAdmin:superSecret@clusterOne01.fancyCorp.com:20020,clusterOne02.fancyCorp.com:20020,clusterOne03.fancyCorp.com:20020
cluster1:
mongodb://clusterAdmin:superSecret@clusterTwo01.fancyCorp.com:20020,clusterTwo02.fancyCorp.com:20020,clusterTwo03.fancyCorp.com:20020

./bin/mongosync \
      --logPath /var/log/mongosync \
      --cluster0 "mongodb://clusterAdmin:superSecret@clusterOne01.fancyCorp.com:20020,clusterOne02.fancyCorp.com:20020,clusterOne03.fancyCorp.com:20020" \
      --cluster1 "mongodb://clusterAdmin:superSecret@clusterTwo01.fancyCorp.com:20020,clusterTwo02.fancyCorp.com:20020,clusterTwo03.fancyCorp.com:20020"

cluster 간 데이터 동기화

시작 엔드포인트는 데이터 동기화를 시작합니다. 동기화를 시작하려면 curl 또는 유사한 프로그램을 사용하여 시작 요청을 실행합니다.

curl localhost:27182/api/v1/start -XPOST \
--data '
   {
      "source": "cluster0",
      "destination": "cluster1"
   } '

시작 요청이 성공하면 mongosync 는 { "success": true } 을 반환하고 소스 cluster의 기존 데이터를 대상 cluster와 동기화하기 시작합니다. 이 시점에서 mongosync 는 RUNNING 상태가 되어 후속 소스 클러스터 쓰기를 대상 클러스터에 적용합니다.

동기화 상태를 확인하려면 진행 엔드포인트를 호출합니다.

curl localhost:27182/api/v1/progress -XGET

progress 응답에 필드 canCommit: true가 포함되면 cluster가 동기화되고 대상 cluster가 소스 클러스터에서 데이터를 계속 복제합니다.

mongosync 의 명령 인터페이스는 HTTP API를 게시하는 HTTP 서버입니다. mongosync 을 제어하려면 API 엔드포인트를 사용합니다. API 설명서에 다음 엔드포인트 사용에 대한 자세한 내용이 나와 있습니다.

전환 프로세스 완료

mongosync 전환 프로세스 를 사용하여 마이그레이션 을 완료하고 애플리케이션 워크로드 를 소스에서 대상 클러스터 로 전송할 수 있습니다.

자세한 내용은 전환 프로세스 완료를 참조하세요.

일회성 동기화

데이터 동기화를 초기화한 후 진행 엔드포인트를 호출하여 동기화 프로세스의 상태를 확인합니다.

curl localhost:27182/api/v1/progress -XGET

일회성 동기화의 경우 progress 응답에 다음 필드 값이 포함되어 있는지 확인합니다.

• state: "RUNNING"

• canCommit: true

• lagTimeSeconds 0 에 가깝습니다(권장, 필수는 아님).

그런 다음 커밋 엔드포인트를 호출하여 동기화 작업을 대상 cluster에 커밋하고 연속 복제를 중지합니다.

curl localhost:27182/api/v1/commit -XPOST --data '{ }'

commit 요청이 성공하면 mongosync 은 { "success": true } 을 반환하고 COMMITTING 상태로 들어갑니다. 동기화가 완료되면 mongosync 이(가) COMMITTED 상태로 전환되어 cluster가 더 이상 지속적으로 동기화되지 않습니다.

데이터 검증

애플리케이션 로드를 소스 클러스터에서 대상으로 전송하기 전에 데이터를 확인하여 동기화에 성공했는지 확인하세요.

자세한 내용은 데이터 전송 확인을 참조하세요.

동기화 참고 사항

• HTTP API 의 기본값 포트는 27182 입니다. --port 옵션을 mongosync 와 함께 사용하여 다른 포트를 구성합니다.

• mongosync 은(는) 소스 cluster와 대상 cluster를 교환하여 역동기화를 활성화할 수 있습니다.

  자세한 내용은 reverse 엔드포인트를 참조하세요.

• mongosync 연결 문자열에 지정된 사용자는 소스 및 대상 cluster에 필요한 권한이 있어야 합니다. 권한은 환경과 쓰기 차단 또는 역동기화를 실행하려는지에 따라 달라집니다.

  사용 사례에 맞는 올바른 사용자 권한을 확인하려면 사용자 권한을 참조하세요 .

• mongosync를 실행 중인 호스트에서 파일 설명자 ulimits를 늘려야 할 수 있습니다. 이는 모든 UNIX 계열 시스템에 적용되지만 특히 macOS의 경우 기본값이 낮습니다. UNIX ulimit 설정을 참조하세요.

• 초기 동기화에 필요한 oplog 의 크기를 추정하려면 oplog 크기 조정을 참조하세요.