Menetapkan bentuk distribusi target untuk VM di MIG regional

Jika menggunakan grup instance terkelola (MIG) regional, Anda dapat menetapkan bentuk distribusi target MIG tersebut ke salah satu opsi berikut:

  • MERATA (default): grup membuat dan menghapus VM untuk mencapai dan mempertahankan jumlah VM yang sama di seluruh zona yang dipilih. Dalam distribusi EVEN, selisih jumlah VM di antara dua zona tidak lebih dari 1. Direkomendasikan untuk workload penyaluran yang sangat tersedia.
  • BALANCED: grup memprioritaskan pembuatan VM di zona tempat resource tersedia, sambil mendistribusikan VM semerata mungkin ke seluruh zona yang dipilih untuk meminimalkan dampak kegagalan tingkat zona. Direkomendasikan untuk workload penyaluran atau batch yang sangat tersedia.
  • APA SAJA: grup memilih zona untuk membuat instance VM guna memenuhi jumlah VM yang diminta dalam batasan resource yang ada dan untuk memaksimalkan pemanfaatan pemesanan zona yang tidak digunakan. Direkomendasikan untuk workload batch yang tidak memerlukan ketersediaan tinggi.
  • ANY SINGLE ZONE: grup membuat semua instance VM dalam satu zona. Zona ini dipilih berdasarkan dukungan hardware, ketersediaan resource dan kuota saat ini, serta pemesanan yang cocok. Direkomendasikan bersama dengan kebijakan penempatan instance yang rapat untuk workload yang memerlukan komunikasi ekstensif antar-VM.

Untuk menggunakan VM yang dipesan dalam grup instance terkelola regional, buat pemesanan yang identik dengan nama yang sama di setiap zona yang berlaku. Kemudian, targetkan pemesanan tersebut berdasarkan nama di template instance grup.

Untuk membantu Anda memilih bentuk, lihat tabel perbandingan, kasus penggunaan, dan cara kerja bentuk distribusi.

Tetapkan bentuk distribusi target saat membuat MIG regional atau memperbarui bentuk target MIG regional yang sudah ada.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Trusted Cloud by S3NS layanan dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi 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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

    gcloud

    1. Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init
    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.

      Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.

      Create local authentication credentials for your user account: 

      gcloud auth application-default login

      If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

    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, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Trusted Cloud .

Batasan

  • Anda hanya dapat memilih zona untuk MIG saat membuat MIG.

  • Jika Anda menentukan resource di template instance MIG atau konfigurasi stateful yang tidak tersedia di semua zona yang dipilih, batasan berikut akan berlaku:

    • Anda harus menetapkan bentuk distribusi target ke BALANCED, ANY, atau ANY_SINGLE_ZONE.
    • Anda harus memastikan bahwa setiap resource yang diperlukan oleh MIG–misalnya, disk, jenis mesin, atau GPU yang sudah ada–tersedia setidaknya di salah satu zona yang dipilih.
    • Jika Anda ingin memperbarui konfigurasi MIG (misalnya, template instance) menjadi konfigurasi yang tidak dapat dibuat instance-nya di semua zona yang dipilih, Anda harus menghapus instance terkelola dari semua zona yang tidak didukung sebelum menetapkan konfigurasi baru.

  • Untuk menetapkan bentuk distribusi target ke BALANCED atau ANY_SINGLE_ZONE, Anda harus menonaktifkan redistribusi instance proaktif.

  • Jika ingin menskalakan MIG regional secara otomatis, Anda harus menetapkan bentuk distribusi target grup ke BALANCED atau EVEN.

  • Jika Anda menetapkan bentuk distribusi target ke BALANCED, ANY, atau ANY_SINGLE_ZONE, batasan berikut akan berlaku:

    • Update Canary dengan dua versi tidak didukung.
    • Jika resource yang diminta memiliki ketersediaan terbatas di seluruh region, grup mungkin menjadwalkan pembuatan instance VM di zona tempat resource tersebut sudah tidak tersedia. Anda dapat mencoba mengurangi dan meningkatkan ukuran grup untuk mendapatkan resource yang diminta di zona lain.
    • Update berkelanjutan yang menggunakan metode penggantian SUBSTITUTE akan mencoba membuat instance baru yang diperbarui di zona yang sama dengan mesin yang sudah tidak berlaku, meskipun zona tersebut tidak memiliki resource untuk mengakomodasi persyaratan versi baru. Untuk memediasi perilaku ini, Anda dapat menghapus VM yang sudah tidak berlaku dari zona terbatas, lalu meningkatkan ukuran grup dengan jumlah VM yang dihapus. Grup akan membuat instance dari template terbaru di zona tempat kapasitas tersedia.
    • Jika Anda ingin memperbarui template instance grup menjadi template yang menentukan resource yang tidak tersedia di semua zona yang dipilih, Anda harus menghapus instance terkelola dari zona yang tidak didukung sebelum menetapkan template baru.

  • Jika Anda menetapkan bentuk distribusi target ke ANY_SINGLE_ZONE dan grup sudah memiliki VM dalam satu zona, Anda dapat membuat VM tambahan hanya di zona tersebut. Jika ingin menggunakan zona lain, Anda harus terlebih dahulu menskalakan grup hingga nol VM.

  • Jika perlu menyediakan grup sole-tenant VM, Anda harus menetapkan bentuk distribusi target MIG ke EVEN. Buat grup node Anda di zona yang sama dengan zona MIG dan tetapkan afinitas node MIG di template instance MIG.

