Mengonfigurasi container untuk kumpulan pekerja

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:

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 pool worker Cloud Run menggunakan Google Cloud CLI saat Anda membuat pool worker baru atau men-deploy revisi baru:

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:

  • WORKER_POOL dengan nama kumpulan pekerja.
  • COMMAND dengan perintah yang digunakan untuk memulai container, jika Anda tidak menggunakan perintah default.
  • ARG1 dengan 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 ""

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 dapat menggunakan fitur ini dengan berhasil, Anda harus menggunakan pemeriksaan kondisi sistem saat startup. Pemeriksaan proses mulai sistem memungkinkan Cloud Run memeriksa kondisi container dependen, sehingga memastikan container berhasil lulus sebelum memulai container berikutnya. Jika Anda tidak menggunakan healthcheck, container akan dimulai dalam urutan yang ditentukan meskipun container yang menjadi dependensinya gagal dimulai.

Perhatikan bahwa tidak ada pemeriksaan kesehatan saat memulai default untuk probe kumpulan pekerja.

Gunakan Google Cloud CLI untuk menentukan urutan startup:

gcloud

Sebelum menggunakan Google Cloud CLI untuk menentukan urutan startup, konfigurasi pemeriksaan kondisi startup.

  1. In the Google Cloud console, activate Cloud Shell.

    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.

  2. Untuk men-deploy beberapa container ke layanan dengan urutan startup yang ditentukan, jalankan perintah:

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 WORKER_POOL dengan nama worker pool yang menjadi tujuan deployment. Jika Anda menghilangkan parameter ini, Anda akan diminta untuk memasukkan nama kumpulan pekerja nanti.
  • Ganti IMAGE_URL dengan referensi ke image container yang berisi kumpulan pekerja, seperti us-docker.pkg.dev/cloudrun/container/worker-pool:latest.

  • Ganti SIDECAR_IMAGE dengan referensi ke image container file bantuan

    Jika Anda ingin mengonfigurasi setiap container dalam perintah deployment, berikan konfigurasi setiap container setelah parameter container.

Melihat konfigurasi container untuk kumpulan pekerja

  1. Di konsol Google Cloud , buka Cloud Run:

    Buka Cloud Run

  2. Klik Worker pools untuk menampilkan daftar worker pool yang di-deploy.

  3. Klik kumpulan pekerja yang ingin Anda periksa untuk menampilkan panel detailnya.

  4. Klik tab Containers untuk menampilkan konfigurasi container kumpulan pekerja.