Halaman ini diterjemahkan oleh Cloud Translation API.

Menjalankan skrip shutdown

Linux Windows

Buat dan jalankan skrip shutdown yang menjalankan perintah tepat sebelum instance virtual machine (VM) dihentikan atau dimulai ulang. Hal ini berguna jika Anda mengandalkan skrip otomatis untuk memulai dan mematikan instance, sehingga instance memiliki waktu untuk membersihkan atau melakukan tugas, seperti mengekspor log, atau menyinkronkan dengan sistem lain.

Skrip shutdown sangat berguna untuk VM dalam grup instance terkelola dengan autoscaler. Jika autoscaler menghentikan VM dalam grup, skrip shutdown akan berjalan sebelum VM berhenti dan skrip shutdown akan melakukan tindakan apa pun yang Anda tentukan. Skrip ini berjalan selama periode shutdown terbatas sebelum VM berhenti. Misalnya, skrip shutdown Anda mungkin menyalin data yang diproses ke Cloud Storage atau mencadangkan log apa pun.

Skrip shutdown memiliki fungsi yang sangat mirip dengan skrip startup. Banyak dokumentasi untuk skrip startup juga berlaku untuk skrip shutdown.

Untuk tugas shutdown dan mulai ulang, VM selalu menjalankan skrip shutdown sebagai berikut:

Untuk VM Linux, dengan menggunakan pengguna root.
Untuk VM Windows, dengan menggunakan akun System.

Sebelum memulai

Pelajari Skrip startup.
Pahami apa itu server metadata.
Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. 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
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus memiliki izin berikut:

Semua izin yang diperlukan untuk membuat instance
compute.instances.setMetadata pada instance

Spesifikasi

Batasan

Ada beberapa batasan yang perlu diperhatikan saat menggunakan skrip shutdown:

Compute Engine menjalankan skrip shutdown hanya berdasarkan upaya terbaik. Dalam kasus yang jarang terjadi, Compute Engine tidak dapat menjamin bahwa skrip shutdown akan selesai.
Di Windows, Local Group Policy digunakan untuk meluncurkan skrip shutdown.
- Paket penginstalan mengonfigurasi setelan Local Group Policy Computer Configuration/Windows Setting/Scripts (Startup/Shutdown) untuk meluncurkan skrip setelah penonaktifan sistem.

Menghentikan pemanggilan skrip

Skrip shutdown dipicu oleh Peristiwa konfigurasi lanjutan dan antarmuka daya (ACPI) tertentu, seperti mulai ulang atau berhenti. Ada banyak cara untuk memulai ulang atau menghentikan instance, tetapi hanya beberapa cara yang dapat memicu skrip shutdown agar berjalan. Skrip shutdown dijalankan sebagai bagian dari tindakan berikut:

Saat instance dihentikan dari operasi hentikan atau hapus.
Saat Compute Engine menghentikan preemptible instance sebagai bagian dari proses preemption.
Saat instance dihentikan melalui permintaan ke sistem operasi tamu, seperti sudo shutdown atau sudo reboot.

Skrip shutdown tidak akan berjalan jika instance direset menggunakan instances().reset.

Skrip shutdown dapat berupa jenis file apa pun. Jika ada skrip shutdown yang muncul, Compute Engine akan:

Menyalin skrip ke file lokal dalam instance.
Menetapkan izin pada file agar file tersebut dapat dieksekusi.
Menjalankan file saat instance dihentikan.

Misalnya, Anda dapat menyediakan skrip Python alih-alih skrip bash. Perlu diingat bahwa Compute Engine menjalankan skrip kata demi kata, apa pun jenis skripnya.

Untuk menjalankan skrip yang bukan merupakan bash, tambahkan baris shebang di bagian atas file untuk memberi tahu sistem operasi mana yang akan digunakan penafsir. Misalnya, untuk skrip Python, Anda dapat menambahkan baris Shebang seperti:

#!/usr/bin/python

Menghentikan waktu eksekusi skrip

