Penskalaan manual memungkinkan Anda menetapkan jumlah instance tertentu tanpa perlu melakukan deployment ulang. Gunakan penskalaan manual saat workload Anda memerlukan jumlah instance tetap, atau saat Anda ingin mengontrol jumlah instance dari sistem Anda sendiri.
Untuk menskalakan instance secara otomatis berdasarkan pemakaian CPU, alih-alih menetapkan jumlah instance tetap, lihat Mengonfigurasi penskalaan otomatis CPU untuk worker pool.
Pertimbangan penagihan saat menggunakan penskalaan manual
Saat Anda menggunakan penskalaan manual, semua instance yang Anda minta akan ditagih sebagai instance aktif, meskipun instance tersebut tidak aktif. Untuk mengetahui detail penagihan lengkap, lihat halaman harga.
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk mengonfigurasi dan men-deploy worker pool Cloud Run, minta administrator untuk memberi Anda peran IAM berikut:
- Cloud Run Developer (
roles/run.developer) di worker pool Cloud Run - Pengguna Akun Layanan (
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 worker Cloud Run Anda berinteraksi dengan APIGoogle Cloud , seperti Library Klien Cloud, lihat panduan konfigurasi identitas layanan. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat izin deployment dan mengelola akses.
Mengonfigurasi penskalaan
Mengubah mode penskalaan atau mengubah jumlah instance manual tidak akan membuat revisi baru.
Untuk mengonfigurasi mode penskalaan, gunakan konsol Google Cloud , Google Cloud CLI, YAML, Terraform, atau REST API:
Konsol
Di konsol Google Cloud , buka Cloud Run:
Jika Anda mengonfigurasi worker pool baru, pilih Worker pools dari menu, lalu klik Deploy container. Jika Anda mengonfigurasi worker pool yang ada, klik worker pool untuk menampilkan panel detailnya, lalu klik ikon pena di samping Scaling di kanan atas panel detail.
Temukan formulir Scaling (untuk worker pool baru) atau formulir Edit scaling untuk worker pool yang ada.
Di kolom berlabel Jumlah instance, tentukan jumlah instance container untuk worker pool.
Selesaikan spesifikasi.
Klik Create untuk worker pool baru atau Save untuk worker pool yang sudah ada.
gcloud
- Untuk menentukan penskalaan manual bagi worker pool baru, jalankan perintah berikut dengan flag
--scaling:
gcloud beta run worker-pools deploy WORKER_POOL \ --scaling=INSTANCE_COUNT \ --image IMAGE_URL
Ganti kode berikut:
- WORKER_POOL: nama worker pool Anda.
- INSTANCE_COUNT: jumlah instance untuk worker pool.
Tindakan ini akan menetapkan worker pool ke penskalaan manual. Tentukan nilai
0untuk menonaktifkan worker pool. IMAGE_URL: referensi ke image container yang berisi worker pool, sepertius-docker.pkg.dev/cloudrun/container/worker-pool:latest.Untuk menentukan penskalaan manual bagi worker pool yang ada, jalankan perintah berikut dengan flag
--scaling:
gcloud beta run worker-pools update WORKER_POOL \ --scaling=INSTANCE_COUNT
Ganti kode berikut:
- WORKER_POOL: nama worker pool Anda.
- INSTANCE_COUNT: jumlah instance untuk worker pool.
YAML
Jika Anda membuat worker pool baru, lewati langkah ini. Jika Anda mengupdate worker pool yang ada, download konfigurasi YAML-nya:
gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
Tetapkan
scalingModekemanualdan tentukanmanualInstanceCount:apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL annotations: run.googleapis.com/scalingMode: manual run.googleapis.com/manualInstanceCount: "INSTANCE_COUNT"
Ganti kode berikut:
- WORKER_POOL: nama worker pool Cloud Run Anda.
- INSTANCE_COUNT: jumlah instance yang Anda skalakan secara manual untuk worker pool. Tentukan nilai
0untuk menonaktifkan worker pool.
Buat atau update worker pool menggunakan perintah berikut:
gcloud run worker-pools replace worker-pool.yaml
Perintah
gcloud run worker-pools replacesecara default menggunakan fileworker-pool.yamljika ada.
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"
template {
containers {
image = "IMAGE_URL"
}
}
scaling {
scaling_mode = "MANUAL"
manual_instance_count = "INSTANCE_COUNT"
}
}
Ganti kode berikut:
- WORKER_POOL: nama worker pool.
- REGION: region Google Cloud —misalnya,
europe-west1. IMAGE_URL: referensi ke image container yang berisi worker pool, sepertius-docker.pkg.dev/cloudrun/container/worker-pool:latest.- INSTANCE_COUNT: jumlah instance untuk worker pool.
Tindakan ini akan menetapkan worker pool ke penskalaan manual. Tentukan nilai
0untuk menonaktifkan worker pool.
REST API
Untuk memperbarui jumlah instance untuk worker pool tertentu, kirim permintaan HTTP PATCH ke endpoint workerPools.patch Cloud Run Admin API:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X PATCH \ -d '{"scaling":{"scalingMode":"MANUAL","manualInstanceCount":INSTANCE_COUNT}}' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL?update_mask=scaling.scalingMode,scaling.manualInstanceCount
Ganti kode berikut:
- ACCESS_TOKEN: token akses yang valid untuk akun yang memiliki izin IAM untuk mengupdate worker pool.
Misalnya, jika login ke
gcloud, Anda dapat mengambil token akses menggunakangcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container. - INSTANCE_COUNT: jumlah instance untuk worker pool.
- PROJECT_ID: Google Cloud Project ID
- REGION: region Google Cloud tempat worker pool di-deploy.
- WORKER_POOL: nama worker pool.
Melihat konfigurasi penskalaan untuk worker pool
Di konsol Google Cloud , buka Cloud Run:
Klik Worker pools untuk menampilkan daftar worker pool yang di-deploy.
Klik worker pool yang ingin Anda periksa untuk menampilkan panel detailnya.
Setelan penskalaan saat ini ditampilkan di atas daftar revisi worker pool: Scaling: Manual (Instances: ).
Menonaktifkan worker pool
Untuk menonaktifkan worker pool, jalankan perintah berikut dengan flag --scaling=0:
gcloud beta run worker-pools update WORKER_POOL --scaling=0
Ganti WORKER_POOL dengan nama worker pool Anda.