Mengelola grup konsistensi

---

Dokumen ini menjelaskan cara mengelola grup konsistensi. Grup konsistensi adalah kebijakan resource yang menyelaraskan replikasi di beberapa disk di region atau zona yang sama.

Untuk mempelajari grup konsistensi lebih lanjut, lihat Tentang Replikasi Asinkron Persistent Disk.

Batasan

• Grup konsistensi tidak didukung untuk disk di sole-tenant node.
• Grup konsistensi dapat memiliki maksimum 128 disk.
• Semua disk dalam grup konsistensi harus berada dalam project yang sama dengan kebijakan resource grup konsistensi.
• Semua disk dalam grup konsistensi harus berada di zona yang sama, untuk disk zona, atau dalam pasangan zona yang sama, untuk disk regional.
• Grup konsistensi dapat berisi disk utama atau disk sekunder, tetapi tidak keduanya.
• Anda tidak dapat menambahkan atau menghapus disk utama ke atau dari grup konsistensi saat disk sedang direplikasi. Jika ingin menambahkan atau menghapus disk utama ke atau dari grup konsistensi, Anda harus menghentikan replikasi terlebih dahulu. Anda dapat menambahkan atau menghapus disk sekunder ke atau dari grup konsistensi kapan saja.
• Anda dapat memasang maksimal 16 disk yang berada dalam grup konsistensi yang berbeda, atau disk yang tidak berada dalam grup konsistensi ke VM. Disk yang berada dalam grup konsistensi yang sama dihitung sebagai satu disk terhadap batas 16 disk.

Sebelum memulai

• Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.
  

  Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

  Konsol

  Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.

  gcloud

  1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:

     gcloud init

     Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi baru dengan menjalankan gcloud components update.
  2. Menetapkan region dan zona default.

  REST

  Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

  Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:

  gcloud init

Membuat grup konsistensi

Jika Anda perlu menyelaraskan replikasi di beberapa disk, buat grup konsistensi di region yang sama dengan disk utama. Jika Anda perlu menyelaraskan clone disk, buat grup konsistensi di region yang sama dengan disk sekunder.

Buat grup konsistensi menggunakan Konsol Google Cloud, Google Cloud CLI, atau REST.

Konsol

Buat grup konsistensi dengan melakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Replikasi asinkron.

   Buka Replikasi asinkron

2. Klik tab Grup konsistensi.

3. Klik Buat grup konsistensi.

4. Di kolom Nama, masukkan nama untuk grup konsistensi.

5. Di kolom Region, pilih region tempat disk Anda berada. Jika Anda ingin menambahkan disk utama ke grup konsistensi, pilih region utama. Jika Anda ingin menambahkan disk sekunder ke grup konsistensi, pilih region sekunder.

6. Klik Create.

gcloud

Buat grup konsistensi menggunakan perintah gcloud compute resource-policies create disk-consistency-group:

gcloud compute resource-policies create disk-consistency-group CONSISTENCY_GROUP_NAME \
    --region=REGION

Ganti kode berikut:

• CONSISTENCY_GROUP_NAME: nama untuk grup konsistensi.
• REGION: region untuk grup konsistensi. Jika Anda ingin menambahkan disk utama ke grup konsistensi, gunakan region utama. Jika Anda ingin menambahkan disk sekunder ke grup konsistensi, gunakan region sekunder.

REST

Buat grup konsistensi menggunakan metode resourcePolicies.insert:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies
{
 "name": "CONSISTENCY_GROUP_NAME",
 "diskConsistencyGroupPolicy": {
  }
}

Ganti kode berikut:

• PROJECT: project yang berisi grup konsistensi.
• REGION: region untuk grup konsistensi. Jika Anda ingin menambahkan disk utama ke grup konsistensi, gunakan region yang sama dengan disk utama. Jika Anda ingin menambahkan disk sekunder ke grup konsistensi, gunakan region yang sama dengan disk sekunder.
• CONSISTENCY_GROUP_NAME: nama untuk grup konsistensi.

Melihat disk dalam grup konsistensi

Lihat disk dalam grup konsistensi menggunakan Konsol Google Cloud, Google Cloud CLI, atau REST.

Konsol

