Menggunakan replikasi lintas-region

Halaman ini menjelaskan cara menggunakan replikasi lintas-region dengan membuat dan menggunakan cluster sekunder.

Untuk ringkasan konseptual tentang replikasi lintas-region, lihat Tentang replikasi lintas-region.

Catatan: Anda tidak dapat mengaktifkan analisis kueri yang ditingkatkan untuk AlloyDB pada instance di cluster replika lintas region. Lihat Batasan dan FAQ untuk mengetahui informasi selengkapnya.

Sebelum memulai

• Project Google Cloud yang Anda gunakan harus telah diaktifkan untuk mengakses AlloyDB.
• Anda harus memiliki salah satu peran IAM berikut di project Google Cloud yang Anda gunakan:
  • roles/alloydb.admin (peran IAM bawaan AlloyDB Admin)
  • roles/owner (peran IAM dasar Pemilik)
  • roles/editor (peran IAM dasar Editor)

  Jika Anda tidak memiliki salah satu peran ini, hubungi Administrator Organisasi untuk meminta akses.

Membuat cluster sekunder

Saat Anda membuat cluster sekunder, AlloyDB akan menyalin dan menerapkan beberapa konfigurasi cluster utama, termasuk pemulihan point-in-time (PITR) dan konfigurasi cadangan, ke cluster sekunder. AlloyDB tidak menambahkan instance kumpulan baca ke cluster sekunder setelah membuatnya, berapa pun jumlah instance kumpulan baca yang ada di cluster primer.

Jika Anda memperbarui konfigurasi cluster utama setelah membuat cluster sekunder, perubahan tersebut tidak akan tersedia di cluster sekunder. Namun, Anda dapat memperbarui cluster sekunder secara manual agar memiliki konfigurasi terbaru yang tersedia di cluster utama.

Untuk membuat cluster sekunder dan instance sekunder AlloyDB, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud, buka halaman Clusters.

   Buka Cluster

2. Klik cluster di kolom Resource Name.

3. Di halaman Ringkasan, klik Buat cluster sekunder.

4. Konfigurasikan cluster sekunder Anda:

   1. Di kolom Cluster ID, masukkan ID resource untuk cluster sekunder Anda.
   2. Pilih region untuk cluster sekunder yang berbeda dari region cluster utama.
   3. Pilih enkripsi yang dikelola Google default atau kunci yang dikelola pelanggan (CMEK) sebagai metode enkripsi untuk mengenkripsi cluster sekunder Anda.

   Jika Anda ingin mengenkripsi cluster ini menggunakan kunci CMEK, ikuti langkah-langkah berikut:

   1. Klik Advanced encryption options.
   2. Pilih Kunci enkripsi yang dikelola pelanggan (CMEK).

   3. Pilih kunci yang dikelola pelanggan dari menu yang muncul.

      Konsol Google Cloud membatasi daftar ini untuk kunci dalam project dan regionGoogle Cloud yang sama dengan cluster baru.

      Untuk menggunakan kunci yang tidak ada dalam daftar ini, ikuti langkah-langkah berikut:

      1. Klik Tidak melihat kunci Anda? Masukkan nama resource kunci.
      2. Masukkan nama resource di kolom Key resource name.
      3. Klik Save.
      4. Klik Lanjutkan.

   Penggunaan kunci CMEK dengan AlloyDB memerlukan beberapa penyiapan tambahan. Untuk mengetahui informasi selengkapnya, lihat Menggunakan CMEK.

   Jika instance utama terkait dienkripsi dengan kunci CMEK, Anda juga harus mengenkripsi cluster sekundernya dengan kunci CMEK.

5. Konfigurasikan instance sekunder Anda:

   1. Di kolom Instance ID, masukkan ID resource untuk instance sekunder Anda. ID resource harus unik dalam cluster.

6. Klik Buat kluster.

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau menggunakan Cloud Shell.

Gunakan perintah gcloud alloydb clusters create-secondary:

 gcloud alloydb clusters create-secondary SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --primary-cluster=projects/PROJECT_ID/locations/LOCATION_ID/clusters/ PRIMARY_CLUSTER_ID \
 gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \
 --cluster=SECONDARY_CLUSTER_ID \
 --region=REGION_ID

