Mengubah atau menghapus fleksibilitas instance

Dokumen ini menjelaskan cara membuat perubahan atau menghapus fleksibilitas instance dalam grup instance terkelola (MIG) dengan mengedit kebijakan fleksibilitas instance. Dokumen ini juga menjelaskan cara mengupdate jenis mesin VM saat jenis mesin dihapus dari konfigurasi fleksibilitas instance.

Sebelum memulai

Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:
Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:
Konsol

Saat menggunakan konsol Google Cloud untuk mengakses layanan Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.
gcloud
1. Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
  gcloud init
  Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
  
  Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.
Tetapkan 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.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

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

Mengubah konfigurasi fleksibilitas instance

Anda dapat membuat perubahan berikut dengan mengedit konfigurasi fleksibilitas instance di MIG:

Menambahkan jenis mesin ke pilihan instance
Menghapus jenis mesin dari pilihan instance
Mengubah peringkat pilihan instance
Menambahkan pilihan instance
Menambahkan penggantian disk dan platform CPU minimum (Pratinjau)

MIG menerapkan perubahan berdasarkan nama pilihan instance yang Anda tentukan. Setiap pilihan instance yang tidak Anda tentukan akan tetap tidak berubah. Saat melakukan perubahan pada pilihan instance, Anda harus menentukan konfigurasi lengkapnya saat mengedit. Jika Anda tidak menentukan konfigurasi lengkap, MIG akan mengganti bagian yang tidak ditentukan dari pilihan instance. Misalnya, jika Anda hanya ingin mengubah peringkat, tentukan peringkat baru bersama dengan jenis mesin dan penggantian lainnya yang ditetapkan dalam pilihan tersebut. Untuk melihat konfigurasi yang ada, lihat Melihat fleksibilitas instance.

Setelah Anda menghapus jenis mesin dari konfigurasi, VM yang ada dengan jenis mesin yang dihapus akan terus menggunakannya. Jika Anda ingin mengubah jenis mesin VM tersebut, Anda harus mengupdate atau membuat ulang VM tertentu. Untuk mengetahui informasi selengkapnya, lihat artikel Memperbarui jenis mesin VM untuk menggunakan konfigurasi terbaru.

Untuk mengubah konfigurasi fleksibilitas instance dalam MIG, pilih salah satu opsi berikut:

Konsol

Di konsol Google Cloud , buka halaman Instance groups.

Buka Instance groups
Klik nama MIG tempat Anda ingin mengubah fleksibilitas instance.
Klik Edit.
Klik Instance flexibility untuk meluaskan bagian tersebut.
Di bagian Instance selections, klik Edit selections.
Di jendela Pilihan instance, klik ikon Alihkan pilihan instance untuk membuka tampilan Edit pilihan instance.

Saat mengedit pilihan instance, Anda dapat melakukan perubahan berikut:
- Ubah nama dan peringkat pilihan instance. Untuk melakukannya, edit nilai di kolom Nama dan Peringkat.
- Tambahkan jenis mesin baru ke pilihan. Untuk melakukannya, klik Tambahkan jenis mesin.
- Hapus jenis mesin. Untuk melakukannya, pilih jenis mesin, lalu klik Hapus.
- Tambahkan atau ubah penggantian disk atau platform CPU minimum (Pratinjau). Untuk melakukannya, ikuti perintah di bagian Penggantian.
Ubah pilihan sesuai kebutuhan, lalu klik Selesai.
Setelah Anda selesai melakukan perubahan di jendela Instance selections, klik Done.
Klik Save untuk menerapkan perubahan.

gcloud

Untuk mengedit konfigurasi fleksibilitas instance, gunakan perintah instance-groups managed update beta.

  gcloud beta compute instance-groups managed update INSTANCE_GROUP_NAME \
      --region REGION \
      --instance-flexibility-policy={"instanceSelections": \
        {"INSTANCE_SELECTION_1":{"rank":RANK_1,"machineTypes":["MACHINE_TYPE_1","MACHINE_TYPE_2"],"minCpuPlatform":"MIN_CPU_PLATFORM_1","disks":[{"deviceName":"DEVICE_NAME_1","boot":true,"initializeParams":{"sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"}}]}, \
        "INSTANCE_SELECTION_2":{"rank":RANK_2,"machineTypes":["MACHINE_TYPE_3","MACHINE_TYPE_4"],"minCpuPlatform":"MIN_CPU_PLATFORM_2","disks":[{"deviceName":"DEVICE_NAME_2","boot":true,"initializeParams":{"sourceImage":"projects/IMAGE_PROJECT/global/images/IMAGE_NAME"}}]}}}

