Bekerja dengan replikasi lintas region

Pilih versi dokumentasi: 15.5.4

• 15.5.4

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

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

Sebelum memulai

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

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

Membuat cluster sekunder

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

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 Google Cloud console, buka halaman Clusters.

   Buka Cluster

2. Klik cluster di kolom Resource Name.

3. Di halaman Overview, klik Create secondary cluster.

4. Konfigurasi cluster sekunder Anda:

   1. Di kolom Cluster ID, masukkan ID resource untuk cluster sekunder Anda.
   2. Pilih region untuk cluster sekunder Anda yang berbeda dengan 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 CMEK, ikuti langkah-langkah berikut:

   1. Klik Advanced encryption options.
   2. Pilih Customer-managed encryption key (CMEK).

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

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

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

      1. Klik Don't see your key? Enter key resource name.
      2. Masukkan nama resource di kolom Key resource name.
      3. Klik Save.
      4. Klik Continue.

   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. Konfigurasi instance sekunder Anda:

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

6. Klik Create cluster.

gcloud

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

Gunakan gcloud alloydb clusters create-secondary perintah:

 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 project ID atau nomor project yang dipisahkan koma yang ingin Anda izinkan untuk mengakses 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 cluster dan instance sekunder yang mendukung Private Service Connect, tambahkan flag --enable-private-service-connect saat Anda membuat cluster dan tambahkan flag --allowed-psc-projects untuk menetapkan daftar project ID atau nomor project yang dipisahkan koma yang ingin Anda izinkan untuk mengakses 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 untuk mengakses 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.

Melihat cluster sekunder

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

1. DI Google Cloud console, buka halaman Clusters.

   Buka Cluster

2. Klik cluster sekunder di kolom Resource Name.

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

Memperbarui 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 Google Cloud console, buka halaman Clusters.

   Buka Cluster

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

3. Di halaman Overview, buka Instances in your cluster, pilih instance sekunder, lalu klik Edit secondary.

4. Tambahkan, ubah, atau hapus flag database dari instance Anda:

   Menambahkan flag

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

   Mengubah flag

   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 flag

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

5. Klik Update secondary.

gcloud

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

Perhatian: Menjalankan perintah berikut akan menimpa semua flag database yang ditetapkan sebelumnya. Flag database apa pun yang tidak disertakan secara eksplisit dalam daftar --database-flags akan direset ke nilai defaultnya. Untuk mempertahankan flag database instance Anda sekaligus menambahkan flag baru, Anda harus menyertakan flag saat ini dan flag 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 spesifikasi flag database yang dipisahkan koma. 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 Google Cloud console, buka halaman Clusters.

   Buka Cluster

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

3. Di halaman Overview, buka bagian Instances in your cluster, lalu klik Edit secondary.

   Perhatikan bahwa tindakan ini tidak tersedia jika halaman melaporkan Status cluster sebagai Maintenance. Tindakan ini akan tersedia lagi setelah Status berubah menjadi Ready.

4. Pilih jenis mesin.

5. Klik Update secondary.

gcloud

Gunakan gcloud alloydb instances update perintah 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 perbarui.

• 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, berarti cluster sedang menjalani pemeliharaan rutin. Hal ini untuk sementara tidak mengizinkan konfigurasi ulang instance. Jalankan kembali perintah 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 baca ke cluster sekunder, ikuti langkah-langkah berikut:

1. DI Google Cloud console, buka halaman Clusters.

   Buka Cluster

2. Di kolom Resource Name, klik cluster sekunder yang ingin Anda tambahkan instance kumpulan baca.

3. Di halaman Overview, buka bagian Instances in your cluster, lalu klik Add read pool.

4. Konfigurasi instance kumpulan baca Anda:

   1. Di kolom Read pool instance ID, masukkan ID untuk instance kumpulan baca.
   2. Di kolom Node count, masukkan jumlah node. Jumlah node dalam instance kumpulan baca menentukan kapasitas komputasi keseluruhan instance. Anda dapat memiliki maksimum 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 New database flag.
      3. Berikan nilai untuk flag.
      4. Klik Done.

5. Klik Add read pool.

Mempromosikan cluster sekunder

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

1. Hentikan semua penulisan ke cluster utama.

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

   1. DI Google Cloud console, buka halaman Clusters.

      Buka Cluster

   2. Dalam daftar cluster, klik nama cluster sekunder yang ingin Anda promosikan.

   3. Di halaman detail cluster, klik Monitoring.

   4. Dalam daftar Monitoring, pilih instance sekunder. Instance tersebut akan muncul dalam daftar sebagai Secondary: INSTANCE_NAME.

   5. Dalam daftar metrik, temukan diagram Replication lag from primary instance.

   6. Pastikan diagram menunjukkan penundaan minimal.

      Nilai penundaan 0 adalah yang ideal. Jika penundaan lebih besar dari 0, Anda masih dapat mempromosikan cluster sekunder, dengan risiko kehilangan beberapa transaksi terbaru yang sudah dilakukan di cluster utama.

   7. Dalam daftar metrik, temukan diagram Replication status.

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

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

Konsol

1. DI Google Cloud console, buka halaman Clusters.

   Buka Cluster

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

3. Di halaman Overview, klik Promote cluster.

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

5. Klik Promote.

   Setelah cluster dipromosikan, kolom Type: Secondary cluster (highly available) di halaman Overview akan diperbarui menjadi Type: Highly available with read pools.

gcloud

Gunakan gcloud alloydb clusters promote perintah:

 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 yang menjadi tempat instance utama dan sekunder berada dalam keadaan online dan instance dalam keadaan sehat. Untuk mengetahui informasi selengkapnya, lihat Memantau instance menggunakan AlloyDB dasbor System Insights.

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

• Melihat detail cluster.
• Melihat daftar cluster.