Mengelola kumpulan pekerja

Halaman ini menjelaskan cara melihat informasi tentang kumpulan pekerja, dan menghapus kumpulan pekerja.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengelola kumpulan pekerja dan revisi kumpulan pekerja Cloud Run, minta administrator untuk memberi Anda peran IAM Cloud Run Developer (roles/run.developer) di kumpulan pekerja 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 kumpulan pekerja baru untuk mengetahui petunjuk selengkapnya.

Melihat daftar kumpulan pekerja di project Anda

Gunakan konsol Google Cloud atau Google Cloud CLI untuk melihat daftar worker pool yang tersedia di project Anda:

console

  1. Di konsol Google Cloud , buka Cloud Run:

    Buka Cloud Run

  2. Pilih Worker pool 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.

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 kumpulan pekerja

Gunakan konsol Google Cloud , Google Cloud CLI, atau YAML untuk melihat detail selengkapnya tentang kumpulan pekerja:

console

  1. Di konsol Google Cloud , buka Cloud Run:

    Buka Cloud Run

  2. Pilih Worker pool dari menu untuk menampilkan worker pool yang tersedia.

  3. Klik kumpulan pekerja untuk menampilkan panel detailnya.

gcloud

Untuk melihat detail tentang kumpulan pekerja: 

gcloud run worker-pools describe WORKER_POOL
 Ganti WORKER_POOL dengan nama kumpulan worker.

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 kumpulan pekerja.
  • REGION dengan Google Cloud region kumpulan pekerja.

YAML

Untuk melihat detail tentang kumpulan pekerja, download konfigurasi YAML-nya:

gcloud run worker-pools describe WORKER_POOL --format export > workerpool.yaml

REST API

Untuk melihat detail tentang kumpulan pekerja, 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 pool pekerja.

Menonaktifkan kumpulan pekerja yang ada

Menonaktifkan kumpulan pekerja akan menghentikan semua instance untuk kumpulan pekerja tersebut. Untuk menonaktifkan kumpulan pekerja, setel penskalaan ke nol:

console

  1. Di konsol Google Cloud , buka Cloud Run:

    Buka Cloud Run

  2. Pilih Worker pools dari menu, lalu dari daftar worker pool, klik worker pool yang ingin Anda nonaktifkan.

  3. Klik ikon pena di sebelah kanan Penskalaan: Manual (Instance: ) dan ubah nilainya menjadi 0.

  4. Klik Simpan untuk memperbarui dan menonaktifkan kumpulan pekerja.

gcloud 

gcloud run worker-pools update WORKER_POOL --instances=0

Ganti WORKER_POOL dengan nama kumpulan worker Anda.

YAML

  1. Jika Anda membuat kumpulan pekerja baru, lewati langkah ini. Jika Anda memperbarui kumpulan pekerja yang ada, download konfigurasi YAML-nya:

    gcloud run worker-pools describe WORKER_POOL --format export > workerpool.yaml

  2. Tetapkan skala ke nilai 0 untuk 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.

  3. Buat atau update kumpulan pekerja menggunakan perintah berikut:

    gcloud run worker-pools replace workerpool.yaml

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 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 pool pekerja Anda.

Menghapus kumpulan pekerja yang ada

Pertimbangan berikut berlaku untuk penghapusan kumpulan worker:

  • Menghapus kumpulan pekerja akan menghapus semua resource yang terkait dengan kumpulan pekerja ini, termasuk semua revisi kumpulan pekerja ini, terlepas dari apakah kumpulan pekerja tersebut memproses workload atau tidak.
  • Menghapus kumpulan pekerja tidak secara 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 kumpulan pekerja, kumpulan pekerja tetap terlihat di Google Cloud CLI hingga penghapusan selesai sepenuhnya. Namun, Anda tidak dapat mengupdate kumpulan pekerja.

  • Penghapusan kumpulan pekerja bersifat permanen. Tidak ada urungkan atau pulihkan.

console

  1. Di konsol Google Cloud , buka Cloud Run:

    Buka Cloud Run

  2. Pilih Worker pools dari menu, lalu dari daftar worker pool, pilih worker pool yang ingin Anda hapus.

  3. Klik Hapus.

gcloud

Untuk menghapus kumpulan pekerja, gunakan perintah:

gcloud run worker-pools delete WORKER_POOL --region REGION

Ganti:

  • WORKER_POOL dengan nama kumpulan pekerja Anda.
  • REGION dengan Google Cloud region kumpulan pekerja.

REST API

Untuk menghapus kumpulan pekerja, 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 pool pekerja Anda.