Mengubah atau menghapus fleksibilitas instance

Dokumen ini menjelaskan cara membuat perubahan atau menghapus fleksibilitas instance di grup instance terkelola (MIG) dengan mengedit kebijakan fleksibilitas instance. Dokumen ini juga menjelaskan cara memperbarui 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 Google Cloud layanan dan API. Untuk menjalankan kode atau contoh 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 Google Cloud konsol untuk mengakses Google Cloud layanan 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 .

  • 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 platform CPU minimum dan penggantian disk (Pratinjau)

MIG menerapkan perubahan berdasarkan nama pilihan instance yang Anda tentukan. Pilihan instance yang tidak Anda tentukan akan tetap tidak berubah. Saat membuat perubahan pada pilihan instance, Anda harus menentukan konfigurasi lengkapnya saat mengedit. Jika Anda tidak menentukan konfigurasi lengkapnya, MIG akan mengganti bagian pilihan instance yang tidak ditentukan. Misalnya, jika Anda hanya ingin mengubah peringkat, tentukan peringkat baru beserta 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 memperbarui atau membuat ulang VM tertentu. Untuk mengetahui informasi selengkapnya, lihat Memperbarui jenis mesin VM untuk menggunakan konfigurasi terbaru.

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

Konsol

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

    Buka Instance groups

  2. Klik nama MIG tempat Anda ingin mengubah fleksibilitas instance.

  3. Klik Edit.

  4. Klik Instance flexibility untuk meluaskan bagian tersebut.

  5. Di bagian Instance selections, klik Edit selections.

  6. Di jendela Instance selections, klik ikon Toggle pilihan instance untuk membuka tampilan Edit instance selection.

    Saat mengedit pilihan instance, Anda dapat membuat perubahan berikut:

    • Mengubah nama dan peringkat pilihan instance. Untuk melakukannya, edit nilai di kolom Name dan Rank.
    • Menambahkan jenis mesin baru ke pilihan. Untuk melakukannya, klik Add machine type.
    • Menghapus jenis mesin. Untuk melakukannya, pilih jenis mesin, lalu klik Remove.
    • Menambahkan atau mengubah platform CPU minimum atau penggantian disk (Pratinjau). Untuk melakukannya, ikuti perintah di bagian Overrides.

  7. Ubah pilihan sesuai kebutuhan, lalu klik Done.

  8. Setelah selesai membuat perubahan di jendela Instance selections, klik Done.

  9. Klik Save untuk menerapkan perubahan.

gcloud

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

  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 dan bukan flag --instance-flexibility-policy, lalu tentukan nama filenya. 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 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 yang tidak Anda ubah, untuk memastikan MIG mempertahankan properti yang tidak berubah.

Menghapus konfigurasi fleksibilitas instance

Anda dapat menghapus semua atau pilihan instance tertentu di MIG.

  • Untuk menghapus semua pilihan instance di 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 Menghapus pilihan instance tertentu. Tindakan ini hanya menghapus pilihan instance tertentu dan MIG akan 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 memperbarui 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

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

    Buka Instance groups

  2. Klik nama MIG tempat Anda ingin menghapus semua pilihan instance.

  3. Klik Edit.

  4. Klik Instance flexibility untuk meluaskan bagian tersebut.

  5. Di bagian Instance selections, klik Edit selections.

  6. Di jendela Instance selections, klik ikon Delete di samping setiap pilihan instance.

  7. Klik Done.

  8. Klik Save.

gcloud

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

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

Ganti kode berikut:

  • INSTANCE_GROUP_NAME: nama MIG tempat Anda ingin menghapus semua pilihan instance.
  • REGION: region tempat MIG berada.

REST

Untuk menghapus semua pilihan instance di 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

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

    Buka Instance groups

  2. Klik nama MIG tempat Anda ingin menghapus pilihan instance tertentu.

  3. Klik Edit.

  4. Klik Instance flexibility untuk meluaskan bagian tersebut.

  5. Di bagian Instance selections, klik Edit selections.

  6. Di jendela Instance selections, klik ikon Delete di samping pilihan instance yang ingin Anda hapus.

  7. Klik Done.

  8. Klik Save.

gcloud

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

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

  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. Misalnya, "selection-1": null,"selection-2": null.

Memperbarui jenis mesin VM untuk menggunakan konfigurasi terbaru

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

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

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

  • Buat ulang VM menggunakan metode regionInstanceGroupManagers.recreateInstances.

  • Buat ulang VM dengan terlebih dahulu menghapus VM lalu mengubah ukuran MIG ke jumlah VM yang diperlukan.

Langkah berikutnya