Anda juga dapat menggunakan file YAML atau JSON untuk mengonfigurasi kebijakan fleksibilitas instance. Untuk melakukannya, gunakan flag --flags-file, bukan flag --instance-flexibility-policy, dan tentukan nama file. Misalnya, gunakan --flags-file=FILE_NAME.YAML. Lihat Contoh file YAML untuk mengonfigurasi fleksibilitas instance

Ganti kode berikut:

INSTANCE_GROUP_NAME: nama MIG tempat Anda ingin memeriksa konfigurasi fleksibilitas instance.
REGION: region tempat MIG berada.
INSTANCE_SELECTION: nama pilihan instance yang akan diubah. Saat memperbarui pilihan instance, Anda harus menentukan konfigurasi lengkapnya, termasuk properti apa pun yang tidak Anda ubah, untuk memastikan MIG mempertahankan properti yang tidak berubah.

REST

Untuk mengedit konfigurasi fleksibilitas instance, buat permintaan PATCH ke metode regionInstanceGroupManagers.patch beta.

  PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

  {
    "instanceFlexibilityPolicy": {
      "instanceSelections": {
        "INSTANCE_SELECTION_1": {
          "machineTypes": [
            "MACHINE_TYPE_1",
            "MACHINE_TYPE_2"
          ],
          "minCpuPlatform": "MIN_CPU_PLATFORM_1",
          "disks": [
            DISK_DEFINITION_1
          ],
          "rank": RANK_1
        },
        "INSTANCE_SELECTION_2": {
          "machineTypes": [
            "MACHINE_TYPE_3",
            "MACHINE_TYPE_4"
          ],
          "minCpuPlatform": "MIN_CPU_PLATFORM_2",
          "disks": [
            DISK_DEFINITION_2
          ],
          "rank": RANK_2
        }
      }
    }
  }

Ganti kode berikut:

PROJECT_ID: Project ID Anda.
REGION: region tempat MIG berada.
INSTANCE_GROUP_NAME: nama MIG tempat Anda ingin memeriksa konfigurasi fleksibilitas instance.
INSTANCE_SELECTION: nama pilihan instance yang akan diubah. Saat memperbarui pilihan instance, Anda harus menentukan konfigurasi lengkapnya, termasuk properti apa pun yang tidak Anda ubah, untuk memastikan MIG mempertahankan properti yang tidak berubah.

Menghapus konfigurasi fleksibilitas instance

Anda dapat menghapus semua atau pilihan instance tertentu dalam MIG.

Untuk menghapus semua pilihan instance dalam MIG, lihat Menghapus semua pilihan instance. Saat Anda menghapus semua pilihan instance, MIG akan menggunakan jenis mesin yang ditentukan dalam template instance untuk membuat VM baru dalam grup.
Untuk menghapus pilihan instance satu per satu berdasarkan nama, lihat bagian Menghapus pilihan instance tertentu. Tindakan ini hanya menghapus pilihan instance tertentu dan MIG mempertahankan pilihan lainnya.

Setelah menghapus pilihan instance, VM yang ada yang menggunakan jenis mesin dari pilihan instance yang dihapus akan terus menggunakan jenis mesin yang sama. Agar perubahan diterapkan, Anda harus mengupdate atau membuat ulang VM tersebut. Untuk mengetahui informasi selengkapnya, lihat Memperbarui jenis mesin VM untuk menggunakan konfigurasi terbaru.

Menghapus semua pilihan instance

Untuk menghapus semua pilihan instance, pilih salah satu opsi berikut:

Konsol

Di konsol Google Cloud , buka halaman Instance groups.

Buka Instance groups
Klik nama MIG tempat Anda ingin menghapus semua pilihan instance.
Klik Edit.
Klik Instance flexibility untuk meluaskan bagian tersebut.
Di bagian Instance selections, klik Edit selections.
Di jendela Instance selections, klik ikon Delete di samping setiap pilihan instance.
Klik Done.
Klik Save.

gcloud

