Mengonfigurasi resource untuk migrasi

Halaman ini menjelaskan bagian persiapan dari proses migrasi tempat Anda mengonfigurasi resource untuk migrasi.

Pada tahap ini, Anda akan melakukan hal berikut:

  1. Instal alat command line yang diperlukan untuk menjalankan perintah pada tahap selanjutnya dalam proses migrasi.
  2. Konfigurasi database Firestore dengan kompatibilitas MongoDB.
  3. (Opsional) Sesuaikan setelan log operasi (oplog) di sumber yang kompatibel dengan MongoDB.
  4. Buat bucket Cloud Storage untuk penyimpanan data perantara.

Mengonfigurasi Izin IAM

Akun Anda memerlukan peran IAM yang sesuai di semua layanan yang digunakan dalam proses migrasi:

Menginstal alat command line

Prosedur migrasi menggunakan gcloud CLI untuk mengonfigurasi dan mengaktifkan langkah-langkah migrasi. Jika diperlukan, instal gcloud CLI dengan mengikuti petunjuk di halaman Menginstal gcloud CLI.

Konfigurasi khusus sumber

MongoDB di Compute Engine

Database MongoDB yang berjalan di VM Compute Engine dalam cluster yang dikelola sendiri biasanya tidak diekspos ke internet publik. Prosedur migrasi akan menggunakan Private Service Connect di Datastream untuk menghubungkan pipeline Datastream ke database sumber Anda.

Lakukan tindakan berikut:

  1. Konfigurasi Konektivitas Pribadi Datastream dengan mengikuti petunjuk yang diuraikan dalam Membuat konfigurasi konektivitas pribadi.

  2. Catat parameter Configuration ID dari konfigurasi yang dibuat. Anda akan menggunakannya di tahap selanjutnya untuk menyiapkan variabel lingkungan yang diperlukan.

Azure Cosmos DB

Pastikan Azure CLI diinstal di komputer Anda.

Amazon DocumentDB

Cluster Amazon DocumentDB tidak dapat diakses secara langsung dari luar jaringan VPC Amazon. Untuk terhubung ke cluster DocumentDB, Anda harus menyediakan instance EC2 dalam jaringan Amazon VPC, dan menggunakan instance tersebut sebagai Bastion Host untuk tunnel SSH.

Buka panduan developer Menghubungkan ke cluster Amazon DocumentDB dari luar Amazon VPC untuk mendapatkan petunjuk tentang cara menyiapkan instance EC2 untuk konektivitas eksternal ke DocumentDB.

Untuk membuat koneksi ke cluster DocumentDB, Anda harus mendapatkan kunci SSH pribadi untuk instance EC2 serta Paket Sertifikat yang sesuai untuk region tempat cluster Anda di-deploy. Buka halaman resource Paket sertifikat menurut Wilayah AWS untuk mendownload paket yang sesuai dalam format PEM.

Perhatikan bahwa Paket Sertifikat berisi beberapa sertifikat. Anda harus mengekstrak satu sertifikat untuk menyiapkan koneksi Datastream. Sebaiknya Anda memvalidasi konektivitas DocumentDB secara manual untuk memastikan bahwa Anda memiliki kunci SSH yang valid dan sertifikat DocumentDB yang valid dari paket regional. Panduan developer DocumentDB memberikan contoh command line untuk membuat koneksi langsung dari luar VPC.

Mengonfigurasi database Firestore dengan kompatibilitas MongoDB tujuan

  1. Pastikan project Anda memiliki database Firestore dengan kompatibilitas MongoDB tempat Anda akan memigrasikan data dari database Mongo sumber. Untuk mengetahui informasi selengkapnya tentang cara membuat database, lihat Membuat dan mengelola database.

  2. Untuk tujuan migrasi ini, sebaiknya buat nama pengguna dan sandi untuk database Firestore dengan kompatibilitas MongoDB yang akan digunakan dengan protokol autentikasi SCRAM-SHA-256. Nama pengguna ini dapat dihapus dengan aman setelah migrasi selesai, atau Anda dapat memilih untuk terus menggunakan kredensial ini untuk menghubungkan klien Mongo ke database Firestore dengan kompatibilitas MongoDB yang baru.

Anda akan menggunakan nama database Firestore dengan kompatibilitas MongoDB ini dan kredensial pengguna di langkah-langkah selanjutnya.

Menyesuaikan ukuran jendela oplog database sumber

Sebaiknya sesuaikan periode oplog database Mongo sumber Anda menjadi 3 hari total traffic tulis ke database ini. Jika kecepatan traffic tulis melebihi kecepatan Datastream dalam menggunakan perubahan dari database Anda, penyesuaian ini akan mencegah kehilangan data.

Nilai mungkin perlu disesuaikan lebih lanjut, bergantung pada pola traffic dan volume traffic puncak. Misalnya, jika traffic selama seminggu ditulis dalam jangka waktu singkat, Datastream mungkin tidak dapat merekam perubahan dari oplog dengan cukup cepat sebelum perubahan keluar dari periode oplog. Dalam hal ini, Anda mungkin perlu mengubah ukuran jendela oplog menjadi total traffic tulis selama 7 hari.

Membuat bucket Cloud Storage

Buat bucket Cloud Storage baru dengan cara berikut:

  1. Pilih region Cloud Storage tempat pipeline migrasi akan berjalan. Sebaiknya gunakan region tempat database tujuan Firestore dengan kompatibilitas MongoDB berada.

  2. Pilih nama untuk bucket ini. Contoh: mongo-migration-bucket. Anda akan menggunakan nama ini pada langkah-langkah selanjutnya.

  3. Buat bucket Cloud Storage baru dengan nama yang dipilih dan di region yang dipilih dengan mengikuti petunjuk yang diberikan di halaman Membuat bucket dalam dokumentasi Cloud Storage.

Langkah berikutnya

Lanjutkan ke Mengonfigurasi variabel lingkungan.