마이그레이션을 위한 리소스 구성

이 페이지에서는 마이그레이션을 위해 리소스를 구성하는 마이그레이션 프로세스의 준비 부분을 설명합니다.

이 단계에서는 다음 작업을 수행합니다.

  1. 나중에 마이그레이션 프로세스에서 명령어를 실행하는 데 필요한 명령줄 도구를 설치합니다.
  2. MongoDB 호환성을 갖춘 Firestore 데이터베이스를 구성합니다.
  3. (선택사항) MongoDB 호환 소스에서 작업 로그 (oplog) 설정을 조정합니다.
  4. 중간 데이터 스토리지를 위한 Cloud Storage 버킷을 만듭니다.

IAM 권한 구성

계정에는 이전 프로세스에 사용되는 모든 서비스에 적절한 IAM 역할이 필요합니다.

명령줄 도구 설치

이전 절차에서는 gcloud CLI를 사용하여 이전 단계를 구성하고 실행합니다. 필요한 경우 gcloud CLI 설치 페이지의 안내에 따라 gcloud CLI를 설치합니다.

소스별 구성

Compute Engine으로 구동하는 MongoDB

자체 관리형 클러스터의 Compute Engine VM에서 실행되는 MongoDB 데이터베이스는 일반적으로 공개 인터넷에 노출되지 않습니다. 마이그레이션 절차에서는 Datastream의 Private Service Connect를 사용하여 Datastream 파이프라인을 소스 데이터베이스에 연결합니다.

다음 단계를 따르세요.

  1. 비공개 연결 구성 만들기에 설명된 안내에 따라 Datastream 비공개 연결을 구성합니다.

  2. 생성된 구성의 Configuration ID 매개변수를 확인합니다. 이 값은 나중에 필요한 환경 변수를 설정하는 데 사용됩니다.

Azure Cosmos DB

컴퓨터에 Azure CLI가 설치되어 있는지 확인합니다.

MongoDB 호환성을 갖춘 대상 Firestore 데이터베이스 구성

  1. 프로젝트에 소스 MongoDB 데이터베이스의 데이터를 이전할 MongoDB 호환성을 갖춘 Firestore 데이터베이스가 있는지 확인합니다. 데이터베이스 만들기에 대한 자세한 내용은 데이터베이스 만들기 및 관리를 참고하세요.

  2. 이 이전의 목적으로 SCRAM-SHA-256 인증 프로토콜과 함께 사용할 MongoDB 호환성을 갖춘 Firestore 데이터베이스의 사용자 이름과 비밀번호를 만드는 것이 좋습니다. 이 사용자 이름은 마이그레이션이 완료된 후 안전하게 삭제할 수 있으며, 이러한 사용자 인증 정보를 계속 사용하여 MongoDB 호환성을 갖춘 새 Firestore 데이터베이스에 Mongo 클라이언트를 연결할 수도 있습니다.

이 MongoDB 호환성을 갖춘 Firestore 데이터베이스의 이름과 사용자 인증 정보는 이후 단계에서 사용됩니다.

소스 데이터베이스의 oplog 창 크기 조정

소스 Mongo 데이터베이스의 oplog 기간을 이 데이터베이스에 대한 총 쓰기 트래픽의 3일치로 조정하는 것이 좋습니다. 쓰기 트래픽 비율이 Datastream이 데이터베이스에서 변경사항을 사용할 수 있는 비율을 초과하는 경우 이 조정으로 데이터 손실을 방지할 수 있습니다.

트래픽 패턴과 최대 트래픽 양에 따라 값을 추가로 조정해야 할 수도 있습니다. 예를 들어 일주일 분량의 트래픽이 짧은 기간에 기록되면 변경사항이 oplog 창에서 벗어나기 전에 데이터 스트림이 oplog에서 변경사항을 충분히 빠르게 캡처하지 못할 수 있습니다. 이 경우 oplog 창을 7일 분량의 총 쓰기 트래픽으로 조정해야 할 수 있습니다.

Cloud Storage 버킷 만들기

다음과 같이 새 Cloud Storage 버킷을 만듭니다.

  1. 이전 파이프라인이 실행될 Cloud Storage 리전을 선택합니다. MongoDB 호환성을 갖춘 대상 Firestore 데이터베이스가 있는 리전을 사용하는 것이 좋습니다.

  2. 이 버킷의 이름을 선택합니다. 예: mongo-migration-bucket 이 이름은 이후 단계에서 사용됩니다.

  3. Cloud Storage 문서의 버킷 만들기 페이지에 제공된 안내에 따라 선택한 이름과 선택한 리전으로 새 Cloud Storage 버킷을 만듭니다.

다음 단계

환경 변수 구성으로 진행합니다.