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 maksimum 16 disk yang berada dalam grup konsistensi berbeda, atau disk yang tidak berada dalam grup konsistensi ke VM. Disk yang berada dalam grup konsistensi yang sama dihitung sebagai satu disk dalam batas 16 disk.

Sebelum memulai

• Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda agar dapat mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  Terraform

  Untuk menggunakan contoh Terraform di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command:

     gcloud init

  3. If you're using a local shell, then create local authentication credentials for your user account:

     gcloud auth application-default login

     You don't need to do this if you're using Cloud Shell.

  Untuk informasi selengkapnya, lihat Set up authentication for a local development environment.

  REST

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

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

  Untuk informasi selengkapnya, lihat Mengautentikasi untuk menggunakan REST dalam Google Cloud dokumentasi autentikasi.

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, REST, atau Terraform.

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 Buat.

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.

Terraform

Untuk membuat grup konsistensi, gunakan resource compute_resource_policy.

resource "google_compute_resource_policy" "default" {
  name   = "test-consistency-group"
  region = "us-central1"
  disk_consistency_group_policy {
    enabled = true
  }
}

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

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, REST, atau Terraform.

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.

Terraform

Untuk menambahkan disk ke grup konsistensi, gunakan resource compute_disk_resource_policy_attachment.

• Untuk disk Regional, tentukan region sebagai pengganti zona.

  resource "google_compute_disk_resource_policy_attachment" "default" {
    name = google_compute_resource_policy.default.name
    disk = google_compute_disk.default.name
    zone = "us-central1-a"
  }

  Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

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. Contoh, 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 berikutnya

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