Membuat grup dengan bentuk distribusi target

Untuk membuat grup Anda, pilih zonanya, dan tetapkan bentuk distribusi targetnya, gunakan Trusted Cloud console, gcloud CLI, Terraform, atau REST.

Konsol

  1. Di konsol Trusted Cloud , buka halaman Instance groups.

    Buka halaman Instance groups

  2. Klik Buat grup instance untuk membuat grup instance baru.
  3. Pilih salah satu Opsi grup instance terkelola baru: stateless (default) atau stateful.
  4. Tetapkan nama dan jika perlu, deskripsi untuk grup instance Anda.
  5. Pilih template instance untuk grup instance atau buat yang baru.
  6. Tentukan jumlah VM untuk grup ini. Untuk workload yang sangat tersedia, ingatlah untuk menyediakan VM yang cukup untuk mendukung aplikasi Anda jika terjadi kegagalan zona.
  7. Di bagian Lokasi, pilih Beberapa zona.

  8. Pilih region, lalu pilih zona yang ingin Anda gunakan.

    • Jika Anda ingin MIG dapat menggunakan semua zona di region, pilih semua zona yang tersedia.
    • Perlu diperhatikan bahwa Anda tidak dapat memperbarui MIG regional untuk menggunakan zona berbeda setelah dibuat.

  9. Pilih bentuk distribusi target.

    1. Jika Anda ingin memilih Apa saja atau Zona tunggal apa pun, di bagian Penskalaan otomatis, klik Mode penskalaan otomatis dan pilih Hapus konfigurasi penskalaan otomatis.
    2. Jika Anda ingin memilih Zona tunggal apa pun atau Seimbang, di bagian Redistribusi instance, jangan pilih Izinkan redistribusi instance.

  10. Lanjutkan dengan proses pembuatan MIG lainnya.

gcloud

Gunakan perintah gcloud compute instance-groups managed create dan sertakan flag --target-distribution-shape.

gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \
    --template TEMPLATE \
    --size SIZE \
    --region REGION \
    --zones ZONES \
    --target-distribution-shape SHAPE