Ganti kode berikut:

• SECONDARY_CLUSTER_ID: ID cluster sekunder yang ingin Anda buat.
• SECONDARY_INSTANCE_ID: ID instance sekunder yang ingin Anda buat.
• REGION_ID: ID region cluster sekunder—misalnya, us-central1.
• PROJECT_ID: ID project cluster sekunder.
• LOCATION_ID: Lokasi cluster utama Anda—misalnya, us-central1.
• PRIMARY_CLUSTER_ID: ID cluster utama yang terkait dengan cluster sekunder.
• SECONDARY_CLUSTER_ID: ID cluster sekunder yang terkait dengan instance sekunder.
• ALLOWED_PROJECT (Opsional): Daftar yang dipisahkan koma project ID atau nomor project yang ingin Anda izinkan akses ke instance—misalnya, my-project-1, 12345,my-project-n. Anda harus menetapkan daftar project atau nomor yang diizinkan, jika cluster Anda menggunakan Private Service Connect sebagai metode untuk terhubung ke instance.
• --no-enable-automated-backup(Opsional): Nonaktifkan pembuatan pencadangan otomatis di cluster sekunder.

Untuk membuat cluster dan instance sekunder yang mengaktifkan Private Service Connect, tambahkan tanda --enable-private-service-connect saat Anda membuat cluster dan tambahkan tanda --allowed-psc-projects untuk menetapkan daftar project ID atau nomor project yang dipisahkan koma yang ingin Anda izinkan aksesnya ke instance—misalnya, my-project-1, 12345,my-project-n.

 gcloud alloydb clusters create-secondary SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --primary-cluster=projects/PROJECT_ID/locations/LOCATION_ID/clusters/ PRIMARY_CLUSTER_ID \
 --enable-private-service-connect
 gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \
 --cluster=SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --allowed-psc-projects=ALLOWED_PROJECT_LIST

Ganti kode berikut:

• ALLOWED_PROJECT (Opsional): Daftar project ID atau nomor project yang dipisahkan koma yang ingin Anda izinkan aksesnya ke instance—misalnya,my-project-1, 12345,my-project-n. Anda harus menetapkan daftar project atau nomor yang diizinkan, jika cluster Anda menggunakan Private Service Connect sebagai metode untuk terhubung ke instance.

Untuk membuat instance sekunder bagi cluster yang mengaktifkan IP publik, tambahkan parameter --assign-inbound-public-ip=ASSIGN_IPV4.

 gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \
 --cluster=SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
  --assign-inbound-public-ip=ASSIGN_IPV4

Secara opsional, teruskan daftar blok CIDR yang dipisahkan koma, seperti 64.233.160.0/16 ke parameter --authorized-external-networks untuk menetapkan jaringan eksternal yang diizinkan di instance Anda.

Melihat cluster sekunder

Untuk melihat informasi mendetail tentang cluster sekunder AlloyDB, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Clusters.

   Buka Cluster

2. Klik cluster sekunder di kolom Nama Resource.

3. Di halaman Ringkasan, lihat semua detail tentang cluster sekunder Anda.

Mengupdate instance sekunder

Anda dapat memperbarui instance sekunder untuk menambahkan, mengubah, atau menghapus flag database. Anda juga dapat menskalakan jenis mesin instance sekunder.

Mengonfigurasi flag database pada instance sekunder

Untuk menambahkan, mengubah, atau menghapus flag database, selesaikan langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud, buka halaman Clusters.

   Buka Cluster

2. Di kolom Resource Name, klik cluster sekunder yang ingin Anda ubah.

3. Di halaman Ringkasan, buka Instance di cluster Anda, pilih instance sekunder, lalu klik Edit sekunder.

4. Menambahkan, mengubah, atau menghapus flag database dari instance Anda:

   Menambahkan tanda

   1. Untuk menambahkan flag database ke instance, klik Add flag.
   2. Pilih flag dari daftar Flag database baru.
   3. Berikan nilai untuk flag.
   4. Klik Done.

   Mengubah tanda

   1. Untuk mengubah flag database yang ada di instance Anda, luaskan flag database dan ubah nilai flag yang ada di bagian Edit database flag.
   2. Klik Done.

   Menghapus tanda

   1. Untuk menghapus tanda database dari instance Anda, pilih tanda, lalu klik ikon hapus.
   2. Klik Done.