Lihat disk yang disertakan dalam grup konsistensi dengan melakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Replikasi asinkron.

   Buka Replikasi asinkron

2. Klik tab Grup konsistensi.

3. Klik nama grup konsistensi yang ingin Anda lihat disknya. Halaman Kelola grup konsistensi akan terbuka.

4. Lihat bagian Consistency group members untuk melihat semua disk yang disertakan dalam grup konsistensi.

gcloud

Lihat disk yang disertakan dalam grup konsistensi menggunakan perintah gcloud compute disks list:

gcloud compute disks list \
    --LOCATION_FLAG=LOCATION \
    --filter=resourcePolicies=CONSISTENCY_GROUP_NAME

Ganti kode berikut:

• LOCATION_FLAG: flag lokasi untuk disk dalam grup konsistensi. Jika disk dalam grup konsistensi bersifat regional, gunakan --region. Jika disk dalam grup konsistensi bersifat zona, gunakan --zone.
• LOCATION: region atau zona disk dalam grup konsistensi. Untuk disk regional, gunakan region. Untuk disk zona, gunakan zona.
• CONSISTENCY_GROUP_NAME: nama grup konsistensi.

REST

Lihat disk dalam grup konsistensi menggunakan filter kueri dengan salah satu metode berikut:

• Lihat disk zona dalam grup konsistensi menggunakan metode disks.get:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME
  

• Lihat disk regional dalam grup konsistensi menggunakan metode regionDisks.get:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME
  

Ganti kode berikut:

• PROJECT: project yang berisi grup konsistensi
• ZONE: zona disk dalam grup konsistensi
• REGION: region disk dalam grup konsistensi
• CONSISTENCY_GROUP_NAME: nama grup konsistensi

Menambahkan disk ke grup konsistensi

Jika ingin menambahkan disk utama ke grup konsistensi, Anda harus menambahkan disk ke grup konsistensi sebelum memulai replikasi. Anda dapat menambahkan disk sekunder ke grup konsistensi kapan saja. Semua disk dalam grup konsistensi harus berada di zona yang sama, untuk disk zona, atau dalam pasangan zona yang sama untuk disk regional.

Tambahkan disk ke grup konsistensi menggunakan Konsol Google Cloud, Google Cloud CLI, atau REST.

Konsol

Tambahkan disk ke grup konsistensi dengan melakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Replikasi asinkron.

   Buka Replikasi asinkron

2. Klik tab Grup konsistensi.

3. Klik nama grup konsistensi tempat Anda ingin menambahkan disk. Halaman Kelola grup konsistensi akan terbuka.

4. Klik Tetapkan disk. Halaman Tetapkan disk akan terbuka.

5. Pilih disk yang ingin Anda tambahkan ke grup konsistensi.

6. Klik Tetapkan disk. Saat diminta, klik Tambahkan.

gcloud

Tambahkan disk ke grup konsistensi menggunakan perintah gcloud compute disks add-resource-policies:

gcloud compute disks add-resource-policies DISK_NAME \
    --LOCATION_FLAG=LOCATION \
    --resource-policies=CONSISTENCY_GROUP

Ganti kode berikut:

• DISK_NAME: nama disk yang akan ditambahkan ke grup konsistensi.
• LOCATION_FLAG: flag lokasi untuk disk. Untuk disk regional, gunakan --region. Untuk disk zona, gunakan --zone.
• LOCATION: region atau zona disk. Untuk disk regional, gunakan region. Untuk disk zona, gunakan zona.
• CONSISTENCY_GROUP: URL grup konsistensi. Contoh, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME.

REST

Tambahkan disk ke grup konsistensi menggunakan salah satu metode berikut:

• Tambahkan disk zona ke grup konsistensi menggunakan metode disks.addResourcePolicies:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/LOCATION/disks/DISK_NAME/addResourcePolicies
  
  {
  "resourcePolicies": "CONSISTENCY_GROUP"
  }
  

• Tambahkan disk regional ke grup konsistensi menggunakan metode regionDisks.addResourcePolicies:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/LOCATION/disks/DISK_NAME/addResourcePolicies
  
  {
  "resourcePolicies": "CONSISTENCY_GROUP"
  }
  