Ganti kode berikut:

  • INSTANCE_GROUP_NAME: nama grup instance.
  • TEMPLATE: nama template instance yang akan digunakan untuk grup.
  • SIZE: ukuran target grup instance.
  • REGION: region tempat Anda menginginkan grup.

  • ZONES (opsional): daftar zona di region tempat Anda ingin men-deploy instance VM. Secara default, Compute Engine memilih tiga zona untuk Anda.

    • Jika Anda ingin MIG dapat menggunakan semua zona di region, tentukan semua zona yang tersedia. Anda bisa mendapatkan daftar zona di region dengan perintah berikut:

      gcloud compute zones list --filter=region:REGION --format='list(NAME)'

    • Perlu diperhatikan bahwa Anda tidak dapat memperbarui MIG regional untuk menggunakan zona berbeda setelah dibuat.

  • SHAPE: bentuk distribusi target. Ini dapat berupa salah satu dari nilai berikut ini:

    • even (default): grup membuat dan menghapus VM untuk mencapai dan mempertahankan jumlah VM yang sama di seluruh zona yang dipilih. Dalam distribusi EVEN, jumlah VM di antara dua zona tidak berbeda lebih dari 1. Direkomendasikan untuk workload penyajian yang sangat tersedia.
    • balanced: grup memprioritaskan pembuatan VM di zona tempat resource tersedia, sambil mendistribusikan VM semerata mungkin di seluruh zona yang dipilih untuk meminimalkan dampak kegagalan zona. Direkomendasikan untuk workload penyajian atau batch yang sangat tersedia.
    • any: grup memilih zona untuk membuat instance VM guna memenuhi jumlah VM yang diminta dalam batasan resource yang ada dan untuk memaksimalkan pemanfaatan pemesanan zona yang tidak digunakan. Direkomendasikan untuk workload batch yang tidak memerlukan ketersediaan tinggi.
    • any-single-zone: grup membuat semua instance VM dalam satu zona. Zona ini dipilih berdasarkan dukungan hardware, ketersediaan resource dan kuota saat ini, serta pemesanan yang cocok. Direkomendasikan bersama dengan kebijakan penempatan instance yang rapat untuk workload yang memerlukan komunikasi ekstensif antar-VM.

Misalnya, untuk membuat MIG regional dengan bentuk distribusi target seimbang, tetapkan flag --target-distribution-shape ke balanced.

gcloud compute instance-groups managed create example-rmig \
    --template example-template \
    --size 30 \
    --zones us-east1-b,us-east1-c \
    --target-distribution-shape balanced \
    --instance-redistribution-type none

Terraform

Jika Anda belum membuat template instance, yang menentukan jenis mesin, boot disk image, jaringan, dan properti VM lainnya yang Anda inginkan untuk setiap VM di MIG Anda, buat template instance.

Untuk membuat MIG regional, gunakan resource google_compute_region_instance_group_manager.

Contoh berikut membuat MIG regional dengan bentuk distribusi target BALANCED.

resource "google_compute_region_instance_group_manager" "default" {
  name                             = "example-rmig"
  region                           = "us-east1"
  distribution_policy_zones        = ["us-east1-b", "us-east1-c"]
  distribution_policy_target_shape = "BALANCED"
  update_policy {
    type                         = "PROACTIVE"
    minimal_action               = "REFRESH"
    instance_redistribution_type = "NONE"
    max_unavailable_fixed        = 3
  }
  target_size        = 30
  base_instance_name = "instance"
  version {
    instance_template = google_compute_instance_template.default.id
  }
}

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

REST

Panggil metode regionInstanceGroupManagers.insert. Dalam isi permintaan, sertakan properti distributionPolicy, dan tetapkan kolom targetShape-nya.

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers

{
    "name": INSTANCE_GROUP_NAME,
    "instanceTemplate": "global/instanceTemplates/TEMPLATE",
    "targetSize": SIZE,
    "distributionPolicy": {
        "zones": [
            {"zone": "zones/ZONE1"},
            {"zone": "zones/ZONE2"},
            {"zone": "zones/ZONE3"},
        ],
        "targetShape": "SHAPE"
    }
}

