Dokumen ini menjelaskan cara mengaktifkan penghentian yang wajar di instance Compute Engine baru atau yang sudah ada. Untuk mempelajari shutdown halus lebih lanjut, lihat Ringkasan shutdown halus.
Saat mengaktifkan shutdown yang baik di instance, Anda dapat memberi OS tamunya hingga satu jam untuk dimatikan dengan baik saat Anda menghentikan atau menghapus instance. Tindakan ini membantu mencegah kemungkinan kehilangan data atau kerusakan sistem file.
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
Untuk membuat instance:
compute.instances.create
pada project- Untuk menggunakan image kustom guna membuat VM:
compute.images.useReadOnly
pada image - Untuk menggunakan snapshot guna membuat VM:
compute.snapshots.useReadOnly
pada snapshot - Untuk menggunakan template instance guna membuat VM:
compute.instanceTemplates.useReadOnly
di template instance - Untuk menetapkan jaringan lama ke VM:
compute.networks.use
di project - Untuk menentukan alamat IP statis untuk VM:
compute.addresses.use
pada project - Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan lama:
compute.networks.useExternalIp
di project - Untuk menentukan subnet bagi VM:
compute.subnetworks.use
di project atau di subnet yang dipilih - Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan VPC:
compute.subnetworks.useExternalIp
di project atau di subnet yang dipilih - Untuk menetapkan metadata instance VM untuk VM:
compute.instances.setMetadata
pada project - Untuk menetapkan tag untuk VM:
compute.instances.setTags
di VM - Untuk menetapkan label untuk VM:
compute.instances.setLabels
di VM - Untuk menetapkan akun layanan yang akan digunakan VM:
compute.instances.setServiceAccount
di VM - Untuk membuat disk baru bagi VM:
compute.disks.create
pada project - Untuk memasang disk yang ada dalam mode hanya baca atau baca-tulis:
compute.disks.use
pada disk - Untuk memasang disk yang ada dalam mode hanya baca:
compute.disks.useReadOnly
pada disk
-
Untuk membuat template instance:
compute.instanceTemplates.create
pada project -
Untuk mengaktifkan penonaktifan yang wajar di instance yang ada:
compute.instances.update
pada instance Mengaktifkan penonaktifan halus saat membuat instance secara massal
Mengaktifkan penghentian yang wajar saat membuat template instance
Di konsol Google Cloud, buka halaman Instance VM.
Di kolom Name, klik nama instance tempat Anda ingin mengaktifkan penghentian yang halus.
Halaman detail instance akan terbuka.
Klik
Edit.Di bagian Pengelolaan, lakukan hal berikut:
Centang kotak Nonaktifkan VM dengan baik.
Opsional: Untuk menentukan periode penonaktifan halus kustom, tentukan durasi di kolom Durasi maksimum.
Klik Save.
INSTANCE_NAME
: nama instance.ZONE
: zona tempat instance berada.Buat file JSON kosong.
Untuk melihat properti instance yang ada, buat permintaan
GET
ke metodeinstances.get
beta:GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
Ganti kode berikut:
PROJECT_ID
: ID project tempat instance berada.ZONE
: zona tempat instance berada.INSTANCE_NAME
: nama instance yang ada.
Dalam file JSON kosong yang Anda buat di langkah sebelumnya, lakukan hal berikut:
Masukkan detail konfigurasi instance dari output permintaan
GET
.Di kolom
scheduling
, tambahkan kolomgracefulShutdown
sebagai berikut:{ ... "scheduling": { ... "gracefulShutdown": { "enabled": true } }, ... }
Secara opsional, untuk menentukan periode penonaktifan halus kustom, sertakan kolom
maxDuration
:{ ... "scheduling": { ... "gracefulShutdown": { ... "enabled": true, "maxDuration": { "seconds": "MAX_DURATION" } } }, ... }
Ganti
MAX_DURATION
dengan durasi dalam detik untuk periode penonaktifan halus. Nilainya harus antara1
dan3600
, yaitu 3.600 detik (satu jam).
Untuk mengupdate instance dan memulai ulang, buat permintaan
PUT
ke metodeinstances.update
beta. Dalam permintaan, lakukan hal berikut:Di URL permintaan, sertakan parameter kueri
mostDisruptiveAllowedAction
yang ditetapkan keRESTART
.Dalam isi permintaan, sertakan properti instance dari file JSON yang Anda buat dan perbarui di langkah sebelumnya.
Permintaan
PUT
untuk mengupdate instance mirip dengan berikut ini:PUT https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?mostDisruptiveAllowedAction=RESTART { ... "scheduling": { ... "gracefulShutdown": { "enabled": true } }, ... }
Di konsol Google Cloud, buka halaman Instance VM.
Klik Create instance.
Halaman Create an instance akan terbuka.
Tentukan Nama untuk instance.
Tentukan Region dan Zone tempat instance akan dibuat.
Tentukan jenis mesin untuk instance.
Di menu navigasi, klik Lanjutan.
Luaskan bagian
VM provisioning model advanced settings, lalu lakukan hal berikut:Centang kotak Nonaktifkan VM dengan baik.
Opsional: Untuk menentukan periode penonaktifan halus kustom, tentukan durasi di kolom Durasi maksimum.
Klik Create.
INSTANCE_NAME
: nama instance.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk instance.ZONE
: zona tempat instance dibuat.PROJECT_ID
: ID project tempat instance akan dibuat.ZONE
: zona tempat instance dibuat.INSTANCE_NAME
: nama instance.MACHINE_TYPE
: jenis mesin untuk instance.IMAGE_PROJECT
: project image yang berisi image—misalnya,debian-cloud
. Untuk informasi selengkapnya tentang project image yang didukung, lihat Image publik.IMAGE
: tentukan salah satu dari hal berikut:Versi tertentu dari image OS—misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Format ini menentukan image OS terbaru yang masih digunakan. 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.
COUNT
: jumlah instance yang akan dibuat.MACHINE_TYPE
: jenis mesin untuk instance.NAME_PATTERN
: pola nama untuk instance. Untuk mengganti urutan angka dalam nama instance, gunakan urutan karakter hash (#
). Misalnya, menggunakaninstance-#
untuk pola nama akan menghasilkan instance dengan nama yang dimulai denganinstance-1
,instance-2
, dan berlanjut hingga jumlah instance yang ditentukan olehCOUNT
.ZONE
: zona tempat membuat instance secara massal.PROJECT_ID
: ID project tempat membuat instance secara massal.ZONE
: zona tempat membuat instance secara massal.COUNT
: jumlah instance yang akan dibuat.NAME_PATTERN
: pola nama untuk instance. Untuk mengganti urutan angka dalam nama instance, gunakan urutan karakter hash (#
). Misalnya, menggunakaninstance-#
untuk pola nama akan menghasilkan instance dengan nama yang dimulai denganinstance-1
,instance-2
, dan berlanjut hingga jumlah instance yang ditentukan olehCOUNT
.MACHINE_TYPE
: jenis mesin untuk instance.IMAGE_PROJECT
: project image yang berisi image—misalnya,debian-cloud
. Untuk informasi selengkapnya tentang project image yang didukung, lihat Image publik.IMAGE
: tentukan salah satu dari hal berikut:Versi tertentu dari image OS—misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Format ini menentukan image OS terbaru yang masih digunakan. 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.
ZONE
: zona tempat membuat instance secara massal.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.
Pilih Lokasi sebagai berikut:
Untuk mengurangi dependensi lintas region dengan membuat template instance regional, lakukan tindakan berikut:
Pilih Regional, jika belum dipilih.
Di kolom Region, pilih region tempat membuat template instance.
Jika tidak, untuk menggunakan template instance di seluruh region, pilih Global.
Di bagian Machine configuration, tentukan jenis mesin.
Luaskan bagian
VM provisioning model advanced settings, lalu lakukan hal berikut:Centang kotak Nonaktifkan VM dengan baik.
Opsional: Untuk menentukan periode penonaktifan halus kustom, tentukan durasi di kolom Durasi maksimum.
Klik Create.
INSTANCE_TEMPLATE_NAME
: nama template instance.REGION
: region tempat membuat template instance.MACHINE_TYPE
: jenis mesin untuk instance yang dibuat menggunakan template instance.Untuk membuat template instance global: metode
instanceTemplates.insert
beta.Untuk membuat template instance regional: metode
regionInstanceTemplates.insert
beta.PROJECT_ID
: ID project tempat membuat template instance.REGION
: region tempat membuat template instance.INSTANCE_TEMPLATE_NAME
: nama template instance.IMAGE_PROJECT
: project image yang berisi image—misalnya,debian-cloud
. Untuk informasi selengkapnya tentang project image yang didukung, lihat Image publik.IMAGE
: tentukan salah satu dari hal berikut:Versi tertentu dari image OS—misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Format ini menentukan image OS terbaru yang masih digunakan. 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 untuk instance yang dibuat menggunakan template instance.
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.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna mengaktifkan penghentian yang wajar di instance komputasi, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (
roles/compute.instanceAdmin.v1
) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.Peran bawaan ini berisi izin yang diperlukan untuk mengaktifkan penghentian yang wajar di instance komputasi. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk mengaktifkan penghentian halus di instance komputasi:
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Mengaktifkan penonaktifan yang halus
Untuk mengaktifkan penonaktifan yang halus di instance komputasi, gunakan salah satu metode berikut:
Mengaktifkan penonaktifan yang wajar di instance yang ada
Anda dapat mengaktifkan penghentian yang wajar di instance komputasi yang ada tanpa menghentikan atau memulai ulang instance tersebut. Periode penonaktifan halus default adalah 10 menit, tetapi Anda dapat menentukan periode penonaktifan kustom antara satu detik dan satu jam.
Untuk mengaktifkan penghentian yang wajar di instance yang ada, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk mengaktifkan penonaktifan yang halus di instance yang ada, gunakan perintah
gcloud beta compute instances update
dengan flag--graceful-shutdown
:gcloud beta compute instances update INSTANCE_NAME \ --graceful-shutdown \ --zone=ZONE
Ganti kode berikut:
Secara opsional, untuk menentukan periode penonaktifan halus kustom, sertakan flag
--graceful-shutdown-max-duration
:gcloud beta compute instances update INSTANCE_NAME \ --graceful-shutdown \ --graceful-shutdown-max-duration=MAX_DURATION \ --zone=ZONE
Ganti
MAX_DURATION
dengan durasi untuk periode penonaktifan. Nilai harus diformat sebagai jumlah jam, menit, atau detik yang diikuti denganh
,m
, dans
. Misalnya, tentukan1h
selama satu jam, atau20m10s
selama 20 menit dan 10 detik.REST
Untuk mengetahui informasi selengkapnya tentang cara memperbarui properti instance, lihat Memperbarui properti instance.
Mengaktifkan penonaktifan halus saat membuat instance
Saat Anda membuat instance komputasi yang mengaktifkan penghentian normal, periode penghentian default adalah 10 menit. Secara opsional, Anda dapat menentukan periode penonaktifan kustom antara satu detik dan satu jam.
Untuk membuat instance yang mengaktifkan penghentian halus, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk membuat instance yang mengaktifkan penghentian halus, gunakan perintah
gcloud beta compute instances create
dengan flag--graceful-shutdown
:gcloud beta compute instances create INSTANCE_NAME \ --graceful-shutdown \ --machine-type=MACHINE_TYPE \ --zone=ZONE
Ganti kode berikut:
Secara opsional, untuk menentukan periode penonaktifan halus kustom, sertakan flag
--graceful-shutdown-max-duration
:gcloud beta compute instances create INSTANCE_NAME \ --graceful-shutdown \ --graceful-shutdown-max-duration=MAX_DURATION \ --machine-type=MACHINE_TYPE \ --zone=ZONE
Ganti
MAX_DURATION
dengan durasi untuk periode penonaktifan halus. Nilai harus diformat sebagai jumlah jam, menit, atau detik yang diikuti denganh
,m
, dans
. Misalnya, tentukan1h
selama satu jam, atau20m10s
selama 20 menit dan 10 detik.REST
Untuk membuat instance yang mengaktifkan penghentian halus, buat permintaan
POST
ke metodebeta.instances.insert
. Dalam isi permintaan, sertakan kolomgracefulShutdown
:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances { "name": "INSTANCE_NAME", "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "scheduling": { "gracefulShutdown": { "enabled": true } } }
Ganti kode berikut:
Secara opsional, untuk menentukan periode penonaktifan halus kustom, sertakan kolom
maxDuration
dalam isi permintaan:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances { "name": "INSTANCE_NAME", "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "scheduling": { "gracefulShutdown": { "enabled": true, "maxDuration": { "seconds": "MAX_DURATION" } } } }
Ganti
MAX_DURATION
dengan durasi dalam detik untuk periode penonaktifan yang wajar. Nilainya harus antara1
dan3600
, yaitu 3.600 detik (satu jam).Untuk mengetahui opsi konfigurasi lainnya saat membuat instance, lihat Membuat dan memulai instance Compute Engine.
Mengaktifkan penonaktifan halus saat membuat instance secara massal
Saat Anda membuat instance komputasi secara massal yang mengaktifkan penonaktifan halus, periode penonaktifan default-nya adalah 10 menit. Secara opsional, Anda dapat menentukan periode penonaktifan kustom antara satu detik dan satu jam.
Untuk membuat instance secara massal yang mengaktifkan penonaktifan yang baik, pilih salah satu opsi berikut:
gcloud
Untuk membuat instance secara massal yang mengaktifkan penghentian halus, gunakan perintah
gcloud beta compute instances bulk create
dengan flag--graceful-shutdown
.Misalnya, untuk membuat instance secara massal di satu zona dan menentukan pola nama untuk instance, jalankan perintah berikut:
gcloud beta compute instances bulk create \ --count=COUNT \ --graceful-shutdown \ --machine-type=MACHINE_TYPE \ --name-pattern="NAME_PATTERN" \ --zone=ZONE
Ganti kode berikut:
Secara opsional, untuk menentukan periode penonaktifan halus kustom, sertakan flag
--graceful-shutdown-max-duration
:gcloud beta compute instances bulk create \ --count=COUNT \ --graceful-shutdown \ --graceful-shutdown-max-duration=MAX_DURATION \ --machine-type=MACHINE_TYPE \ --name-pattern="NAME_PATTERN" \ --zone=ZONE
Ganti
MAX_DURATION
dengan durasi untuk periode penonaktifan halus. Nilai harus diformat sebagai jumlah jam, menit, atau detik yang diikuti denganh
,m
, dans
. Misalnya, tentukan1h
selama satu jam, atau20m10s
selama 20 menit dan 10 detik.REST
Untuk membuat instance secara massal yang mengaktifkan penghentian halus, buat permintaan
POST
ke metodeinstances.bulkInsert
beta. Dalam isi permintaan, sertakan kolomgracefulShutdown
.Misalnya, untuk membuat instance secara massal di satu zona dan menentukan pola nama untuk instance, buat permintaan
POST
sebagai berikut:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert { "count": COUNT, "namePattern": "NAME_PATTERN", "instanceProperties": { "machineType": "MACHINE_TYPE", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "scheduling": { "gracefulShutdown": { "enabled": true } } } }
Ganti kode berikut:
Secara opsional, untuk menentukan periode penonaktifan halus kustom, sertakan kolom
maxDuration
dalam isi permintaan:POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert { "count": COUNT, "namePattern": "NAME_PATTERN", "instanceProperties": { "machineType": "MACHINE_TYPE", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "scheduling": { "gracefulShutdown": { "enabled": true, "maxDuration": { "seconds": "MAX_DURATION" } } } } }
Ganti
MAX_DURATION
dengan durasi dalam detik untuk periode penonaktifan yang wajar. Nilainya harus antara1
dan3600
, yaitu 3.600 detik (satu jam).Untuk mengetahui opsi konfigurasi lainnya saat membuat instance secara massal, lihat Membuat VM secara massal.
Mengaktifkan penonaktifan halus saat membuat template instance
Saat Anda membuat template instance yang mengaktifkan penonaktifan halus, periode penonaktifan default adalah 10 menit. Secara opsional, Anda dapat menentukan periode penonaktifan kustom antara satu detik dan satu jam.
Semua instance komputasi yang dibuat menggunakan template instance telah mengaktifkan penghentian yang wajar.
Untuk membuat template instance yang mengaktifkan penghentian halus, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk membuat template instance yang mengaktifkan penghentian halus, gunakan perintah
gcloud beta compute instance-templates create
dengan flag--graceful-shutdown
.Misalnya, untuk membuat template instance regional yang mengaktifkan penonaktifan halus, jalankan perintah berikut:
gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \ --graceful-shutdown \ --instance-template-region=REGION \ --machine-type=MACHINE_TYPE
Ganti kode berikut:
Secara opsional, untuk menentukan periode penonaktifan halus kustom, sertakan flag
--graceful-shutdown-max-duration
.gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \ --graceful-shutdown \ --graceful-shutdown-max-duration=MAX_DURATION \ --instance-template-region=REGION \ --machine-type=MACHINE_TYPE
Ganti
MAX_DURATION
dengan durasi untuk periode penonaktifan. Nilai harus diformat sebagai jumlah jam, menit, atau detik yang diikuti denganh
,m
, dans
. Misalnya, tentukan1h
selama satu jam, atau20m10s
selama 20 menit dan 10 detik.REST
Untuk membuat template instance yang mengaktifkan penonaktifan yang baik, buat permintaan
POST
ke salah satu metode berikut:Misalnya, untuk membuat template instance regional yang mengaktifkan penghentian yang halus, buat permintaan
POST
sebagai 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" } ], "scheduling": { "gracefulShutdown": { "enabled": true } } } }
Ganti kode berikut:
Secara opsional, untuk menentukan periode penonaktifan halus kustom, sertakan kolom
maxDuration
dalam isi permintaan.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/global/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" } ], "scheduling": { "gracefulShutdown": { "enabled": true, "maxDuration": { "seconds": "MAX_DURATION" } } } } }
Ganti
MAX_DURATION
dengan durasi dalam detik untuk periode penonaktifan. Nilainya harus antara1
dan3600
, yaitu 3.600 detik (satu jam).Untuk opsi konfigurasi lainnya saat membuat template instance, lihat Membuat template instance.
Langkah selanjutnya
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-01-31 UTC.
-