Saat Compute Engine memulai operasi penghentian atau penghapusan instance, skrip shutdown akan mulai berjalan dan harus selesai berjalan dalam periode shutdown OS tamu. Periode shutdown OS tamu bervariasi berdasarkan jenis VM.

Jika Anda ingin menonaktifkan OS tamu hanya saat skrip penonaktifan selesai berjalan, maka hentikan instance dari dalam OS tamu.

Menggunakan skrip shutdown lokal

Skrip shutdown lokal adalah skrip yang ada di komputer lokal Anda. Teruskan skrip shutdown lokal sebagai file atau dengan memberikan kontennya secara langsung ke Compute Engine.

Skrip shutdown dapat melakukan tindakan sebanyak yang Anda butuhkan, tetapi jika Anda meneruskan file secara lokal, skrip Anda tidak boleh melebihi batas panjang nilai metadata sebesar 256 KB. Untuk menggunakan skrip yang melebihi batas panjang, simpan file Anda di Cloud Storage. Lihat Menggunakan skrip shutdown dari Cloud Storage untuk informasi lebih lanjut.

Memberikan file skrip shutdown

Anda hanya dapat meneruskan file skrip shutdown lokal melalui alat command line gcloud.

gcloud

Untuk meneruskan file skrip shutdown lokal, berikan flag --metadata-from-file, diikuti dengan pasangan kunci metadata, shutdown-script=PATH/TO/FILE, dengan PATH/TO/FILE sebagai jalur relatif ke skrip shutdown. Contoh:

gcloud compute instances create example-instance \
    --metadata-from-file shutdown-script=examples/scripts/install.sh

Terraform

Untuk menentukan skrip shutdown secara langsung, gunakan resource google_compute_instance dengan jalur ke skrip shutdown di metadata.

resource "google_compute_instance" "shutdown_content_from_file" {
  name         = "instance-name-shutdown-content-from-file"
  machine_type = "f1-micro"
  zone         = "us-central1-c"
  metadata = {
    # Shuts down Apache server
    shutdown-script = file("${path.module}/shutdown-script.sh")
  }
  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }
  network_interface {
    # A default network is created for all Google Cloud projects
    network = "default"
    access_config {
    }
  }
}

Menyediakan konten skrip shutdown secara langsung

Atau, Anda dapat meneruskan konten skrip shutdown secara langsung.

Konsol

Di Konsol Google Cloud, tentukan skrip shutdown secara langsung menggunakan kunci metadata shutdown-script:

Buka halaman Create an instance.

Buka Create an instance
Tentukan detail VM.
Luaskan bagian Advanced options.
Luaskan Management, dan lakukan tindakan berikut:
1. Di bagian Metadata, klik Add item.
2. Di kolom Key, masukkan shutdown-script untuk kunci metadata.
3. Di kolom Value, tambahkan konten skrip shutdown Anda.
Lanjutkan dengan proses pembuatan VM.

gcloud

Dengan menggunakan Google Cloud CLI, gunakan flag --metadata untuk memberikan isi skrip shutdown Anda, diikuti dengan pasangan kunci shutdown-script=CONTENTS, dengan CONTENTS sebagai konten skrip shutdown Anda.

gcloud compute instances create example-instance --metadata shutdown-script="#! /bin/bash
> # Shuts down Apache server
> /etc/init.d/apache2 stop"

Terraform

Untuk menentukan skrip shutdown secara langsung, gunakan resource google_compute_instance dengan skrip shutdown di metadata.

resource "google_compute_instance" "default" {
  name         = "instance-name-shutdown-content-directly"
  machine_type = "f1-micro"
  zone         = "us-central1-c"
  metadata = {
    # Shuts down Apache server
    shutdown-script = "#! /bin/bash /etc/init.d/apache2 stop"
  }
  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }
  network_interface {
    # A default network is created for all Google Cloud projects
    network = "default"
    access_config {
    }
  }
}

REST

