Halaman ini menjelaskan cara mengonfigurasi port container, perintah entrypoint, dan argumen untuk layanan 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.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan 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
) 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 layanan 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 port container
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.
Untuk layanan Cloud Run, Cloud Run memasukkan variabel lingkungan PORT
ke dalam container. Jika Anda men-deploy beberapa container ke suatu layanan, ini adalah container masuk. Penampung memproses port yang ditentukan oleh variabel lingkungan PORT
, bukan di port hardcode tertentu. Jika hal ini tidak memungkinkan, konfigurasi pemrosesan agar terjadi di port yang mengirimkan permintaan ke container. Perhatikan bahwa setelan port tidak berlaku untuk tugas Cloud Run.
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.
- Tentukan port tujuan pengiriman permintaan yang Anda inginkan,
jika bukan nilai default
8080
. Tindakan ini juga menetapkan variabel lingkunganPORT
.
- Tentukan port tujuan pengiriman permintaan yang Anda inginkan,
jika bukan nilai default
Klik Buat atau Deploy.
gcloud
Anda dapat memperbarui konfigurasi port layanan menggunakan perintah berikut:
gcloud run services update SERVICE --port PORT
Ganti
- SERVICE dengan nama layanan.
- PORT dengan port untuk mengirim permintaan. Perhatikan bahwa
port defaultnya adalah
8080
.
Anda juga dapat mengonfigurasi port selama deployment menggunakan perintah:
gcloud run deploy --image IMAGE_URL --port PORT
Ganti IMAGE_URL dengan referensi ke image container,
contohnya, us-docker.pkg.dev/cloudrun/container/hello:latest
. Jika Anda menggunakan Artifact Registry,
repositori REPO_NAME harus
sudah dibuat. URL memiliki bentuk LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
.
YAML
Jika Anda membuat layanan baru, lewati langkah ini. Jika Anda mengupdate layanan yang sudah ada, download konfigurasi YAML:
gcloud run services describe SERVICE --format export > service.yaml
Perbarui
containerPort:
atribut:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: name: REVISION spec: containers: - image: IMAGE_URL ports: - containerPort: PORT
Ganti
- SERVICE dengan nama layanan Cloud Run Anda
- 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. URL berbentukLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
- PORT dengan port untuk mengirim permintaan
- REVISION dengan nama revisi baru atau hapus (jika ada). Jika Anda memberikan nama revisi baru, nama tersebut harus memenuhi kriteria berikut:
- Dimulai dengan
SERVICE-
- Hanya berisi huruf kecil, angka, dan
-
- Tidak diakhiri dengan
-
- Tidak melebihi 63 karakter
- Dimulai dengan
Ganti layanan dengan konfigurasinya yang baru menggunakan perintah berikut:
gcloud run services replace service.yaml
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 menggunakan Konsol Google Cloud, Google Cloud CLI, atau menggunakan 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.
- Tetapkan perintah yang Anda inginkan untuk dijalankan container, jika bukan perintah yang ditentukan dalam container, kemudian tentukan argumen untuk perintah entrypoint secara opsional.
Klik Buat atau Deploy.
gcloud
Untuk memperbarui perintah dan argumen awal untuk layanan yang ada:
gcloud run services update SERVICE --command COMMAND --args ARG1,ARG-N
Ganti
- 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 menetapkan entrypoint dan argumen selama deployment layanan baru atau yang sudah ada:
gcloud run deploy --image IMAGE_URL --command COMMAND --args ARG1,ARG-N
Ganti IMAGE_URL dengan referensi ke image container,
contohnya, us-docker.pkg.dev/cloudrun/container/hello:latest
. Jika Anda menggunakan Artifact Registry,
maka repositori REPO_NAME harus
sudah dibuat. URL berbentuk LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
Untuk menghapus perintah dan argumen entrypoint yang telah Anda tetapkan (pulihkan ke default container), sediakan string kosong seperti berikut:
gcloud run deploy --image IMAGE_URL --command "" --args ""
YAML
Jika Anda membuat layanan baru, lewati langkah ini. Jika Anda mengupdate layanan yang sudah ada, download konfigurasi YAML:
gcloud run services describe SERVICE --format export > service.yaml
Update atribut
command
danargs
:spec: containers: - image: IMAGE_URL command: - COMMAND args: - "ARG1" - "ARG-N"
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. URL berbentukLOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
- COMMAND dengan perintah yang digunakan untuk memulai container jika Anda tidak menggunakan perintah default.
- ARG1 dengan argumen yang Anda kirim ke perintah container. Jika Anda menggunakan beberapa argumen, tentukan setiap argumen di barisnya masing-masing, contohnya, seperti yang ditunjukkan, ARG-N.
- IMAGE_URL dengan referensi ke image container
misalnya,
Ganti layanan dengan konfigurasinya yang baru menggunakan perintah berikut:
gcloud run services replace service.yaml
Terraform
Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.
Resource google_cloud_run_v2_service
berikut menentukan
perintah dan argumen. Ganti /server
dengan perintah yang digunakan untuk memulai container Anda,
dan tambahkan argumen apa pun yang diperlukan ke array args
.
Menggunakan tanda sama dengan atau koma dalam argumen
Jika Anda menggunakan tanda sama dengan dalam argumen, sediakan tanda sama dengan menggunakan format berikut:
gcloud run deploy \
--args="--repo-allowlist=github.com/example/example_demo"
Jika argumen Anda menggunakan koma, lihat mengonfigurasi variabel lingkungan untuk mengetahui lebih lengkap mengenai cara meng-escape variabel tersebut.
Mengonfigurasi urutan awal container untuk deployment file bantuan
Untuk menentukan urutan pengaktifan container dalam deployment file bantuan, gunakan fitur dependensi container. Anda menentukan container yang memiliki dependensi dan mencantumkan container yang menjadi dependensinya: container tersebut dimulai terlebih dahulu. Penampung yang tidak memiliki dependensi selalu dimulai terlebih dahulu dan secara serentak.
Anda harus menggunakan pemeriksaan kondisi startup jika ingin berhasil menggunakan fitur ini. Pemeriksaan startup memungkinkan Cloud Run memeriksa kondisi container dependen, dan memastikannya berhasil melewatinya sebelum memulai container berikutnya. Jika Anda tidak menggunakan healthcheck, container akan dimulai dalam urutan yang ditentukan meskipun container yang menjadi dependensinya gagal dimulai.
Perlu diketahui bahwa container masuk memiliki pemeriksaan kondisi startup default.
Anda dapat menggunakan Konsol Google Cloud, Google Cloud CLI, atau YAML untuk menentukan urutan startup:
Konsol
-
- Untuk layanan yang sudah ada, klik layanan dalam daftar, lalu pilih Edit and deploy new revision untuk menampilkan formulir deployment revisi.
- Untuk layanan baru, klik Create service.
Untuk layanan baru, tentukan nama layanan, URL container masuk, alokasi CPU, kontrol masuk, dan autentikasi, lalu klik Container(s), volume, networking, security.
Untuk layanan baru, di tab Container, volume, networking, security, lakukan tindakan berikut:
- Konfigurasi penampung masuk.
- Untuk menambahkan setiap penampung lain yang sedang Anda deploy, klik Tambahkan penampung.
- Untuk semua container kecuali container masuk, konfigurasikan health check startup. Penampung ingress memiliki health check startup default.
- Jika penampung memerlukan penampung lain untuk dimulai terlebih dahulu sebelum dapat dimulai, gunakan menu Pesanan startup container untuk memilih penampung yang harus dimulai terlebih dahulu.
Untuk layanan yang sudah ada, ikuti langkah-langkah berikut:
- Untuk semua container kecuali container masuk, konfigurasikan health check startup. Penampung ingress memiliki health check startup default.
- Setiap penampung ditampilkan dengan menu Pesanan startup container-nya sendiri. Jika penampung memerlukan container lain untuk dimulai terlebih dahulu sebelum dapat dimulai, gunakan menu Pesanan startup container untuk memilih container yang harus dimulai terlebih dahulu.
Selesaikan konfigurasi lain yang diperlukan, lalu klik Create untuk layanan baru atau Deploy untuk layanan yang ada. Tunggu hingga deployment selesai.
gcloud
Parameter container
di Google Cloud CLI sedang dalam Pratinjau.
Sebelum menggunakan Google Cloud CLI untuk menentukan urutan startup, Anda harus mengonfigurasi health check startup untuk semua container kecuali container masuk. Container ingress memiliki health check startup default. Anda tidak dapat mengonfigurasi health check menggunakan Google Cloud CLI.
-
Di konsol Google Cloud, aktifkan Cloud Shell.
Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.
Untuk men-deploy beberapa container ke layanan dengan urutan startup yang ditentukan, jalankan perintah:
gcloud run deploy SERVICE \ --container CONTAINER_1_NAME --image='INGRESS_IMAGE' \ --container CONTAINER_2_NAME --image='SIDECAR_IMAGE' --depends-on=CONTAINER_1_NAME \ --container CONTAINER_3_NAME --image='SIDECAR_IMAGE' --depends-on=CONTAINER_1_NAMECONTAINER_2_NAME
- Ganti SERVICE dengan nama layanan tempat Anda men-deploy. Anda dapat menghilangkan parameter ini sepenuhnya, tetapi Anda akan diminta untuk memasukkan nama layanan jika menghilangkannya.
- Ganti INGRESS_IMAGE dengan referensi ke image container yang akan menerima permintaan, misalnya,
us-docker.pkg.dev/cloudrun/container/hello:latest
. Mengganti SIDECAR_IMAGE dengan referensi ke image penampung file bantuan
Jika ingin mengonfigurasi setiap container di perintah deploy, sediakan setiap konfigurasi container setelah parameter
container
.
YAML
Jika Anda membuat layanan baru, lewati langkah ini. Jika Anda mengupdate layanan yang sudah ada, download konfigurasi YAML:
gcloud run services describe SERVICE --format export > service.yaml
Perbarui
container-dependencies
atribut:apiVersion: serving.knative.dev/v1 kind: Service metadata: annotations: name: SERVICE spec: template: metadata: annotations: run.googleapis.com/container-dependencies: '{"CONTAINER1":["CONTAINER2"], "CONTAINER3":["CONTAINER1","CONTAINER2"]}'
Ganti
- CONTAINER1 dengan nama container pertama yang bergantung pada satu container atau lebih. Perhatikan bahwa Anda dapat menetapkan nama container dalam YAML: Cloud Run akan secara otomatis membuat nama jika nama tidak ditentukan.
- CONTAINER2 dengan nama container yang harus dimulai sebelum CONTAINER1.
- CONTAINER3 dengan nama container kedua yang bergantung pada satu container atau lebih.
Dalam contoh yang ditampilkan dalam cuplikan YAML, CONTAINER2 dimulai terlebih dahulu, CONTAINER1 dimulai kedua, dan CONTAINER3 dimulai terakhir.
Ganti layanan dengan konfigurasinya yang baru menggunakan perintah berikut:
gcloud run services replace service.yaml
Menampilkan setelan penampung
Agar dapat melihat setelan container 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.
Pada panel detail di sebelah kanan, setelan container tercantum di bagian tab Container.
gcloud
Gunakan perintah berikut:
gcloud run services describe SERVICE
Temukan setelan container dalam konfigurasi yang ditampilkan.