Halaman ini menjelaskan cara mengonfigurasi perintah entrypoint dan argumen untuk kumpulan pekerja Cloud Run.
Saat Cloud Run memulai container, Cloud Run akan menjalankan
perintah entrypoint default dan argumen perintah default image. Jika Anda ingin
mengganti entrypoint default dan argumen perintah image, Anda dapat menggunakan
kolom command
dan args
dalam konfigurasi container. Kolom command
menentukan perintah sebenarnya yang dijalankan oleh container. Kolom args
menentukan
argumen yang diteruskan ke perintah tersebut.
Perhatikan bahwa Anda dapat memiliki maksimum 1.000 argumen per penampung untuk setiap worker pool.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk mengonfigurasi dan men-deploy kumpulan pekerja Cloud Run, minta administrator Anda untuk memberi Anda peran IAM berikut:
-
Cloud Run Developer (
roles/run.developer
) di kumpulan pekerja Cloud Run -
Service Account User (
roles/iam.serviceAccountUser
) pada 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 kumpulan pekerja Cloud Run Anda berinteraksi dengan Google Cloud API, seperti Library Klien Cloud, lihat panduan konfigurasi identitas layanan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat izin deployment dan mengelola akses.
Mengonfigurasi entrypoint dan argumen
Perubahan konfigurasi apa pun akan menghasilkan revisi baru. Revisi berikutnya juga akan secara otomatis mendapatkan setelan konfigurasi ini, kecuali jika Anda melakukan update yang eksplisit untuk mengubahnya.
Perintah dan argumen container yang ditentukan akan menggantikan
ENTRYPOINT
dan CMD
image default.
Anda dapat menetapkan perintah dan argumen entrypoint untuk kumpulan pekerja Cloud Run menggunakan Google Cloud konsol, Google Cloud CLI, atau Terraform:
Konsol
Di konsol Google Cloud , buka Cloud Run:
Pilih Worker pools dari menu, lalu klik Deploy container untuk mengonfigurasi worker pool baru. Jika Anda mengonfigurasi pool worker yang sudah ada, klik pool worker, lalu klik Edit dan deploy revisi baru.
Jika Anda mengonfigurasi kumpulan pekerja baru, isi halaman kumpulan pekerja awal, lalu klik Container, Volume, Jaringan, Keamanan untuk meluaskan halaman konfigurasi kumpulan pekerja.
Klik tab Container.
- Tentukan perintah yang Anda inginkan untuk dijalankan container jika Anda tidak ingin menggunakan perintah titik entri yang ditentukan di image container. Secara opsional, tentukan argumen untuk perintah entrypoint.
Klik Buat atau Deploy.
gcloud
Untuk memperbarui perintah dan argumen awal untuk layanan yang ada:
gcloud beta run worker-pools update WORKER_POOL --command COMMAND --args ARG1,ARG-N
Ganti kode berikut:
- WORKER_POOL: nama pool pekerja.
- COMMAND: perintah yang digunakan untuk memulai container, jika Anda tidak menggunakan perintah default.
- ARG1: argumen yang Anda kirim ke perintah container. Gunakan daftar yang dipisahkan koma untuk argumen yang lebih dari satu.
Untuk menentukan entrypoint dan argumen selama deployment worker pool baru atau yang sudah ada:
gcloud beta run worker-pools deploy --image IMAGE_URL --command COMMAND --args ARG1,ARG-N
Ganti IMAGE_URL dengan referensi ke image container yang
berisi kumpulan pekerja, seperti us-docker.pkg.dev/cloudrun/container/worker-pool:latest
.
Jika Anda ingin memulihkan default container untuk perintah dan argumen entrypoint, berikan string kosong seperti berikut:
gcloud beta run worker-pools deploy --image IMAGE_URL --command "" --args ""
Terraform
Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.
resource "google_cloud_run_v2_worker_pool" "default" {
name = "WORKER_POOL"
location = "REGION"
launch_stage = "BETA"
template {
containers {
image = "IMAGE_URL"
command = ["COMMAND"]
args = ["ARG1", "ARG2"]
}
}
}
Ganti kode berikut:
- WORKER_POOL: nama pool pekerja.
- REGION: Google Cloud region—misalnya,
europe-west1
. - IMAGE_URL: referensi ke image container yang
berisi worker pool, seperti
us-docker.pkg.dev/cloudrun/container/worker-pool:latest
. - COMMAND: perintah yang digunakan untuk memulai container, jika Anda tidak menggunakan perintah default.
- ARG1, ARG2: argumen yang Anda kirim ke perintah container.
Mengonfigurasi urutan awal container untuk deployment file bantuan
Untuk menentukan urutan pengaktifan container dalam deployment sidecar, gunakan fitur dependensi container. Tentukan container yang memiliki dependensi dan cantumkan container yang menjadi dependensinya, sehingga container tersebut dimulai terlebih dahulu. Container yang tidak memiliki dependensi apa pun selalu dimulai terlebih dahulu dan secara serentak.
Agar berhasil menggunakan fitur ini, Anda harus menggunakan pemeriksaan kondisi proses mulai sistem. Pemeriksaan proses mulai sistem memungkinkan Cloud Run memeriksa kondisi container dependen, sehingga memastikan container berhasil lulus sebelum memulai container berikutnya. Jika Anda tidak menggunakan pemeriksaan kondisi, container akan dimulai dalam urutan yang ditentukan meskipun container yang menjadi dependensinya gagal dimulai.
Perhatikan bahwa tidak ada pemeriksaan kondisi startup default untuk kumpulan pekerja.
Gunakan konsol Google Cloud atau Google Cloud CLI untuk menentukan urutan startup:
Konsol
Di konsol Google Cloud , buka halaman Cloud Run:
- Pilih Worker pool dari menu.
- Untuk kumpulan pekerja yang ada, klik kumpulan pekerja dalam daftar, lalu pilih Edit dan deploy revisi baru untuk menampilkan formulir deployment revisi.
- Untuk kumpulan pekerja baru, klik Deploy container untuk menampilkan formulir Create worker pool.
Untuk kumpulan pekerja baru, tentukan nama kumpulan pekerja, URL penampung masuknya, alokasi CPU, kontrol masuknya, dan autentikasi. Di tab Container(s), Volumes, Networking, Security, lakukan hal berikut:
- Konfigurasi container ingress.
- Untuk menambahkan setiap penampung lain yang Anda deploy, klik Tambahkan penampung.
- Untuk semua container kecuali container ingress, konfigurasi health check saat startup.
- Jika container perlu dimulai setelah container lain tertentu, pilih container tersebut di menu Urutan pengaktifan container.
Untuk kumpulan pekerja yang ada, ikuti langkah-langkah berikut:
- Untuk semua container kecuali container ingress, konfigurasi health check saat startup.
- Setiap penampung ditampilkan dengan menu Urutan peluncuran penampung sendiri. Jika container memerlukan container lain untuk dimulai terlebih dahulu sebelum dapat dimulai, gunakan menu Urutan pengaktifan container untuk memilih container yang harus dimulai terlebih dahulu.
Selesaikan konfigurasi lain yang diperlukan, lalu klik Buat untuk kumpulan pekerja baru atau Deploy untuk kumpulan pekerja yang ada. Tunggu hingga deployment selesai.
gcloud
Sebelum menggunakan Google Cloud CLI untuk menentukan urutan startup, konfigurasi pemeriksaan kondisi startup.
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Untuk men-deploy beberapa container ke layanan dengan urutan startup yang ditentukan, jalankan perintah:
- WORKER_POOL: nama pool pekerja.
- IMAGE_URL: referensi ke image container yang
berisi worker pool, seperti
us-docker.pkg.dev/cloudrun/container/worker-pool:latest
. SIDECAR_IMAGE: referensi ke image container file bantuan.
Jika Anda ingin mengonfigurasi setiap container dalam perintah deployment, berikan konfigurasi setiap container setelah parameter
container
.
gcloud beta run worker-pools deploy WORKER_POOL \ --container CONTAINER_1_NAME --image='WORKER_POOL_IMAGE' --container CONTAINER_2_NAME --image='SIDECAR_IMAGE' --depends-on=CONTAINER_1_NAME \ --container CONTAINER_3_NAME --image='SIDECAR_IMAGE' --depends-on=CONTAINER_1_NAME,CONTAINER_2_NAME
Ganti kode berikut:
Melihat konfigurasi container untuk kumpulan pekerja
Di konsol Google Cloud , buka Cloud Run:
Klik Worker pools untuk menampilkan daftar worker pool yang di-deploy.
Klik kumpulan pekerja yang ingin Anda periksa untuk menampilkan panel detailnya.
Klik tab Containers untuk menampilkan konfigurasi container kumpulan pekerja.