Menggunakan replikasi lintas-region

Konsol

1. Di konsol Google Cloud , buka halaman Memorystore untuk Valkey.

   Memorystore for Valkey

2. Klik instance utama. Instance utama adalah induk dari instance sekunder yang Anda buat.

3. Di panel samping, klik tab Instance sekunder.

4. Klik Tambahkan instance sekunder.

5. Di jendela Add secondary instances, lakukan perubahan berikut:

   1. Di kolom Instance ID, masukkan ID instance sekunder yang Anda buat. ID harus terdiri dari 1 hingga 63 karakter dan hanya menggunakan huruf kecil, angka, atau tanda hubung. ID harus diawali dengan huruf kecil, diakhiri dengan huruf kecil atau angka, dan unik di wilayahnya.

   2. Dari menu Region, pilih region tempat Anda ingin instance sekunder berada.

   3. Di bagian Ketersediaan zonal, pilih salah satu opsi berikut:

      • Jika Anda ingin semua shard dan replika instance didistribusikan di tiga zona region tempat Memorystore for Valkey membuat instance, pilih opsi Multi-zona.

        Misalnya, jika region yang Anda pilih adalah us-central1, dan Anda memilih opsi Multi-zone, Memorystore for Valkey akan mendistribusikan shard dan replika instance di seluruh zona us-central1-a, us-central1-b, dan
        us-central1-c. Jika terjadi kegagalan zona, node di instance akan melakukan failover ke replika.

      • Jika Anda ingin semua shard dan replika instance berada di satu zona di region tempat Memorystore for Valkey membuat instance, pilih opsi Single zone, lalu pilih zona dari menu Zone.

        Dengan menggunakan satu zona, Anda dapat mengurangi biaya jaringan. Namun, jika terjadi kegagalan zona, failover tidak akan terjadi.

   4. Dari menu Replica, pilih jumlah replika (per shard) untuk instance. Anda dapat memiliki nol, satu, atau dua replika.

   5. Dari menu Network, pilih jaringan untuk instance. Untuk mengetahui informasi selengkapnya tentang jaringan untuk Memorystore for Valkey, lihat Jaringan.

6. Klik Tambahkan instance sekunder.

gcloud

Untuk membuat instance sekunder, gunakan perintah gcloud memorystore instances create.

gcloud memorystore instances create INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--cross-instance-replication-config-role=secondary \
--psc-auto-connections=network=NETWORK,projectId=PROJECT_ID \
--primary-instance=PRIMARY_INSTANCE_PATH

Lakukan penggantian berikut:

• INSTANCE_ID: ID instance sekunder yang Anda buat. ID harus terdiri dari 1 hingga 63 karakter dan hanya menggunakan huruf kecil, angka, atau tanda hubung. ID harus diawali dengan huruf kecil, diakhiri dengan huruf kecil atau angka, dan unik di wilayahnya.
• PROJECT_ID: ID project tempat Anda ingin membuat instance sekunder. Project ini adalah project yang sama dengan tempat instance utama Anda berada.
• REGION_ID: ID region tempat Anda ingin menempatkan instance sekunder.
• NETWORK: jaringan yang digunakan untuk membuat instance. Formatnya harus seperti ini: projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID. ID jaringan harus cocok dengan ID jaringan yang digunakan oleh kebijakan koneksi layanan. Jika tidak, Anda tidak dapat membuat instance sekunder.
• PRIMARY_INSTANCE_PATH: jalur instance utama. Contoh: projects/my-project/locations/us-central1/instances/my-primary-instance. Anda dapat memilih instance apa pun di project Anda sebagai instance utama selama instance tersebut bukan instance sekunder.

Contoh:

gcloud memorystore instances create my-secondary-instance \
--project=my-project \
--location=us-central1 \
--cross-instance-replication-config-role=secondary \
--psc-auto-connections=network=projects/my-project/global/networks/default,projectId=my-project \
--primary-instance=projects/my-project/locations/us-central1/instances/my-primary-instance

Konsol

1. Di konsol Google Cloud , buka halaman Memorystore untuk Valkey.

   Memorystore for Valkey

2. Klik panah peluas di samping instance utama. Instance ini adalah induk dari instance sekunder yang informasinya ingin Anda lihat.

3. Klik instance sekunder. Informasi ringkasan tentang instance akan muncul.

gcloud

Untuk melihat informasi tentang instance sekunder, termasuk kolom keanggotaan yang mencantumkan instance primer dan sekunder dalam grup replikasi, gunakan perintah gcloud memorystore instances describe.

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

Lakukan penggantian berikut:

• INSTANCE_ID: ID instance sekunder
• PROJECT_ID: ID project yang berisi instance sekunder
• REGION_ID: ID region tempat instance sekunder berada

Konsol

1. Di konsol Google Cloud , buka halaman Memorystore untuk Valkey.

   Memorystore for Valkey

2. Klik panah peluas di samping instance utama. Instance ini adalah parent dari instance sekunder yang ingin Anda alihkan.

3. Klik instance sekunder.

4. Klik Promosikan ke Primer.

5. Dalam dialog Promote secondary instance to primary?, masukkan ID instance sekunder, lalu klik Promote.

Setelah pengalihan selesai, Anda harus menghubungkan kembali aplikasi ke instance utama yang baru.

gcloud

Untuk melakukan pengalihan, gunakan perintah gcloud memorystore instances update.

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--clear-primary-instance \
--cross-instance-replication-config-role=primary \
--cross-instance-replication-config-secondary-instances=[instance=SECONDARY_INSTANCE_PATH]

Lakukan penggantian berikut:

• INSTANCE_ID: ID instance sekunder yang ingin Anda promosikan menjadi instance primer dengan melakukan pengalihan.
• PROJECT_ID: ID project yang berisi instance sekunder.
• REGION_ID: ID region tempat instance sekunder berada.

• SECONDARY_INSTANCE_PATH: jalur instance sekunder. Contoh: projects/my-project/locations/us-central1/instances/my-secondary-instance.

  Jika Anda memiliki beberapa instance sekunder, pisahkan setiap instance dengan koma. Misalnya: [instance=projects/my-project/locations/us-central1/instances/my-first-secondary-instance,instance=projects/my-project/locations/europe-west1/instances/my-second-secondary-instance].

Misalnya, Anda memiliki instance berikut yang ada dalam project my-project:

• instance-1: instance utama ini berada di region us-east1.
• instance-2: instance sekunder ini berada di region asia-east1.
• instance-3: instance sekunder ini berada di region southamerica-east1.

Anda ingin membalikkan peran instance-1 dan instance-2 sehingga instance-2 menjadi instance utama baru dan instance-1 menjadi instance sekunder.

Untuk melakukannya, gunakan kode berikut:

gcloud memorystore instances update instance-2 \
--project=my-project \
--location=asia-east1 \
--clear-primary-instance \
--cross-instance-replication-config-role=primary \
--cross-instance-replication-config-secondary-instances=[instance=projects/my-project/locations/us-east1/instances/instance-1,instance=projects/my-project/locations/southamerica-east1/instances/instance-3]

Setelah pengalihan selesai, Anda harus menghubungkan kembali aplikasi ke instance utama yang baru.

Konsol

1. Di konsol Google Cloud , buka halaman Memorystore untuk Valkey.

   Memorystore for Valkey

2. Klik instance utama. Ini adalah induk instance sekunder yang Anda lepaskan dari instance utama.

3. Di panel samping, klik tab Instance sekunder.

4. Pilih kotak centang di samping ID instance sekunder yang Anda lepaskan dari instance utama.

5. Klik Lepaskan dari Primer.

6. Pada dialog Lepaskan instance sekunder?, masukkan ID instance sekunder, lalu klik Lepaskan.

gcloud

Untuk melepaskan instance sekunder, gunakan perintah gcloud memorystore instances update.

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--cross-instance-replication-config-role=none \
--clear-primary-instance

Ganti kode berikut:

• INSTANCE_ID: ID instance sekunder yang ingin Anda lepas
• PROJECT_ID: ID project yang berisi instance sekunder
• REGION_ID: region tempat instance sekunder berada

Konsol

1. Di konsol Google Cloud , buka halaman Memorystore untuk Valkey.

   Memorystore for Valkey

2. Klik instance utama. Ini adalah induk instance sekunder yang Anda lepaskan dari instance utama.

3. Di panel samping, klik tab Instance sekunder.

4. Centang kotak di samping ID instance sekunder yang Anda lepaskan dari instance utama.

5. Klik Lepaskan dari Primer.

6. Dalam dialog Lepaskan instance sekunder?, lakukan hal berikut:

   1. Masukkan ID instance sekunder. Gunakan koma untuk memisahkan ID.

   2. Klik Detach.

gcloud

Untuk melepaskan beberapa instance sekunder, gunakan perintah gcloud memorystore instances update.

gcloud memorystore instances update PRIMARY_INSTANCE_ID \
--project=PROJECT_ID \
--location=PRIMARY_INSTANCE_REGION_ID \
--remove-cross-instance-replication-config-secondary-instances=[instance=SECONDARY_INSTANCES] \
--cross-instance-replication-config-role=none

Lakukan penggantian berikut:

• PRIMARY_INSTANCE_ID: ID instance utama.
• PROJECT_ID: ID project yang berisi instance sekunder.
• PRIMARY_INSTANCE_REGION_ID: ID region tempat instance utama berada.
• SECONDARY_INSTANCES: instance sekunder yang ingin Anda lepaskan. Gunakan koma untuk memisahkan ID instance. Setiap instance sekunder harus memiliki format ini: projects/PROJECT_ID/locations/SECONDARY_INSTANCE_REGION_ID/instances/INSTANCE_ID.

Contoh:

gcloud memorystore instances update my-primary-instance \
--project=my-project \
--location=us-central1 \
--remove-cross-instance-replication-config-secondary-instances=[instance=projects/my-project/locations/us-west4/instances/my-secondary-instance-1,instance=projects/my-project/locations/asia-southeast2/instances/my-secondary-instance-2] \
--cross-instance-replication-config-role=none

Anda juga dapat melepaskan instance sekunder dari instance utama dengan menentukan daftar instance yang tidak ingin Anda lepaskan. Memorystore for Valkey melepaskan instance apa pun yang tidak Anda sertakan dalam daftar ini.

Misalkan Anda memiliki instance sekunder berikut:

• instance-1: instance ini berada di region us-east1.
• instance-2: instance ini berada di region asia-east1.

Anda ingin melepaskan kedua instance sekunder dari my-primary-instance. Instance utama ini berada di region us-central1 dan ada dalam project my-project.

Untuk melepaskan instance sekunder, gunakan kode berikut:

gcloud memorystore instances update my-primary-instance \
--project=my-project \
--location=us-central1 \
--cross-instance-replication-config-secondary-instances=[]
--cross-instance-replication-config-role=none

Untuk contoh ini, karena nilai [] null ditetapkan ke parameter --cross-instance-replication-config-secondary-instances, Memorystore for Valkey melepaskan semua instance sekunder dari instance primer.