Ganti kode berikut:

• PROJECT: project yang berisi disk.
• LOCATION: zona atau region disk. Untuk disk zona, gunakan zona. Untuk disk regional, gunakan region.
• DISK_NAME: nama disk yang akan ditambahkan ke grup konsistensi.
• CONSISTENCY_GROUP: URL grup konsistensi. Contoh, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME.

Mengeluarkan disk dari grup konsistensi

Sebelum dapat menghapus disk dari grup konsistensi, Anda harus menghentikan replikasi untuk disk tersebut.

Hapus disk dari grup konsistensi menggunakan Konsol Google Cloud, Google Cloud CLI, atau REST.

Konsol

Hapus disk utama dari grup konsistensi dengan melakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Replikasi asinkron.

   Buka Replikasi asinkron

2. Klik tab Grup konsistensi.

3. Klik nama grup konsistensi tempat Anda ingin menambahkan disk. Halaman Kelola grup konsistensi akan terbuka.

4. Pilih disk yang ingin Anda hapus dari grup konsistensi.

5. Klik Hapus disk. Saat diminta, klik Hapus.

gcloud

Hapus disk dari grup konsistensi menggunakan perintah gcloud compute disks remove-resource-policies:

gcloud compute disks remove-resource-policies DISK_NAME \
    --LOCATION_FLAG=LOCATION \
    --resource-policies=CONSISTENCY_GROUP

Ganti kode berikut:

• DISK_NAME: nama disk yang akan dihapus dari grup konsistensi.
• LOCATION_FLAG: flag lokasi untuk disk. Untuk disk regional, gunakan --region. Untuk disk zona, gunakan --zone.
• LOCATION: region atau zona disk. Untuk disk regional, gunakan region. Untuk disk zona, gunakan zona.
• CONSISTENCY_GROUP: URL grup konsistensi. Misalnya, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME.

REST

Hapus disk dari grup konsistensi menggunakan metode disks.removeResourcePolicies untuk disk zona, atau metode regionDisks.removeResourcePolicies untuk disk regional tambahan.

• Hapus disk zona dari grup konsistensi:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/LOCATION/disks/DISK_NAME/removeResourcePolicies
  
  {
  "resourcePolicies": "CONSISTENCY_GROUP"
  }
  

• Hapus disk regional dari grup konsistensi:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/LOCATION/disks/DISK_NAME/removeResourcePolicies
  
  {
  "resourcePolicies": "CONSISTENCY_GROUP"
  }
  

Ganti kode berikut:

• PROJECT: project yang berisi disk.
• LOCATION: zona atau region disk. Untuk disk zona, gunakan zona. Untuk disk regional, gunakan region.
• DISK_NAME: nama disk yang akan dihapus dari grup konsistensi.
• CONSISTENCY_GROUP: URL grup konsistensi. Contoh, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME.

Menghapus grup konsistensi

Hapus grup konsistensi menggunakan Konsol Google Cloud, Google Cloud CLI, atau REST.

Konsol

Hapus konsistensi dengan melakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Replikasi asinkron.

   Buka Replikasi asinkron

2. Klik tab Grup konsistensi.

3. Pilih grup konsistensi yang ingin Anda hapus.

4. Klik Hapus. Jendela Hapus grup konsistensi akan terbuka.

5. Klik Hapus.

gcloud

Hapus kebijakan resource menggunakan perintah gcloud compute resource-policies delete:

gcloud compute resource-policies delete CONSISTENCY_GROUP \
    --region=REGION

Ganti kode berikut:

• CONSISTENCY_GROUP: nama grup konsistensi
• REGION: region dari grup konsistensi

REST

Hapus konsistensi menggunakan metode resourcePolicies.delete:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME

Ganti kode berikut:

• PROJECT: project yang berisi grup konsistensi
• REGION: region dari grup konsistensi
• CONSISTENCY_GROUP: nama grup konsistensi

Langkah selanjutnya

• Pelajari cara mengelola disk yang menggunakan Replikasi Asinkron PD.
• Pelajari cara failover dan failback.
• Pelajari cara memantau performa Replikasi Asinkron Persistent Disk.