Pemisahan dan rollback instance untuk kumpulan pekerja Cloud Run

Worker Pool menangani workload non-permintaan. Untuk kasus penggunaan yang perlu membagi pekerjaan di antara beberapa revisi, seperti men-deploy revisi baru, kumpulan pekerja menggunakan pemisahan instance.

Dengan Cloud Run, Anda dapat menentukan revisi mana yang menerima instance dan menentukan persentase alokasi instance untuk setiap revisi. Dengan fitur ini, Anda dapat 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 dapat terjadi secara instan. Jika Anda mengubah alokasi instance untuk revisi, semua permintaan yang sedang diproses akan tetap berlanjut hingga selesai. Permintaan yang sedang berlangsung tidak akan dihapus, dan Cloud Run dapat mengarahkan permintaan ini ke revisi baru atau revisi sebelumnya selama periode transisi.

Siklus proses pemisahan instance

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

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 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 roll back ke revisi sebelumnya, gunakan konsol Google Cloud , atau Google Cloud CLI:

Konsol

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

    Buka Cloud Run

  2. Temukan kumpulan pekerja dalam daftar, lalu klik.

  3. Klik tab Revisi untuk menampilkan daftar revisi terbaru untuk kumpulan pekerja tersebut.

  4. Klik Kelola pemisahan 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. Setel persentase instance revisi sebelumnya menjadi 100.
    3. Setel persentase revisi penayangan terbaru menjadi 0.
    4. Klik Simpan.

gcloud

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

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

Ganti kode berikut:

  • WORKER_POOL: nama pool pekerja.
  • REVISION: nama revisi yang sedang Anda roll back.

Membagi instance di antara beberapa revisi

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

Saat Anda membagi instance di antara beberapa revisi, pastikan total persentase di semua revisi sama dengan 100%, dan jumlah instance manual harus lebih besar daripada jumlah pemisahan instance yang melayani beban kerja.

Konsol

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

    Buka Cloud Run

  2. Temukan kumpulan pekerja dalam daftar, lalu klik.

  3. Klik tab Revisi untuk menampilkan daftar revisi terbaru untuk kumpulan pekerja tersebut.

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

    1. Setel persentase revisi yang ditampilkan terbaru ke bagian 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, lalu pilih revisi lain, dan tetapkan persentasenya.

    4. Klik Simpan.

gcloud

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

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

Ganti kode berikut:

  • WORKER_POOL: nama pool pekerja.

  • 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 di masa mendatang, sehingga menggantikan 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 beta 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 berubah-ubah ke revisi terbaru saat Anda men-deploynya. Untuk menetapkan persentase instance yang selalu di-float ke revisi terbaru, jalankan perintah berikut:

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

    Ganti kode berikut:

    • WORKER_POOL: nama pool pekerja.
    • PERCENTAGE: persentase instance yang akan dialokasikan untuk revisi terbaru dan revisi terbaru di masa mendatang.

Langkah berikutnya