5. Klik Perbarui sekunder.

gcloud

Gunakan perintah gcloud alloydb instances update untuk mengubah flag database untuk instance sekunder.

Perhatian: Menjalankan perintah berikut akan menimpa semua flag database yang telah ditetapkan sebelumnya. Setiap flag database yang tidak disertakan secara eksplisit dalam daftar --database-flags akan direset ke nilai defaultnya. Untuk mempertahankan flag database instance saat menambahkan flag baru, Anda harus menyertakan flag saat ini dan baru dalam daftar --database-flags.

 gcloud alloydb instances update SECONDARY_INSTANCE_ID \
  --database-flags FLAGS_LIST \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --project=PROJECT_ID

Ganti kode berikut:

• SECONDARY_INSTANCE_ID: ID instance sekunder.
• FLAGS_LIST: Daftar yang dipisahkan koma dari satu atau beberapa spesifikasi flag database. Setiap spesifikasi terdiri dari nama flag, tanda sama dengan (=), dan nilai yang akan ditetapkan ke flag. Untuk flag database yang tidak menggunakan nilai, berikan nama flag yang diikuti dengan tanda sama dengan (=).
• REGION_ID: Region tempat instance sekunder ditempatkan—misalnya, us-central1.
• CLUSTER_ID: ID cluster tempat instance sekunder ditempatkan.
• PROJECT_ID: ID project tempat cluster sekunder ditempatkan.

Menskalakan jenis mesin instance sekunder

Untuk menskalakan jenis mesin instance sekunder, selesaikan langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud, buka halaman Clusters.

   Buka Cluster

2. Di kolom Resource Name, klik cluster sekunder yang ingin Anda ubah.

3. Di halaman Ringkasan, buka bagian Instance in your cluster, lalu klik Edit secondary.

   Perhatikan bahwa tindakan ini tidak tersedia jika halaman melaporkan Status cluster Pemeliharaan. Tindakan akan tersedia lagi setelah Status berubah menjadi Siap.

4. Pilih jenis mesin.

5. Klik Perbarui sekunder.

gcloud

Gunakan perintah gcloud alloydb instances update untuk mengubah jenis mesin instance sekunder.

 gcloud alloydb instances update SECONDARY_INSTANCE_ID \
  --cpu-count=CPU_COUNT \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --project=PROJECT_ID

Ganti kode berikut:

• SECONDARY_INSTANCE_ID: ID instance sekunder yang Anda update.

• CPU_COUNT: Jumlah vCPU yang Anda inginkan untuk instance. Nilai yang valid mencakup:

  • 2 (2 vCPU, RAM 16 GB)
  • 4 (4 vCPU, RAM 32 GB)
  • 8 (8 vCPU, RAM 64 GB)
  • 16 (16 vCPU, RAM 128 GB)
  • 32 (32 vCPU, RAM 256 GB)
  • 64 (64 vCPU, RAM 512 GB)

• REGION_ID: Region tempat instance ditempatkan.

• CLUSTER_ID: ID cluster tempat instance ditempatkan.

• PROJECT_ID: ID project tempat cluster ditempatkan.

Jika perintah menampilkan pesan error yang menyertakan frasa invalid cluster state MAINTENANCE, cluster sedang menjalani pemeliharaan rutin. Tindakan ini akan melarang konfigurasi ulang instance untuk sementara. Jalankan perintah lagi setelah cluster kembali ke status READY.

Untuk memeriksa status cluster, lihat Melihat detail cluster.

Menambahkan instance kumpulan baca ke cluster sekunder

Untuk menambahkan instance kumpulan operasi baca ke cluster sekunder, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Clusters.

   Buka Cluster

2. Di kolom Resource Name, klik cluster sekunder tempat Anda ingin menambahkan instance kumpulan operasi baca.

3. Di halaman Ringkasan, buka bagian Instance in your cluster, lalu klik Add read pool.