Di API, berikan skrip shutdown sebagai bagian dari properti metadata dalam permintaan saat Anda membuat instance. Gunakan shutdown-script sebagai kunci metadata:

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances

{...
  "metadata": {
    "items": [
      {
       "key": "shutdown-script",
       "value": "#! /bin/bash\n\n# Shuts down Apache server\n/etc/init.d/apache2 stop"
      }
    ]
  }...
}

Menyediakan skrip shutdown pada instance Windows

Jalankan skrip shutdown pada instance Windows menggunakan kunci metadata khusus Windows berikut. Pilih dari salah satu tombol khusus yang tercantum di bawah. Setiap kunci harus cocok dengan jenis skrip yang ingin dijalankan.

Anda dapat menentukan beberapa skrip shutdown dengan meneruskan kunci yang berbeda ke instance, tetapi setiap kunci hanya dapat ditentukan sekali per virtual machine.

Kunci berikut dapat digunakan dengan skrip shutdown lokal, menggunakan petunjuk yang sama di atas.

Skrip shutdown `cmd`	Skrip shutdown `bat`	Skrip shutdown `ps1`
`windows-shutdown-script-cmd`	`windows-shutdown-script-bat`	`windows-shutdown-script-ps1`

Menggunakan skrip shutdown dari Cloud Storage

Anda dapat menyimpan dan menggunakan skrip shutdown dari Cloud Storage. Ikuti petunjuk dalam dokumentasi Skrip startup, tetapi ganti startup-script-url dengan shutdown-script-url.

Untuk instance Windows, ganti windows-startup-script-url dengan windows-shutdown-script-url.

Menerapkan skrip shutdown ke instance yang sedang berjalan

Untuk menambahkan skrip shutdown ke instance yang sedang berjalan, ikuti petunjuk dalam dokumentasi Menerapkan skrip startup ke instance yang berjalan, tetapi ganti kunci metadata dengan salah satu kunci berikut:

shutdown-script: Menyediakan konten skrip shutdown secara langsung dengan kunci ini. Dengan Google Cloud CLI, Anda dapat memberikan jalur ke file skrip shutdown, menggunakan flag --metadata-from-file dan kunci metadata shutdown-script.
shutdown-script-url: Menyediakan URL Cloud Storage ke file skrip shutdown dengan kunci ini.

Melihat output skrip shutdown

Linux

Anda dapat melihat output dari skrip shutdown Linux dengan melakukan salah satu hal berikut:

Menghubungkan ke instance dan menjalankan perintah berikut:
```
sudo journalctl -u google-shutdown-scripts.service
```
Melihat output melalui port serial 1 di Konsol Google Cloud dan memeriksa peristiwa google_metadata_script_runner.
Desktop IAP dari workstation Windows. Untuk mengetahui informasi selengkapnya, lihat repositori GoogleCloudPlatform/iap-desktop di GitHub.

Windows

Lihat output dari skrip shutdown Windows Server menggunakan salah satu dari yang berikut dan memeriksa peristiwa GCEMetadataScripts:

Port serial 1 di Konsol Google Cloud. Untuk informasi selengkapnya, lihat Melihat output port serial.
Log Aplikasi Penampil Acara Windows.
Desktop IAP dari workstation Windows. Untuk mengetahui informasi selengkapnya, lihat repositori GoogleCloudPlatform/iap-desktop di GitHub.

Menjalankan skrip shutdown

Sebelum memulai

Console

gcloud

Terraform

REST

Izin yang diperlukan untuk langkah ini

Spesifikasi

Batasan

Menghentikan pemanggilan skrip

Menghentikan waktu eksekusi skrip

Menggunakan skrip shutdown lokal

Memberikan file skrip shutdown

gcloud

Terraform

Menyediakan konten skrip shutdown secara langsung

Konsol

gcloud

Terraform

REST

Menyediakan skrip shutdown pada instance Windows

Menggunakan skrip shutdown dari Cloud Storage

Menerapkan skrip shutdown ke instance yang sedang berjalan

Melihat output skrip shutdown

Linux

Windows