Pemisahan dan rollback instance untuk kumpulan pekerja Cloud Run

Kumpulan worker menangani workload non-permintaan. Untuk kasus penggunaan yang perlu membagi pekerjaan antara beberapa revisi, seperti men-deploy revisi baru, kumpulan worker menggunakan pembagian instance.

Cloud Run memungkinkan Anda menentukan revisi mana yang menerima instance dan menentukan persentase alokasi instance untuk setiap revisi. Fitur ini memungkinkan Anda melakukan rollback ke revisi sebelumnya, membagi instance antara beberapa revisi, dan mengalokasikan instance ke revisi terbaru. Halaman ini menjelaskan cara menggunakan fitur ini untuk mengelola alokasi instance ke revisi Cloud Run Anda.

Penyesuaian alokasi instance tidak instan. Saat Anda mengubah alokasi instance untuk revisi, semua permintaan yang sedang diproses akan terus diselesaikan. Permintaan yang sedang berlangsung tidak akan dihapus, dan Cloud Run mungkin mengarahkan permintaan ini ke revisi baru atau revisi sebelumnya selama periode transisi.

Siklus proses pembagian instance

Jika Anda membagi instance antara beberapa revisi atau menetapkan instance ke revisi sebelumnya, semua deployment berikutnya akan menggunakan pola pembagian instance tersebut. Untuk kembali menggunakan revisi terbaru tanpa instance pembagian, kirim semua instance ke revisi terbaru revisi.

Peran yang diperlukan

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

Roll back ke revisi sebelumnya

Untuk melakukan rollback ke revisi sebelumnya, gunakan Google Cloud konsol, atau Google Cloud CLI:

Konsol

  1. Di Google Cloud konsol, buka kumpulan worker Cloud Run:

    Buka Cloud Run

  2. Temukan kumpulan worker dalam daftar, lalu klik.

  3. Klik tab Revisi untuk menampilkan daftar revisi saat ini untuk kumpulan worker tersebut.

  4. Klik Kelola pembagian instance untuk menampilkan formulir kelola instance. Cloud Run mencantumkan revisi penayangan terbaru. Dalam formulir, konfigurasi detail berikut:

    1. Tambahkan revisi dan gunakan daftar drop-down untuk memilih revisi sebelumnya.
    2. Tetapkan persentase instance revisi sebelumnya menjadi 100.
    3. Tetapkan persentase revisi penayangan terbaru menjadi 0.
    4. Klik Simpan.

gcloud

Tentukan revisi yang akan di-rollback dengan menjalankan perintah berikut perintah.

   gcloud run worker-pools update-instance-split WORKER_POOL --to-revisions=REVISION=100

Ganti kode berikut:

  • WORKER_POOL: nama kumpulan worker.
  • REVISION: nama revisi yang akan Anda roll back.

Membagi instance antara beberapa revisi

Untuk membagi instance antara dua revisi atau lebih, gunakan Google Cloud konsol, atau Google Cloud CLI:

Saat Anda membagi instance antara beberapa revisi, pastikan total persentase di semua revisi sama dengan 100%, dan jumlah instance manual harus lebih besar daripada jumlah pembagian instance yang menayangkan workload.

Konsol

  1. Di Google Cloud konsol, buka kumpulan worker Cloud Run:

    Buka Cloud Run

  2. Temukan kumpulan worker dalam daftar, lalu klik.

  3. Klik tab Revisi untuk menampilkan daftar revisi saat ini untuk kumpulan worker tersebut.

  4. Klik Kelola pembagian instance untuk menampilkan formulir kelola instance. Cloud Run mencantumkan revisi penayangan terbaru. Dalam formulir, konfigurasi detail berikut:

    1. Tetapkan persentase revisi penayangan terbaru ke pembagian yang diperlukan, misalnya, kurangi dari 100%.

    2. Klik Tambahkan revisi dan gunakan daftar drop-down untuk memilih revisi sebelumnya dan menetapkan pembagian persentase yang sesuai.

    3. Untuk membagi instance dengan revisi tambahan, klik Tambahkan Revisi, dan pilih revisi lain, dan tetapkan persentasenya.

    4. Klik Simpan.

gcloud

Tentukan revisi dan persentase instance dengan menjalankan perintah berikut perintah. Alokasikan instance untuk setiap revisi dalam daftar yang dipisahkan koma:

   gcloud run worker-pools update-instance-split WORKER_POOL --to-revisions=LIST

Ganti kode berikut:

  • WORKER_POOL: nama kumpulan worker.

  • LIST: daftar revisi dan persentase yang dipisahkan koma:

    REVISION1=PERCENTAGE1,REVISION2=PERCENTAGE2,REVISIONn=PERCENTAGEx.

    Misalnya, my-worker-pool-s5sxn=10,my-worker-pool-cp9kw=90.

Mengalokasikan instance ke revisi terbaru

Saat men-deploy revisi baru, Anda dapat mengalokasikan 100% instance ke revisi ini dan semua revisi mendatang, dengan mengganti pembagian instance yang telah ditetapkan. Untuk mengalokasikan 100% instance ke revisi terbaru, jalankan perintah berikut:

  • Gunakan flag --to-latest untuk mengarahkan 100% instance ke revisi terbaru dan mengalokasikan semua instance secara otomatis ke revisi baru yang Anda deploy:

    gcloud run worker-pools update-instance-split WORKER_POOL --to-latest

  • Secara opsional, gunakan flag --to-revisions dengan kata kunci LATEST untuk selalu mengalokasikan persentase instance yang mengambang ke revisi terbaru saat Anda men-deploy revisi. Untuk menetapkan persentase instance yang selalu mengambang ke revisi terbaru, jalankan perintah berikut:

    gcloud run worker-pools update-instance-split WORKER_POOL --to-revisions=LATEST=PERCENTAGE

    Ganti kode berikut:

    • WORKER_POOL: nama kumpulan worker.
    • PERCENTAGE: persentase instance yang akan dialokasikan untuk revisi terbaru dan revisi terbaru mendatang.

Langkah berikutnya