4. Konfigurasikan instance kumpulan operasi baca:

   1. Di kolom Read pool instance ID, masukkan ID untuk instance kumpulan operasi baca.
   2. Di kolom Jumlah node, masukkan jumlah node. Jumlah node dalam instance kumpulan operasi baca menentukan kapasitas komputasi keseluruhan instance. Anda dapat memiliki maksimal 20 node di semua instance kumpulan baca dalam cluster.
   3. Pilih jenis mesin.

   4. Opsional: Tetapkan flag kustom ke instance Anda. Untuk setiap flag, lakukan hal berikut:

      1. Klik Add flag.
      2. Pilih flag dari daftar Flag database baru.
      3. Berikan nilai untuk flag.
      4. Klik Done.

5. Klik Tambahkan kumpulan baca.

Mempromosikan cluster sekunder

Sebelum Anda mempromosikan cluster sekunder, lakukan langkah-langkah berikut untuk memverifikasi bahwa cluster sekunder telah menerapkan semua transaksi yang diterima dari cluster utama:

1. Menghentikan semua penulisan ke cluster utama.

2. Periksa status replikasi cluster sekunder dengan menyelesaikan langkah-langkah berikut:

   1. Di konsol Google Cloud, buka halaman Clusters.

      Buka Cluster

   2. Di daftar cluster, klik nama cluster sekunder yang ingin dipromosikan.

   3. Di halaman detail cluster, klik Monitoring.

   4. Dalam daftar Monitoring, pilih instance sekunder. Nama ini akan muncul dalam daftar sebagai Sekunder: INSTANCE_NAME.

   5. Dalam daftar metrik, temukan diagram Jeda replikasi dari instance utama.

   6. Pastikan diagram menunjukkan jeda minimal.

      Nilai jeda 0 adalah ideal. Jika jeda lebih besar dari 0, Anda masih dapat mempromosikan cluster sekunder, dengan risiko kehilangan beberapa transaksi terbaru yang telah di-commit di cluster utama.

   7. Dalam daftar metrik, temukan diagram Status replikasi.

   8. Pastikan semua node yang direpresentasikan dalam diagram memiliki nilai streaming.

Untuk mempromosikan cluster sekunder ke cluster primer, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud, buka halaman Clusters.

   Buka Cluster

2. Di kolom Resource Name, klik cluster sekunder yang ingin Anda promosikan sebagai cluster utama.

3. Di halaman Ringkasan, klik Promosikan cluster.

4. Pada dialog yang muncul, masukkan ID cluster sekunder untuk mengonfirmasi bahwa Anda ingin mempromosikan cluster.

5. Klik Promote.

   Setelah cluster dipromosikan, kolom Jenis: Cluster sekunder (sangat tersedia) di halaman Ringkasan akan diperbarui menjadi Jenis: Sangat tersedia dengan kumpulan baca.

gcloud

Gunakan perintah gcloud alloydb clusters promote:

 gcloud alloydb clusters promote SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --project=PROJECT_ID \

Ganti kode berikut:

• SECONDARY_CLUSTER_ID: ID cluster sekunder yang ingin Anda promosikan.
• REGION_ID: ID region cluster sekunder—misalnya,us-central1.
• PROJECT_ID: ID project cluster sekunder.

Melakukan pengalihan

Sebelum melakukan pengalihan, pastikan kedua region tempat instance utama dan sekunder berada sedang online dan instance tersebut dalam status yang baik. Untuk informasi selengkapnya, lihat Memantau instance menggunakan dasbor Insight Sistem AlloyDB.

Gunakan perintah gcloud alloydb clusters switchover:

   gcloud alloydb clusters switchover SECONDARY_CLUSTER_ID \
   --region=REGION_ID \
   --project=PROJECT_ID \

Ganti kode berikut:

• SECONDARY_CLUSTER_ID: ID cluster sekunder yang ingin Anda promosikan.
• REGION_ID: ID region cluster sekunder—misalnya, us-central1.
• PROJECT_ID: ID project cluster sekunder.

Langkah Berikutnya

• Lihat detail cluster.
• Lihat daftar cluster.