Dokumen ini menjelaskan cara membuat permintaan pengubahan ukuran dalam grup instance terkelola (MIG) instance virtual machine (VM) yang memiliki GPU terpasang. Untuk mempelajari lebih lanjut permintaan perubahan ukuran, lihat Tentang permintaan perubahan ukuran di MIG.
Membuat permintaan pengubahan ukuran MIG membantu Anda mendapatkan resource yang sangat diminati, seperti GPU, dan mengoptimalkan biaya dengan membuat jumlah VM yang tepat sekaligus. Untuk membuat permintaan perubahan ukuran MIG yang dapat menggunakan fitur dan layanan yang tersedia dari Cluster Director, lihat Membuat MIG dan permintaan perubahan ukuran dalam dokumentasi AI Hypercomputer.
Sebelum memulai
- Untuk menggunakan permintaan pengubahan ukuran MIG guna membuat VM segera setelah resource tersedia untuk workload yang berjalan hingga tujuh hari, pastikan Anda memiliki kuota standar atau preemptible yang cukup untuk resource yang diminta. Untuk mengetahui informasi selengkapnya, lihat cara memeriksa kuota GPU.
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Google Cloud 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 Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
-
Untuk membuat template instance:
compute.instanceTemplates.create
pada project -
Untuk membuat MIG zona:
compute.instanceGroupManagers.create
pada project -
Untuk membuat permintaan pengubahan ukuran MIG:
compute.instanceGroupManagers.update
pada project Jika Anda ingin membuat VM segera setelah resource tersedia untuk workload yang berjalan hingga tujuh hari, maka buat template instance menggunakan model penyediaan mulai fleksibel.
Jika Anda ingin membuat VM dengan menggunakan pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang dalam mode kalender, maka buat template instance menggunakan model penyediaan terikat reservasi.
Gunakan jenis mesin GPU, kecuali jenis mesin A4X.
Hentikan VM selama peristiwa pemeliharaan host.
Hapus VM di akhir durasi berjalannya menggunakan kolom
maxRunDuration
daninstanceTerminationAction
.Gunakan model penyediaan flex-start.
Di konsol Google Cloud , buka halaman Instance templates.
Klik Create instance template. Halaman Create an instance template akan terbuka.
Di kolom Name, masukkan nama untuk template instance.
Di bagian Lokasi, pilih salah satu opsi berikut:
Untuk membuat template instance regional, pilih Regional (direkomendasikan), lalu pilih region tempat template akan dibuat.
Untuk membuat template instance global, pilih Global.
Di bagian Machine configuration, lakukan hal berikut:
Klik tab GPU.
Dalam daftar GPU type, pilih jenis GPU.
Dalam daftar Number of GPU, pilih jumlah GPU.
Opsional: Jika jenis GPU yang Anda pilih mendukung NVIDIA RTX Virtual Workstations (vWS) untuk beban kerja grafis, dan Anda berencana menjalankan beban kerja yang intensif grafis, pilih Aktifkan Workstation Virtual (NVIDIA GRID).
Di bagian Machine type, pilih jenis mesin.
Di bagian Provisioning model, selesaikan langkah-langkah berikut:
Di kolom VM provisioning model, pilih Flex-start.
Luaskan Setelan lanjutan model penyediaan VM.
Centang kotak Set a time limit for the VM.
Untuk menetapkan durasi berjalan bagi VM yang dibuat melalui template instance, di kolom Enter number of hours, masukkan jumlah jam. Nilainya harus antara 36 detik (
0.01
) dan tujuh hari (168
).
Opsional: Untuk mengubah jenis atau image boot disk nilai default, di bagian Boot disk, klik Ubah. Kemudian, ikuti petunjuk untuk mengubah disk booting.
Klik Buat.
Flag
--instance-termination-action
ditetapkan keDELETE
.Flag
--maintenance-policy
ditetapkan keTERMINATE
.Flag
--max-run-duration
.Flag
--provisioning-model
ditetapkan keFLEX_START
.Flag
--reservation-affinity
ditetapkan kenone
.INSTANCE_TEMPLATE_NAME
: nama template instance yang akan dibuat.IMAGE_PROJECT
: project gambar yang berisi gambar; misalnya,debian-cloud
. Untuk mengetahui informasi selengkapnya tentang project gambar yang didukung, lihat Gambar publik.IMAGE_FAMILY
: kelompok image. Tindakan ini menentukan image OS terbaru yang masih digunakan. Misalnya, jika Anda menentukandebian-12
, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.REGION
: region tempat membuat template instance.MACHINE_TYPE
: jenis mesin GPU yang akan digunakan untuk VM. Jika Anda menentukan jenis mesin N1, Anda harus menyertakan flag--accelerator
untuk menentukan jumlah dan jenis GPU yang akan dipasang ke VM.RUN_DURATION
: durasi yang Anda inginkan untuk menjalankan VM yang diminta. Anda harus memformat nilai sebagai jumlah hari, jam, menit, atau detik yang diikuti dengand
,h
,m
, dans
. Misalnya, tentukan30m
selama 30 menit atau1d2h3m4s
untuk satu hari, dua jam, tiga menit, dan empat detik. Nilai harus antara 10 menit dan tujuh hari.Untuk membuat template instance regional: metode
regionInstanceTemplates.insert
betaUntuk membuat template instance global: Metode
instanceTemplates.insert
betaKolom
reservationAffinity.consumeReservationType
ditetapkan keNO_RESERVATION
.Kolom
scheduling.instanceTerminationAction
ditetapkan keDELETE
.Kolom
scheduling.maxRunDuration
.Kolom
scheduling.onHostMaintenance
ditetapkan keTERMINATE
.Kolom
scheduling.provisioningModel
ditetapkan keFLEX_START
.PROJECT_ID
: ID project tempat template instance akan dibuat.REGION
: region tempat membuat template instance.INSTANCE_TEMPLATE_NAME
: nama template instance yang akan dibuat.IMAGE_PROJECT
: project gambar yang berisi gambar; misalnya,debian-cloud
. Untuk mengetahui informasi selengkapnya tentang project gambar yang didukung, lihat Gambar publik.IMAGE
: tentukan salah satu dari berikut ini:Versi tertentu dari image OS—misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Tindakan ini menentukan image OS terbaru yang tidak digunakan lagi. Misalnya, jika Anda menentukanfamily/debian-12
, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.
MACHINE_TYPE
: jenis mesin GPU yang akan digunakan untuk VM. Jika Anda menentukan jenis mesin N1, Anda harus menyertakan kolomguestAccelerators
untuk menentukan jumlah dan jenis GPU yang akan dipasang ke VM Anda.RUN_DURATION
: durasi, dalam detik, yang Anda inginkan untuk menjalankan VM yang diminta. Nilai harus antara600
, yaitu 600 detik (10 menit), dan604800
, yaitu 604.800 detik (tujuh hari).Gunakan jenis mesin A4 atau A3 Ultra seperti yang ditentukan dalam reservasi.
Hentikan VM selama peristiwa pemeliharaan host.
Hapus VM di akhir periode reservasi menggunakan kolom
instanceTerminationAction
.Gunakan model penyediaan terikat reservasi.
Di konsol Google Cloud , buka halaman Instance templates.
Klik Create instance template. Halaman Create an instance template akan terbuka.
Di kolom Name, masukkan nama untuk template instance.
Di bagian Lokasi, pilih salah satu opsi berikut:
Untuk membuat template instance regional, pilih Regional (direkomendasikan), lalu pilih region tempat template akan dibuat.
Untuk membuat template instance global, pilih Global.
Di bagian Machine configuration, lakukan hal berikut:
Klik tab GPU.
Dalam daftar GPU type, pilih salah satu opsi berikut seperti yang ditentukan dalam reservasi yang ingin Anda gunakan:
Untuk menggunakan VM A4: NVIDIA B200 180 GB
Untuk menggunakan VM A3 Ultra: NVIDIA H200 141 GB
Tindakan ini akan otomatis menetapkan model penyediaan template instance ke Terikat dengan reservasi.
Dalam daftar Number of GPU, pilih jumlah GPU.
Opsional: Jika jenis GPU yang Anda pilih mendukung NVIDIA RTX Virtual Workstations (vWS) untuk beban kerja grafis, dan Anda berencana menjalankan beban kerja yang intensif grafis, pilih Aktifkan Workstation Virtual (NVIDIA GRID).
Di bagian Machine type, pilih jenis mesin.
Di bagian Provisioning model, selesaikan langkah-langkah berikut:
Luaskan Setelan lanjutan model penyediaan VM.
Dalam daftar On VM termination, pilih Delete.
Opsional: Untuk mengubah jenis atau image boot disk nilai default, di bagian Boot disk, klik Ubah. Kemudian, ikuti petunjuk untuk mengubah disk booting.
Luaskan bagian Opsi lanjutan, lalu lakukan hal berikut:
Luaskan bagian Management.
Di bagian Reservations, pilih Choose a reservation, lalu klik Choose reservation. Di panel yang muncul, ikuti perintah untuk memilih reservasi yang ingin Anda gunakan.
Klik Buat.
Flag
--instance-termination-action
ditetapkan keDELETE
.Flag
--maintenance-policy
ditetapkan keTERMINATE
.Flag
--provisioning-model
ditetapkan keRESERVATION_BOUND
.Flag
--reservation-affinity
ditetapkan kespecific
.Flag
--reservation
.INSTANCE_TEMPLATE_NAME
: nama template instance yang akan dibuat.IMAGE_PROJECT
: project gambar yang berisi gambar; misalnya,debian-cloud
. Untuk mengetahui informasi selengkapnya tentang project gambar yang didukung, lihat Gambar publik.IMAGE_FAMILY
: kelompok image. Tindakan ini menentukan image OS terbaru yang masih digunakan. Misalnya, jika Anda menentukandebian-12
, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.REGION
: region tempat membuat template instance.MACHINE_TYPE
: jenis mesin A4 atau A3 Ultra yang ditentukan dalam reservasi yang ingin Anda gunakan.RESERVATION_URL
: URL pemesanan yang dibuat otomatis untuk pemesanan mendatang dalam mode kalender yang ingin Anda gunakan. Tentukan salah satu nilai berikut:Jika pemesanan yang dibuat otomatis ada di project Anda:
RESERVATION_NAME
.Jika pemesanan yang dibuat otomatis ada di project lain:
projects/PROJECT_ID/reservations/RESERVATION_NAME
.
Untuk membuat template instance regional: metode
regionInstanceTemplates.insert
Untuk membuat template instance global: Metode
instanceTemplates.insert
Kolom
reservationAffinity.consumeReservationType
ditetapkan keSPECIFIC_RESERVATION
.Kolom
reservationAffinity.key
ditetapkan kecompute.googleapis.com/reservation-name
.Kolom
reservationAffinity.values
ditetapkan ke URL pemesanan yang dibuat secara otomatis.Kolom
scheduling.instanceTerminationAction
ditetapkan keDELETE
.Kolom
scheduling.onHostMaintenance
ditetapkan keTERMINATE
.Kolom
scheduling.provisioningModel
ditetapkan keRESERVATION_BOUND
.PROJECT_ID
: ID project tempat template instance akan dibuat.REGION
: region tempat membuat template instance.INSTANCE_TEMPLATE_NAME
: nama template instance yang akan dibuat.IMAGE_PROJECT
: project gambar yang berisi gambar; misalnya,debian-cloud
. Untuk mengetahui informasi selengkapnya tentang project gambar yang didukung, lihat Gambar publik.IMAGE
: tentukan salah satu dari berikut ini:Versi tertentu dari image OS—misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Tindakan ini menentukan image OS terbaru yang tidak digunakan lagi. Misalnya, jika Anda menentukanfamily/debian-12
, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.
MACHINE_TYPE
: jenis mesin A4 atau A3 Ultra yang ditentukan dalam reservasi yang ingin Anda gunakan.RESERVATION_URL
: URL pemesanan yang dibuat otomatis untuk pemesanan mendatang dalam mode kalender yang ingin Anda gunakan. Tentukan salah satu nilai berikut:Jika pemesanan yang dibuat otomatis ada di project Anda:
RESERVATION_NAME
Jika pemesanan yang dibuat otomatis ada di project lain:
projects/PROJECT_ID/reservations/RESERVATION_NAME
Tetapkan jenis update MIG ke oportunistik (default).
Jika Anda telah mengonfigurasi penskalaan otomatis di MIG, maka hapus konfigurasi penskalaan otomatis.
Jika Anda menggunakan MIG regional, tetapkan bentuk distribusi target ke
ANY_SINGLE_ZONE
.Di konsol Google Cloud , buka halaman Instance groups.
Klik Create instance group. Halaman Create instance group akan terbuka.
Di kolom Nama, masukkan nama untuk MIG.
Sebelum memilih template instance, Anda harus menghapus konfigurasi penskalaan otomatis dan menonaktifkan perbaikan sebagai berikut:
Untuk menghapus konfigurasi penskalaan otomatis, lakukan hal berikut:
Di bagian Penskalaan otomatis, klik daftar Mode penskalaan otomatis, lalu klik Hapus konfigurasi penskalaan otomatis.
Pada dialog konfirmasi, klik Delete.
Untuk menonaktifkan perbaikan, di bagian VM instance lifecycle, klik daftar Default action on failure, lalu pilih No action.
Kembali ke kolom Instance template. Dalam daftar Instance template, pilih template instance yang Anda buat di bagian sebelumnya. Jika Anda memilih template instance regional, daftar Region akan ditetapkan ke region template.
Lakukan salah satu hal berikut:
Untuk membuat permintaan pengubahan ukuran saat Anda membuat MIG, lakukan hal berikut:
Di kolom Number of instances, masukkan jumlah VM yang ingin Anda buat sekaligus.
Centang kotak Use resize request to create VMs all at once.
Opsional: Jika template instance MIG menentukan durasi proses, Anda dapat menentukan durasi proses yang berbeda. Untuk melakukannya, di kolom Durasi proses yang diminta dan daftar Unit, tentukan durasi proses. Anda harus menentukan durasi antara satu jam dan tujuh hari.
Untuk membuat permintaan pengubahan ukuran setelah membuat MIG, di kolom Number of instances, masukkan
0
.
Di bagian Lokasi, tentukan apakah Anda ingin membuat MIG tingkat zona atau regional sebagai berikut:
Untuk membuat MIG zona, pilih Single zone. Atau, untuk membuat MIG regional, pilih Beberapa zona.
Pilih Region dan Zona MIG.
Jika Anda membuat MIG regional, lakukan hal berikut:
Di kolom Bentuk distribusi target, pilih Zona tunggal mana pun.
Pada dialog yang muncul, klik Nonaktifkan redistribusi instance.
Klik Buat.
Untuk membuat MIG zona, jalankan perintah berikut:
gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=0 \ --zone=ZONE \ --default-action-on-vm-failure=do_nothing
Untuk membuat MIG regional, jalankan perintah berikut:
gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=0 \ --region=REGION \ --target-distribution-shape=any-single-zone \ --instance-redistribution-type=none \ --default-action-on-vm-failure=do_nothing
INSTANCE_GROUP_NAME
: nama MIG yang akan dibuat.INSTANCE_TEMPLATE_URL
: URL parsial template instance yang Anda buat di bagian sebelumnya. Jika Anda ingin menggunakan template instance regional untuk membuat MIG, Anda hanya dapat membuat MIG dalam region template. Tentukan salah satu nilai berikut:Untuk template instance regional:
projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME
Untuk template instance global:
INSTANCE_TEMPLATE_NAME
ZONE
: zona tempat MIG akan dibuat.REGION
: region tempat MIG akan dibuat.Untuk membuat MIG zona, kirim permintaan
POST
menggunakan metodeinstanceGroupManagers.insert
sebagai berikut:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "INSTANCE_GROUP_NAME", "targetSize": 0, "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING" } }
Untuk membuat MIG regional, kirim permintaan
POST
menggunakan metoderegionInstanceGroupManagers.insert
seperti berikut:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "INSTANCE_GROUP_NAME", "targetSize": 0, "distributionPolicy": { "targetShape": "ANY_SINGLE_ZONE" }, "updatePolicy": { "instanceRedistributionType": "NONE" }, "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING" } }
PROJECT_ID
: ID project tempat template instance yang Anda buat di bagian sebelumnya berada.INSTANCE_TEMPLATE_URL
: URL parsial template instance yang Anda buat di bagian sebelumnya. Jika Anda ingin menggunakan template instance regional untuk membuat MIG, Anda hanya dapat membuat MIG dalam region template. Tentukan salah satu nilai berikut:Untuk template instance regional:
regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME
Untuk template instance global:
global/instanceTemplates/INSTANCE_TEMPLATE_NAME
ZONE
: zona tempat MIG akan dibuat.REGION
: region tempat MIG akan dibuat.INSTANCE_GROUP_NAME
: nama MIG yang akan dibuat.Di konsol Google Cloud , buka halaman Instance groups.
Di kolom Name, klik nama MIG tempat permintaan pengubahan ukuran akan dibuat.
Halaman ringkasan MIG akan terbuka.
Di baris Permintaan pengubahan ukuran, klik
Edit permintaan pengubahan ukuran.Klik
Permintaan pengubahan ukuran baru.Panel Permintaan pengubahan ukuran baru akan muncul.
Di kolom Name, masukkan nama permintaan pengubahan ukuran.
Di kolom Number of additional instances needed, masukkan jumlah VM yang akan ditambahkan ke MIG sekaligus.
Opsional: Jika template instance MIG menentukan durasi proses, Anda dapat menentukan durasi proses yang berbeda. Untuk melakukannya, di kolom Durasi proses yang diminta dan daftar Unit, tentukan durasi proses. Anda harus menentukan durasi antara satu jam dan tujuh hari.
Klik Buat.
Untuk membuat permintaan pengubahan ukuran di MIG zona, gunakan perintah
instance-groups managed resize-requests create
.gcloud compute instance-groups managed resize-requests create INSTANCE_GROUP_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --resize-by=COUNT \ --zone=ZONE
Untuk membuat permintaan pengubahan ukuran di MIG regional, gunakan perintah
beta instance-groups managed resize-requests create
.gcloud beta compute instance-groups managed resize-requests create INSTANCE_GROUP_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --resize-by=COUNT \ --region=REGION
INSTANCE_GROUP_NAME
: nama MIG yang dikonfigurasi untuk membuat permintaan pengubahan ukuran di dalamnya.RESIZE_REQUEST_NAME
: nama permintaan pengubahan ukuran, yang harus unik dalam MIG yang ditentukan. Jika tidak, pembuatan permintaan pengubahan ukuran akan gagal.COUNT
: jumlah VM yang akan ditambahkan ke MIG sekaligus.ZONE
: zona tempat MIG berada.REGION
: region tempat MIG berada.Jika template instance MIG menentukan durasi berjalan, Anda dapat menentukan durasi berjalan yang berbeda. Untuk melakukannya, sertakan flag
--requested-run-duration
dalam perintah. Anda harus menentukan durasi antara 10 menit dan tujuh hari.Jika workload Anda memerlukan nama VM tertentu, Anda dapat menentukan daftar nama VM yang akan dibuat menggunakan perintah
beta instance-groups managed resize-requests create
. Dalam perintah, ganti flag--resize-request
dengan flag--instances
.Untuk membuat permintaan pengubahan ukuran di MIG zona, kirim permintaan
POST
menggunakan metodeinstanceGroupManagerResizeRequests.insert
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests
Untuk membuat permintaan pengubahan ukuran di MIG regional, kirim permintaan
POST
menggunakan metodebeta.regionInstanceGroupManagerResizeRequests.insert
.PROJECT_ID
: ID project tempat MIG yang ditentukan berada.ZONE
: zona tempat MIG berada.REGION
: region tempat MIG berada.INSTANCE_GROUP_NAME
: nama MIG yang dikonfigurasi untuk membuat permintaan pengubahan ukuran di dalamnya.RESIZE_REQUEST_NAME
: nama permintaan pengubahan ukuran, yang harus unik dalam MIG yang ditentukan. Jika tidak, pembuatan permintaan pengubahan ukuran akan gagal.COUNT
: jumlah VM yang akan ditambahkan sekaligus ke MIG.Jika template instance MIG menentukan durasi berjalan, Anda dapat menentukan durasi berjalan yang berbeda. Untuk melakukannya, sertakan kolom
requestedRunDuration
dalam isi permintaan. Anda harus menentukan durasi, dalam detik, antara 10 menit dan tujuh hari.Jika workload Anda memerlukan nama VM tertentu, Anda dapat menentukan daftar nama VM yang akan dibuat. Untuk melakukannya, kirim permintaan
POST
ke metodebeta.regionInstanceGroupManagerResizeRequests.insert
untuk MIG regional, atau metodebeta.instanceGroupManagerResizeRequests.insert
untuk MIG zona. Di isi permintaan, ganti kolomresizeBy
dengan kolominstanceNames
.Pelajari cara melihat, membatalkan, atau menghapus permintaan pengubahan ukuran di MIG.
Pelajari cara melihat info tentang MIG dan VM terkelola.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk membuat permintaan pengubahan ukuran MIG, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (
roles/compute.instanceAdmin.v1
) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.Peran bawaan ini berisi izin yang diperlukan untuk membuat permintaan pengubahan ukuran MIG. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat permintaan pengubahan ukuran MIG:
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Menyiapkan MIG untuk permintaan perubahan ukuran
Untuk membuat permintaan pengubahan ukuran MIG, Anda harus mengonfigurasi template instance dan MIG seperti yang dijelaskan di bagian berikut.
Membuat template instance
Berdasarkan kasus penggunaan untuk permintaan pengubahan ukuran MIG, buat template instance dengan menggunakan salah satu metode berikut:
Menggunakan model penyediaan flex-start
Untuk membuat template instance yang dikonfigurasi untuk permintaan pengubahan ukuran MIG dan untuk membuat VM segera setelah resource tersedia, Anda harus menentukan hal berikut dalam template:
Untuk membuat template instance, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk membuat template instance, gunakan perintah
beta instance-templates create
dengan flag berikut:Misalnya, untuk membuat template instance regional, jalankan perintah berikut. Jika Anda ingin membuat template instance global, gunakan perintah yang sama tanpa flag
--instance-template-region
.gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \ --image-project=IMAGE_PROJECT \ --image-family=IMAGE_FAMILY \ --instance-template-region=REGION \ --instance-termination-action=DELETE \ --machine-type=MACHINE_TYPE \ --maintenance-policy=TERMINATE \ --max-run-duration=RUN_DURATION \ --provisioning-model=FLEX_START \ --reservation-affinity=none
Ganti kode berikut:
REST
Untuk membuat template instance, buat permintaan
POST
ke salah satu metode berikut:Dalam isi permintaan, sertakan kolom berikut:
Misalnya, untuk membuat template instance regional, buat permintaan seperti berikut:
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceTemplates { "name": "INSTANCE_TEMPLATE_NAME", "properties": { "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "machineType": "MACHINE_TYPE", "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" }, "scheduling": { "instanceTerminationAction": "DELETE", "maxRunDuration": { "seconds": RUN_DURATION }, "onHostMaintenance": "TERMINATE", "provisioningModel": "FLEX_START" } } }
Ganti kode berikut:
Untuk mengetahui informasi selengkapnya tentang cara membuat template instance, lihat Membuat template instance.
Menggunakan model penyediaan terikat reservasi
Untuk membuat template instance yang dikonfigurasi untuk permintaan pengubahan ukuran MIG dan untuk menggunakan pemesanan, Anda harus menentukan hal berikut dalam template:
Untuk membuat template instance, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk membuat template instance, gunakan perintah
instance-templates create
dengan flag berikut:Misalnya, untuk membuat template instance regional, jalankan perintah berikut. Jika Anda ingin membuat template instance global, gunakan perintah yang sama tanpa flag
--instance-template-region
.gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \ --image-project=IMAGE_PROJECT \ --image-family=IMAGE_FAMILY \ --instance-termination-action=DELETE \ --instance-template-region=REGION \ --machine-type=MACHINE_TYPE \ --maintenance-policy=TERMINATE \ --provisioning-model=RESERVATION_BOUND \ --reservation-affinity=specific \ --reservation=RESERVATION_URL
Ganti kode berikut:
REST
Untuk membuat template instance, buat permintaan
POST
ke salah satu metode berikut:Dalam isi permintaan, sertakan kolom berikut:
Misalnya, untuk membuat template instance regional, buat permintaan seperti berikut:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates { "name": "INSTANCE_TEMPLATE_NAME", "properties": { "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "machineType": "MACHINE_TYPE", "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "SPECIFIC_RESERVATION", "key": "compute.googleapis.com/reservation-name", "values": [ "RESERVATION_URL" ] }, "scheduling": { "instanceTerminationAction": "DELETE", "onHostMaintenance": "TERMINATE", "provisioningModel": "RESERVATION_BOUND" } } }
Ganti kode berikut:
Untuk mengetahui informasi selengkapnya tentang cara membuat template instance, lihat Membuat template instance.
Membuat atau memperbarui MIG
Setelah membuat template instance seperti yang dijelaskan di bagian sebelumnya, gunakan template instance tersebut untuk membuat MIG sebagai berikut, atau perbarui MIG. Selain itu, Anda harus melakukan hal berikut untuk menyiapkan MIG untuk permintaan pengubahan ukuran:
Untuk membuat MIG yang kompatibel dengan permintaan pengubahan ukuran, pilih salah satu opsi berikut:
Konsol
gcloud
Gunakan perintah
instance-groups managed create
dengan flag--default-action-on-vm-failure
yang ditetapkan kedo_nothing
. Jika Anda membuat MIG regional, Anda juga harus menyertakan flag--target-distribution-shape
yang ditetapkan keany-single-zone
, dan flag--instance-redistribution-type
yang ditetapkan kenone
.Ganti kode berikut:
REST
Ganti kode berikut:
Membuat permintaan perubahan ukuran di MIG
Sebelum membuat permintaan pengubahan ukuran MIG, pastikan Anda telah menyiapkan MIG seperti yang dijelaskan di bagian sebelumnya.
Setelah Anda membuat permintaan pengubahan ukuran dan semua resource yang diminta tersedia, MIG akan membuat VM dalam jumlah yang diminta sekaligus. VM akan berjalan hingga MIG menghapusnya setelah durasi berjalan yang ditentukan berakhir, atau hingga Anda menghapusnya.
Untuk membuat permintaan pengubahan ukuran di MIG, pilih salah satu opsi berikut. Untuk menambahkan VM dengan nama tertentu ke MIG melalui permintaan pengubahan ukuran, gunakan gcloud CLI atau REST API.
Konsol
gcloud
Ganti kode berikut:
Secara opsional, Anda dapat melakukan hal berikut:
REST
Dalam isi permintaan, sertakan hal berikut:
{ "name": "RESIZE_REQUEST_NAME", "resizeBy": COUNT }
Ganti kode berikut:
Secara opsional, Anda dapat melakukan hal berikut:
Langkah berikutnya
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-11 UTC.
-