Halaman ini menjelaskan cara menentukan lingkungan eksekusi instance Cloud Run. Layanan Cloud Run secara default tidak memiliki lingkungan eksekusi yang ditentukan. Artinya, Cloud Run memilih lingkungan eksekusi berdasarkan fitur yang digunakan. Jika Anda tidak menentukan lingkungan eksekusi untuk layanan Anda, Cloud Run dapat memilih lingkungan generasi pertama atau generasi kedua.
Perhatikan bahwa tugas Cloud Run hanya menggunakan lingkungan eksekusi generasi kedua, dan hal ini tidak dapat diubah untuk tugas.
Lihat dokumentasi konsep lingkungan eksekusi untuk mendapatkan bantuan dalam memilih lingkungan yang terbaik untuk layanan Anda.
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk mengonfigurasi dan men-deploy layanan Cloud Run, minta administrator untuk memberi Anda peran IAM berikut:
-
Cloud Run Developer (
roles/run.developer
) di layanan Cloud Run -
Service Account User (
roles/iam.serviceAccountUser
) pada identitas layanan
Untuk daftar peran dan izin IAM yang terkait dengan Cloud Run, lihat Peran IAM Cloud Run dan izin IAM Cloud Run. Jika layanan Cloud Run Anda berinteraksi dengan Google Cloud API, seperti Library Klien Cloud, lihat panduan konfigurasi identitas layanan. Untuk mengetahui informasi selengkapnya tentang memberikan peran, lihat izin deployment dan mengelola akses.
Menyetel dan memperbarui lingkungan eksekusi
Setiap perubahan konfigurasi akan menghasilkan revisi baru. Revisi selanjutnya juga akan otomatis mendapatkan setelan konfigurasi ini, kecuali jika Anda melakukan pembaruan eksplisit untuk mengubahnya.
Setelan default untuk layanan Cloud Run adalah belum ditetapkan, artinya Cloud Run memilih lingkungan eksekusi yang sesuai. Atau, Anda dapat menentukan lingkungan eksekusi. Untuk menggunakan generasi kedua, Anda harus menentukan memori minimal 512 MiB.
Anda dapat menetapkan lingkungan eksekusi menggunakan Konsol Google Cloud, command line gcloud, atau file YAML saat membuat layanan baru atau men-deploy revisi baru:
Konsol
Di konsol Google Cloud, buka Cloud Run:
Klik Buat Layanan jika Anda mengonfigurasi layanan baru yang akan di-deploy. Jika Anda mengonfigurasi layanan yang ada, klik layanan, lalu klik Edit and deploy new revision.
Jika Anda mengonfigurasi layanan baru, isi halaman setelan layanan awal sesuai keinginan, kemudian klik Container, vo;ume, jejaring, sekuritas untuk memperluas halaman konfigurasi layanan.
Klik tab Container.
- Pilih lingkungan eksekusi yang diinginkan menggunakan tombol opsi. Pertahankan "Default" untuk mengizinkan Cloud Run memilih lingkungan eksekusi yang sesuai.
Klik Buat atau Deploy.
Command line
Anda dapat memperbarui lingkungan eksekusi untuk layanan tertentu menggunakan perintah berikut:
gcloud run services update SERVICE --execution-environment ENVIRONMENT
Ganti SERVICE dengan nama layanan Anda dan ENVIRONMENT dengan lingkungan eksekusi yang diinginkan. Tentukan nilai gen1
untuk generasi
pertama atau gen2
untuk generasi kedua.
Anda juga dapat menetapkan lingkungan eksekusi selama deployment menggunakan perintah:
gcloud run deploy --image IMAGE_URL --execution-environment ENVIRONMENT
Ganti
- IMAGE_URL dengan referensi ke image container
misalnya,
us-docker.pkg.dev/cloudrun/container/hello:latest
. Jika Anda menggunakan Artifact Registry, repositori REPO_NAME harus sudah dibuat. Struktur URL-nya adalahLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
ENVIRONMENT
dengan lingkungan eksekusi yang diinginkan. Tentukan nilaigen1
untuk generasi pertama ataugen2
untuk generasi kedua.
YAML
Jika Anda membuat layanan baru, lewati langkah ini. Jika Anda mengupdate layanan yang ada, download konfigurasi YAML:
gcloud run services describe SERVICE --format export > service.yaml
setel anotasi
run.googleapis.com/execution-environment
:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: annotations: run.googleapis.com/execution-environment: ENVIRONMENT
Ganti
- SERVICE dengan nama layanan Cloud Run Anda
- ENVIRONMENT dengan lingkungan eksekusi yang dipilih.
Tentukan nilai
gen1
untuk generasi pertama ataugen2
untuk generasi kedua.
Hapus anotasi
run.googleapis.com/execution-environment
untuk perilaku default.Buat atau update layanan menggunakan perintah berikut:
gcloud run services replace service.yaml
Tampilan setelan lingkungan eksekusi
Untuk melihat setelan lingkungan Eksekusi saat ini untuk layanan Cloud Run Anda:
Konsol
Di konsol Google Cloud, buka Cloud Run:
Klik layanan yang Anda minati untuk membuka halaman Detail layanan.
Klik tab Revisi.
Di panel detail di sebelah kanan, setelan lingkungan Eksekusi tercantum di bagian tab Container.
Command line
Gunakan perintah berikut:
gcloud run services describe SERVICE
Temukan setelan lingkungan Eksekusi dalam konfigurasi yang ditampilkan.