Ganti kode berikut:

  • PROJECT_ID: project ID untuk permintaan ini.
  • REGION: region untuk grup instance.
  • INSTANCE_GROUP_NAME: nama grup instance.
  • TEMPLATE: nama template instance yang akan digunakan untuk grup instance.
  • SIZE: ukuran target grup instance.
  • ZONE: nama zona di region tempat Anda ingin men-deploy instance VM.
    • Jika Anda ingin MIG dapat menggunakan semua zona di region, tentukan semua zona yang tersedia. Anda bisa mendapatkan daftar zona di region dengan memanggil metode regions.get.
    • Perlu diperhatikan bahwa Anda tidak dapat memperbarui MIG regional untuk menggunakan zona berbeda setelah dibuat.
  • SHAPE: bentuk distribusi target. Ini dapat berupa salah satu dari nilai berikut:
    • EVEN (default): grup membuat dan menghapus VM untuk mencapai dan mempertahankan jumlah VM yang sama di seluruh zona yang dipilih. Dalam distribusi EVEN, jumlah VM di antara dua zona tidak berbeda lebih dari 1. Direkomendasikan untuk workload penyajian yang sangat tersedia.
    • BALANCED: grup memprioritaskan pembuatan VM di zona tempat resource tersedia, sambil mendistribusikan VM semerata mungkin di seluruh zona yang dipilih untuk meminimalkan dampak kegagalan zona. Direkomendasikan untuk workload penyajian atau batch yang sangat tersedia.
    • ANY: grup memilih zona untuk membuat instance VM guna memenuhi jumlah VM yang diminta dalam batasan resource yang ada dan untuk memaksimalkan pemanfaatan pemesanan zona yang tidak digunakan. Direkomendasikan untuk workload batch yang tidak memerlukan ketersediaan tinggi.
    • ANY_SINGLE_ZONE: grup membuat semua instance VM dalam satu zona. Zona ini dipilih berdasarkan dukungan hardware, ketersediaan resource dan kuota saat ini, serta pemesanan yang cocok. Direkomendasikan bersama dengan kebijakan penempatan instance yang rapat untuk workload yang memerlukan komunikasi ekstensif antar-VM.

Mengubah bentuk distribusi target dari grup yang sudah ada

Anda dapat mengubah bentuk distribusi target di MIG regional yang sudah ada, tetapi dengan batasan berikut:

  • Jika ingin mengubah bentuk distribusi target menjadi BALANCED atau ANY_SINGLE_ZONE, Anda harus menonaktifkan redistribusi proaktif terlebih dahulu.
  • Jika Anda ingin mengubah bentuk distribusi target menjadi EVEN dan jika distribusi instance saat ini tidak merata, Anda harus menonaktifkan redistribusi proaktif terlebih dahulu.
  • Jika Anda mengubah bentuk menjadi EVEN dan ingin mengaktifkan kembali redistribusi proaktif, Anda harus terlebih dahulu menyeimbangkan kembali grup secara manual.
  • Jika Anda ingin mengubah bentuk distribusi target menjadi EVEN, tetapi template instance menentukan resource yang tidak didukung di semua zona yang dipilih, Anda harus terlebih dahulu memperbarui template instance grup ke template yang didukung di semua zona yang dipilih.

Konsol

  1. Di konsol Trusted Cloud , buka halaman Instance groups.

    Buka halaman Instance groups

  2. Di kolom Nama pada daftar, klik nama grup instance tempat Anda ingin mengubah bentuk distribusi target.
  3. Klik Edit untuk mengubah grup instance terkelola ini.
  4. Klik Lokasi untuk meluaskan bagian tersebut.
  5. Dalam daftar Bentuk distribusi target, pilih bentuk yang Anda inginkan.
  6. Klik Save untuk menerapkan perubahan.

gcloud

Gunakan perintah gcloud compute instance-groups managed update dan sertakan flag --target-distribution-shape.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --target-distribution-shape SHAPE

Ganti kode berikut:

  • INSTANCE_GROUP_NAME: nama grup instance.
  • SHAPE: bentuk distribusi target. Ini dapat berupa salah satu dari nilai berikut:
    • even (default): grup membuat dan menghapus VM untuk mencapai dan mempertahankan jumlah VM yang sama di seluruh zona yang dipilih. Dalam distribusi EVEN, jumlah VM di antara dua zona tidak berbeda lebih dari 1. Direkomendasikan untuk workload penyajian yang sangat tersedia.
    • balanced: grup memprioritaskan pembuatan VM di zona tempat resource tersedia, sambil mendistribusikan VM semerata mungkin di seluruh zona yang dipilih untuk meminimalkan dampak kegagalan zona. Direkomendasikan untuk workload penyajian atau batch yang sangat tersedia.
    • any: grup memilih zona untuk membuat instance VM guna memenuhi jumlah VM yang diminta dalam batasan resource yang ada dan untuk memaksimalkan pemanfaatan pemesanan zona yang tidak digunakan. Direkomendasikan untuk workload batch yang tidak memerlukan ketersediaan tinggi.
    • any-single-zone: grup membuat semua instance VM dalam satu zona. Zona ini dipilih berdasarkan dukungan hardware, ketersediaan resource dan kuota saat ini, serta pemesanan yang cocok. Direkomendasikan bersama dengan kebijakan penempatan instance yang rapat untuk workload yang memerlukan komunikasi ekstensif antar-VM.

