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 Cloud Run dan revisi kumpulan pekerja, 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 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.

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 Google Cloud konsol atau Google Cloud CLI untuk melihat daftar kumpulan pekerja yang tersedia di project Anda:

console

  1. Di Google Cloud konsol, buka Cloud Run:

    Buka Cloud Run

  2. Pilih Worker pools dari menu. Kumpulan pekerja yang tersedia akan tercantum 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 kumpulan pekerja, 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: Project ID Google Cloud
  • REGION: region kumpulan pekerja Google Cloud

Melihat detail selengkapnya tentang kumpulan pekerja

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

console

  1. Di Google Cloud konsol, buka Cloud Run:

    Buka Cloud Run

  2. Pilih Worker pools dari menu untuk menampilkan kumpulan pekerja 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 pekerja.

Anda dapat menggunakan tanda --format flag 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 > worker-pool.yaml

Library klien

Untuk melihat detail tentang kumpulan pekerja dari kode:

REST API

Untuk melihat detail tentang kumpulan pekerja, kirim permintaan HTTP GET ke workerPool endpoint 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 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: Project ID Google Cloud
  • REGION: region kumpulan pekerja. Google Cloud
  • WORKER_POOL: nama kumpulan pekerja.

Menonaktifkan kumpulan pekerja yang ada

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

console

  1. Di Google Cloud konsol, buka Cloud Run:

    Buka Cloud Run

  2. Pilih Worker pools dari menu, lalu dari daftar kumpulan pekerja, klik kumpulan pekerja yang ingin Anda nonaktifkan.

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

  4. Klik Save untuk mengupdate dan menonaktifkan kumpulan pekerja.

gcloud 

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

Ganti WORKER_POOL dengan nama kumpulan pekerja Anda.

YAML

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

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

  2. Tetapkan skala ke nilai 0 untuk menonaktifkan kumpulan pekerja. 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 worker-pool.yaml

    Perintah gcloud run worker-pools replace secara default menggunakan file worker-pool.yaml jika ada.

Library klien

Untuk menonaktifkan kumpulan pekerja 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 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: Project ID Google Cloud
  • REGION: region kumpulan pekerja. Google Cloud
  • WORKER_POOL: nama kumpulan pekerja Anda.

Menghapus kumpulan pekerja yang ada

Pertimbangan berikut berlaku untuk penghapusan kumpulan pekerja:

  • 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 tersebut akan tetap terlihat di Google Cloud CLI hingga penghapusan selesai sepenuhnya. Namun, Anda tidak dapat mengupdate kumpulan pekerja tersebut.

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

console

  1. Di Google Cloud konsol, buka Cloud Run:

    Buka Cloud Run

  2. Pilih Worker pools dari menu, lalu dari daftar kumpulan pekerja, pilih kumpulan pekerja yang ingin Anda hapus.

  3. Klik Delete.

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.

Library klien

Untuk menghapus kumpulan pekerja dari kode:

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: Project ID Google Cloud
  • REGION: region kumpulan pekerja. Google Cloud
  • WORKER_POOL: nama kumpulan pekerja Anda.