Mengonfigurasi kebijakan mulai ulang untuk instance

Pratinjau — Instance Cloud Run

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Kebijakan mulai ulang instance Cloud Run menentukan apakah dan kapan instance harus dimulai ulang.

Opsi kebijakan mulai ulang

Pilih dari kebijakan mulai ulang berikut:

• on-failure (default): Jika ada container yang keluar dengan kode status bukan nol, atau jika container mengalami kegagalan infrastruktur, instance akan dimulai ulang. Untuk instance multi-container, hal ini berarti container yang gagal akan menyebabkan seluruh instance dimulai ulang.
• always: Saat container keluar, instance akan selalu dimulai ulang. Hal ini mencakup keluar bersih dengan kode 0.
• never: Instance tidak pernah dimulai ulang. Saat container dihentikan, instance akan segera bertransisi ke status STOPPED atau FAILED.

Saat Anda mengonfigurasi kebijakan mulai ulang always atau on-failure untuk instance, instance Anda akan otomatis dimulai ulang pada akhir siklus proses sekitar 7 hari, sehingga berjalan tanpa batas waktu kecuali jika terganggu.

Catatan: Jika instance Cloud Run multi-container memiliki kebijakan mulai ulang yang ditetapkan ke always dan container keluar dengan kode 0, Cloud Run akan menghentikan instance, bukan memulainya ulang.

Peran yang diperlukan

Guna mendapatkan izin yang Anda perlukan untuk mengonfigurasi dan men-deploy instance Cloud Run, minta administrator Anda untuk memberi Anda peran IAM berikut:

• Developer Cloud Run (roles/run.developer) di instance Cloud Run
• Pengguna Akun Layanan (roles/iam.serviceAccountUser) di identitas layanan

Untuk mengetahui daftar peran dan izin IAM yang terkait dengan Cloud Run, lihat Peran IAM Cloud Run dan Izin IAM Cloud Run. Jika instance Cloud Run Anda berinteraksi dengan Google Cloud API, seperti Cloud Client Libraries, lihat panduan konfigurasi identitas layanan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat izin deployment dan mengelola akses.

Mengonfigurasi kebijakan mulai ulang

Konfigurasi kebijakan mulai ulang untuk instance Cloud Run menggunakan Google Cloud CLI atau YAML:

gcloud

Untuk menentukan kebijakan mulai ulang saat men-deploy instance baru:

gcloud beta run instances deploy INSTANCE \
    --image=IMAGE_URL \
    --restart-policy=POLICY

Untuk memperbarui kebijakan mulai ulang instance yang ada:

gcloud beta run instances update INSTANCE \
    --restart-policy=POLICY

Ganti kode berikut:

• INSTANCE: nama instance.
• IMAGE_URL: referensi ke image container, seperti us-docker.pkg.dev/cloudrun/container/hello:latest.
• POLICY: kebijakan mulai ulang yang akan diterapkan. Pilih dari on-failure, always, atau never.

YAML

1. Jika Anda membuat instance baru, lewati langkah ini. Jika Anda memperbarui instance yang ada, download konfigurasi YAML-nya:

   gcloud beta run instances describe INSTANCE --format export > instance.yaml

2. Contoh berikut berisi konfigurasi YAML:

   apiVersion: run.googleapis.com/v1
   kind: Instance
   metadata:
     name: INSTANCE
     annotations:
       run.googleapis.com/launch-stage: BETA
   spec:
     containers:
     - name: CONTAINER_NAME
       image: IMAGE_URL
     restartPolicy: POLICY

   Ganti kode berikut:

   • INSTANCE: nama instance Cloud Run Anda.
   • CONTAINER_NAME: nama container.
   • IMAGE_URL: referensi ke image container, seperti us-docker.pkg.dev/cloudrun/container/hello:latest.
   • POLICY: kebijakan mulai ulang yang akan diterapkan. Pilih dari on-failure, always, atau never.

3. Buat atau perbarui instance menggunakan perintah berikut:

   gcloud beta run instances replace instance.yaml