Untuk menghapus semua pilihan instance dalam MIG, gunakan perintah instance-groups managed update:

  gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
      --region REGION \
      --remove-instance-selections-all

Ganti kode berikut:

INSTANCE_GROUP_NAME: nama MIG yang ingin Anda hapus semua pilihan instancenya.
REGION: region tempat MIG berada.

REST

Untuk menghapus semua pilihan instance dalam MIG, buat permintaan PATCH ke metode regionInstanceGroupManagers.patch.

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

  {
    "instanceFlexibilityPolicy": {
      "instanceSelections": null
    }
  }

Ganti kode berikut:

PROJECT_ID: Project ID Anda.
REGION: region tempat MIG berada.
INSTANCE_GROUP_NAME: nama MIG tempat Anda ingin menghapus pilihan instance.

Menghapus pilihan instance tertentu

Untuk menghapus pilihan instance tertentu, pilih salah satu opsi berikut:

Konsol

Di konsol Google Cloud , buka halaman Instance groups.

Buka Instance groups
Klik nama MIG tempat Anda ingin menghapus pilihan instance tertentu.
Klik Edit.
Klik Instance flexibility untuk meluaskan bagian tersebut.
Di bagian Instance selections, klik Edit selections.
Di jendela Pilihan instance, klik ikon Hapus di samping pilihan instance yang ingin Anda hapus.
Klik Done.
Klik Save.

gcloud

Untuk menghapus pilihan instance tertentu di MIG, gunakan perintah instance-groups managed update:

  gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
      --region REGION \
      --remove-instance-selections INSTANCE_SELECTION

Ganti kode berikut:

INSTANCE_GROUP_NAME: nama MIG tempat Anda ingin menghapus pilihan instance.
REGION: region tempat MIG berada.
INSTANCE_SELECTION: nama pilihan instance yang ingin Anda hapus. Jika ada beberapa pilihan instance, berikan daftar nama yang dipisahkan koma.

REST

Untuk menghapus pilihan instance tertentu di MIG, gunakan metode regionInstanceGroupManagers.patch.

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

  {
    "instanceFlexibilityPolicy": {
      "instanceSelections": {
        "INSTANCE_SELECTION": null
      }
    }
  }

Ganti kode berikut:

PROJECT_ID: Project ID Anda.
REGION: region tempat MIG berada.
INSTANCE_GROUP_NAME: nama MIG tempat Anda ingin menghapus pilihan instance.
INSTANCE_SELECTION: nama pilihan instance yang ingin Anda hapus. Jika ada beberapa pilihan instance, tentukan semuanya. Contoh, "selection-1": null,"selection-2": null.

Mengupdate jenis mesin VM untuk menggunakan konfigurasi terbaru

Jika ada VM di MIG yang menggunakan jenis mesin yang dihapus dari konfigurasi fleksibilitas instance, Anda harus mengupdate atau membuat ulang VM untuk mengupdate jenis mesinnya.

Untuk memperbarui atau membuat ulang VM, gunakan salah satu opsi berikut:

Perbarui VM menggunakan metode regionInstanceGroupManagers.applyUpdatesToInstances. Saat menggunakan metode applyUpdatesToInstances, kolom mostDisruptiveAllowedAction harus berupa RESTART ATAU REPLACE.

Catatan: Jika konfigurasi fleksibilitas instance Anda berisi jenis mesin dari generasi rangkaian mesin yang berbeda, setel kolom mostDisruptiveAllowedAction ke REPLACE. Untuk mengetahui generasi seri mesin, lihat Terminologi Compute Engine.
Buat ulang VM menggunakan metode regionInstanceGroupManagers.recreateInstances.
Buat ulang VM dengan menghapus VM terlebih dahulu, lalu mengubah ukuran MIG ke jumlah VM yang diperlukan.

Mengubah atau menghapus fleksibilitas instance Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Konsol

gcloud

REST

Mengubah konfigurasi fleksibilitas instance

Konsol

gcloud

REST

Menghapus konfigurasi fleksibilitas instance

Menghapus semua pilihan instance

Konsol

gcloud

REST

Menghapus pilihan instance tertentu

Konsol

gcloud

REST

Mengupdate jenis mesin VM untuk menggunakan konfigurasi terbaru

Langkah berikutnya

Mengubah atau menghapus fleksibilitas instance