REST

Panggil metode regionInstanceGroupManagers.patch. Dalam isi permintaan, sertakan properti distributionPolicy, dan tetapkan kolom targetShape-nya.

PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
    "distributionPolicy": {
        "targetShape": "SHAPE"
    }
}

Ganti kode berikut:

  • PROJECT_ID: project ID untuk permintaan ini.
  • REGION: region untuk grup instance.
  • INSTANCE_GROUP_NAME: nama grup instance.
  • SHAPE: bentuk distribusi target. Ini dapat berupa salah satu dari nilai berikut:
    • EVEN (default): grup membuat dan menghapus VM untuk mencapai dan mempertahankan jumlah VM yang sama di seluruh zona yang dipilih. Dalam distribusi EVEN, jumlah VM di antara dua zona tidak berbeda lebih dari 1. Direkomendasikan untuk workload penyajian yang sangat tersedia.
    • BALANCED: grup memprioritaskan pembuatan VM di zona tempat resource tersedia, sambil mendistribusikan VM semerata mungkin di seluruh zona yang dipilih untuk meminimalkan dampak kegagalan zona. Direkomendasikan untuk workload penyajian atau batch yang sangat tersedia.
    • ANY: grup memilih zona untuk membuat instance VM guna memenuhi jumlah VM yang diminta dalam batasan resource yang ada dan untuk memaksimalkan pemanfaatan pemesanan zona yang tidak digunakan. Direkomendasikan untuk workload batch yang tidak memerlukan ketersediaan tinggi.
    • ANY_SINGLE_ZONE: grup membuat semua instance VM dalam satu zona. Zona ini dipilih berdasarkan dukungan hardware, ketersediaan resource dan kuota saat ini, serta pemesanan yang cocok. Direkomendasikan bersama dengan kebijakan penempatan instance yang rapat untuk workload yang memerlukan komunikasi ekstensif antar-VM.

Melihat kebijakan distribusi instance yang dikonfigurasi

Konsol

  1. Di konsol Trusted Cloud , buka halaman Instance groups.

    Buka halaman Instance groups

    Jika Anda sudah memiliki grup instance, halaman akan mencantumkan grup tersebut.
  2. Klik nama grup instance yang ingin Anda periksa. Halaman akan terbuka dengan properti grup instance dan daftar instance yang disertakan dalam grup tersebut.
  3. Klik Details.
  4. Di bagian Lokasi, cari Bentuk distribusi target.

gcloud

Jalankan perintah gcloud compute instance-groups managed describe.

gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --region REGION

Perintah ini akan menampilkan detail grup, termasuk kolom distributionPolicy.targetShape:

...
distributionPolicy:
  targetShape: BALANCED
  zones:
  - zone: https://www.s3nsapis.fr/compute/v1/projects/my-project/zones/us-central1-f
  ...
name: my-group
region: https://www.s3nsapis.fr/compute/v1/projects/my-project/regions/us-central1
...

REST

Buat permintaan GET ke metode regionInstanceGroupManagers.get.

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

Ganti kode berikut:

  • PROJECT_ID: project ID untuk permintaan ini
  • REGION: region untuk grup instance
  • INSTANCE_GROUP_NAME: nama grup instance

Bentuk distribusi target ditampilkan dalam kolom distributionPolicy.targetShape. Contoh:

{
  "name": "my-instance-group",
  "distributionPolicy": {
    "targetShape": "BALANCED",
  },
  "targetSize": 50,
  ...
}

Langkah berikutnya