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 kumpulan pekerja Cloud Run menggunakan Google Cloud konsol, Google Cloud CLI, atau Terraform:

Konsol

  1. Di konsol Google Cloud , buka Cloud Run:

    Buka Cloud Run

  2. 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.

  3. Jika Anda mengonfigurasi kumpulan pekerja baru, isi halaman kumpulan pekerja awal, lalu klik Container, Volume, Jaringan, Keamanan untuk meluaskan halaman konfigurasi kumpulan pekerja.

  4. Klik tab Container.

    gambar

    • 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.
  5. 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

  1. Di konsol Google Cloud , buka halaman Cloud Run:

    Buka 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.
  2. 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:

    1. Konfigurasi container ingress.
    2. Untuk menambahkan setiap penampung lain yang Anda deploy, klik Tambahkan penampung.
    3. Untuk semua container kecuali container ingress, konfigurasi health check saat startup.
    4. Jika container perlu dimulai setelah container lain tertentu, pilih container tersebut di menu Urutan pengaktifan container.
  3. Untuk kumpulan pekerja yang ada, ikuti langkah-langkah berikut:

    1. Untuk semua container kecuali container ingress, konfigurasi health check saat startup.
    2. 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.
  4. 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.

  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:

  3. 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:

    • 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.

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.