Cloud Run memungkinkan Anda melihat detail, menonaktifkan kumpulan pekerja aktif, atau menghapus kumpulan pekerja yang tidak diperlukan. Anda dapat memeriksa konfigurasi yang di-deploy, menghentikan instance yang berjalan, dan menghapus resource yang tidak digunakan.
Peran yang diperlukan
Untuk mendapatkan izin yang
diperlukan untuk mengelola worker pool dan revisi worker pool Cloud Run,
minta administrator untuk memberi Anda
peran IAM Cloud Run Developer (roles/run.developer) di worker pool Cloud Run Anda.
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.
Membuat kumpulan pekerja
Cloud Run membuat kumpulan pekerja baru saat Anda men-deploy image container untuk pertama kalinya. Lihat Men-deploy worker pool baru untuk mengetahui petunjuk selengkapnya.
Melihat daftar worker pool di project Anda
Gunakan konsol Google Cloud atau Google Cloud CLI untuk melihat daftar worker pool yang tersedia di project Anda:
console
Di konsol Google Cloud , buka Cloud Run:
Pilih Worker pools dari menu. Kumpulan pekerja yang tersedia akan dicantumkan di halaman.
gcloud
Untuk mencantumkan kumpulan pekerja di project Anda, jalankan perintah berikut:
gcloud run worker-pools list
Anda dapat memfilter daftar ini berdasarkan properti definisi worker pool, seperti label yang ditetapkan.
Library klien
Untuk melihat daftar kumpulan pekerja dari kode:
REST API
Untuk melihat daftar kumpulan pekerja di project Anda, kirim permintaan HTTP GET ke
endpoint workerPool Cloud Run Admin API.
Misalnya, menggunakan curl:
curl -H "Authorization: Bearer ACCESS_TOKEN" \ -X GET \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools
Ganti kode berikut:
- ACCESS_TOKEN: token akses yang valid untuk akun yang memiliki izin IAM untuk melihat kumpulan pekerja.
Misalnya, jika login ke gcloud, Anda dapat mengambil token akses menggunakan
gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container. - PROJECT_ID: Google Cloud Project ID
- REGION: Google Cloud region kumpulan pekerja.
Melihat detail selengkapnya tentang worker pool
Gunakan konsol Google Cloud , Google Cloud CLI, atau YAML untuk melihat detail selengkapnya tentang worker pool:
console
Di konsol Google Cloud , buka Cloud Run:
Pilih Worker pools dari menu untuk menampilkan worker pool yang tersedia.
Klik worker pool untuk menampilkan panel detailnya.
gcloud
Untuk melihat detail tentang worker pool:
gcloud run worker-pools describe WORKER_POOL
Anda dapat menggunakan tanda --format untuk memformat
output. Misalnya, untuk memformat output sebagai YAML:
gcloud run worker-pools describe WORKER_POOL --region REGION --format yaml
Ganti:
- WORKER_POOL dengan nama worker pool.
- REGION dengan Google Cloud region kumpulan worker.
YAML
Untuk melihat detail tentang kumpulan pekerja, download konfigurasi YAML-nya:
gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
Library klien
Untuk melihat detail tentang kumpulan pekerja dari kode:
REST API
Untuk melihat detail tentang worker pool, kirim permintaan HTTP GET ke
endpoint workerPool Cloud Run Admin API.
Misalnya, menggunakan curl:
curl -H "Authorization: Bearer ACCESS_TOKEN" \ -X GET \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL
Ganti kode berikut:
- ACCESS_TOKEN: token akses yang valid untuk akun yang memiliki izin IAM untuk melihat detail worker pool.
Misalnya, jika login ke gcloud, Anda dapat mengambil token akses menggunakan
gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container. - PROJECT_ID: Google Cloud Project ID
- REGION: Google Cloud region worker pool.
- WORKER_POOL: nama worker pool.
Menonaktifkan worker pool yang ada
Menonaktifkan worker pool akan menonaktifkan semua instance untuk worker pool tersebut. Untuk menonaktifkan worker pool, tetapkan penskalaan ke nol:
console
Di konsol Google Cloud , buka Cloud Run:
Pilih Worker pools dari menu, lalu dari daftar worker pool, klik worker pool yang ingin Anda nonaktifkan.
Klik ikon pena di sebelah kanan Penskalaan: Manual (Instance: ) dan ubah nilainya menjadi 0.
Klik Save untuk mengupdate dan menonaktifkan worker pool.
gcloud
gcloud run worker-pools update WORKER_POOL --instances=0
Ganti WORKER_POOL dengan nama worker pool Anda.
YAML
Jika Anda membuat kumpulan pekerja 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 skala ke nilai
0untuk menonaktifkan worker pool. Contoh berikut berisi konfigurasi YAML:apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL annotations: run.googleapis.com/scalingMode: manual run.googleapis.com/manualInstanceCount: `0`
Ganti kode berikut:
- WORKER_POOL: nama kumpulan pekerja Cloud Run Anda.
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.
Library klien
Untuk menonaktifkan worker pool dari kode:
REST API
Untuk menonaktifkan kumpulan pekerja, kirim permintaan HTTP PATCH ke
endpoint workerPool Cloud Run Admin API.
Misalnya, menggunakan curl:
curl -H "Authorization: Bearer ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -X PATCH \ -d '{"scaling":{"manualInstanceCount":0}}' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL?update_mask=scaling.manualInstanceCount
Ganti kode berikut:
- ACCESS_TOKEN: token akses yang valid untuk akun yang memiliki izin IAM untuk menonaktifkan worker pool.
Misalnya, jika login ke gcloud, Anda dapat mengambil token akses menggunakan
gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container. - PROJECT_ID: Google Cloud Project ID
- REGION: Google Cloud region worker pool.
- WORKER_POOL: nama pool pekerja Anda.
Menghapus kumpulan pekerja yang ada
Pertimbangan berikut berlaku untuk penghapusan worker pool:
- Menghapus worker pool akan menghapus semua resource yang terkait dengan worker pool ini, termasuk semua revisi worker pool ini, terlepas dari apakah worker pool tersebut memproses workload atau tidak.
- Menghapus worker pool tidak akan otomatis menghapus image container dari Artifact Registry. Untuk menghapus image container yang digunakan oleh revisi yang telah dihapus dari Artifact Registry, lihat Menghapus image.
- Setelah Anda menghapus worker pool, worker pool akan tetap terlihat di Google Cloud CLI hingga penghapusan selesai sepenuhnya. Namun, Anda tidak dapat mengupdate worker pool.
Penghapusan kumpulan pekerja bersifat permanen. Tidak ada urungkan atau pulihkan.
console
Di konsol Google Cloud , buka Cloud Run:
Pilih Worker pools dari menu, lalu dari daftar worker pool, pilih worker pool yang ingin Anda hapus.
Klik Hapus.
gcloud
Untuk menghapus worker pool, gunakan perintah:
gcloud run worker-pools delete WORKER_POOL --region REGION
Ganti:
- WORKER_POOL dengan nama kumpulan worker Anda.
- REGION dengan region Google Cloud worker pool.
Library klien
Untuk menghapus kumpulan pekerja dari kode:
REST API
Untuk menghapus worker pool, kirim permintaan HTTP DELETE ke
endpoint workerPool Cloud Run Admin API.
Misalnya, menggunakan curl:
curl -H "Authorization: Bearer ACCESS_TOKEN" \ -X DELETE \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL
Ganti kode berikut:
- ACCESS_TOKEN: token akses yang valid untuk akun yang memiliki izin IAM untuk menghapus kumpulan pekerja.
Misalnya, jika login ke gcloud, Anda dapat mengambil token akses menggunakan
gcloud auth print-access-token. Dari dalam instance container Cloud Run, Anda dapat mengambil token akses menggunakan server metadata instance container. - PROJECT_ID: Google Cloud Project ID
- REGION: Google Cloud region worker pool.
- WORKER_POOL: nama worker pool Anda.