Mengatur afinitas sesi (layanan)

Halaman ini menunjukkan cara mengaktifkan afinitas sesi untuk revisi layanan Cloud Run Anda.

Secara default, afinitas sesi tidak diaktifkan, sehingga permintaan dari klien yang sama mungkin ditangani oleh instance yang berbeda, seperti yang ditunjukkan di sini: gambar

Jika Anda mengaktifkan afinitas sesi, Cloud Run akan merutekan permintaan berurutan untuk klien tertentu ke instance revisi yang sama. Cloud Run menggunakan cookie afinitas sesi dengan TTL selama 30 hari, dan memeriksa nilainya untuk mengidentifikasi beberapa permintaan oleh klien yang sama dan mengarahkan semua permintaan tersebut ke instance yang sama, seperti yang ditampilkan di sini: gambar

Tindakan utama yang harus diperhatikan

Seperti yang ditunjukkan pada diagram di atas, dengan afinitas sesi yang diaktifkan, klien akan menjangkau instance yang sama. Namun, perhatikan bahwa instance dapat menerima permintaan dari klien yang berbeda. Afinitas sesi tidak berarti bahwa instance dikhususkan untuk satu klien.

Karena tindakan penskalaan otomatis Cloud Run, afinitas sesi adalah afinitas dengan upaya terbaik. Jika instance dimulai ulang, dihentikan, kelebihan beban atau menjadi tidak tersedia sebagai hasil dari jumlah instance yang diskalakan, afinitas sesi akan rusak dan permintaan selanjutnya akan dirutekan ke instance yang berbeda.

Meskipun data sesi klien dapat di-cache dalam memori instance, Anda tidak dapat berasumsi bahwa klien akan selalu terhubung kembali ke instance yang sama, bahkan ketika afinitas sesi diaktifkan.

Jika Anda menggunakan Cloud Load Balancing, afinitas sesi layanan Cloud Run dapat dikaitkan dengan afinitas sesi Penyeimbang Beban Global dan Internal.

Pemisahan traffic dan afinitas sesi

Anda mengaktifkan atau menonaktifkan afinitas sesi di tingkat revisi. Jika Anda mengaktifkan afinitas sesi pada revisi Cloud Run dan juga menggunakan pemisahan traffic, afinitas sesi akan lebih diprioritaskan daripada pemisahan traffic. Dalam kasus yang ekstrem, jika satu klien yang menggunakan afinitas sesi bertanggung jawab atas sebagian besar semua permintaan, semua permintaan tersebut dapat dirutekan ke revisi tertentu, terlepas dari konfigurasi pemisahan traffic.

Jika Anda mengaktifkan pemisahan traffic untuk me-revisi disaat beberapa revisi mengaktifkan afinitas sesi dan beberapa tidak, hasilnya adalah permintaan secara bertahap digeser ke revisi yang mengaktifkan afinitas sesi, meskipun Anda tidak secara eksplisit mengubah konfigurasi pemisahan traffic. Alasannya adalah setiap permintaan yang tidak memiliki lampiran cookie afinitas sesi akan dialihkan pada pemisahan acak, yang pada akhirnya beberapa diantaranya akan ditetapkan ke revisi dengan afinitas sesi dan kemudian permintaan tersebut akan tetap dengan revisi tersebut.

Saat memperbarui konfigurasi pemisahan traffic untuk layanan Cloud Run, permintaan berikutnya dengan cookie afinitas sesi yang terpasang mungkin ditetapkan ke revisi yang berbeda. Cloud Run meminimalkan jumlah klien yang dialihkan ke revisi baru.

Misalnya, jika layanan membagi traffic sebesar 90%/10%, dan pembagian traffic diperbarui menjadi 80%/20%, maka 10% traffic akan dialihkan ke revisi yang saat ini melayani 20% traffic.

Mengatur afinitas sesi

Setiap perubahan konfigurasi akan menghasilkan revisi baru. Revisi selanjutnya juga akan otomatis mendapatkan setelan konfigurasi ini, kecuali jika Anda melakukan pembaruan eksplisit untuk mengubahnya.

Anda dapat menetapkan afinitas sesi menggunakan konsol Google Cloud, command line gcloud, atau file .yaml saat membuat layanan baru atau men-deploy revisi baru:

Konsol

Di konsol Google Cloud, buka Cloud Run:

Buka Cloud Run
Klik Buat Layanan jika Anda mengonfigurasi layanan baru yang akan di-deploy. Jika Anda mengonfigurasi layanan yang ada, klik layanan, lalu klik Edit and deploy new revision.
Jika Anda mengonfigurasi layanan baru, isi halaman setelan layanan awal sesuai keinginan, kemudian klik Container, vo;ume, jejaring, sekuritas untuk memperluas halaman konfigurasi layanan.
Klik tab Networking.
- Klik kotak teks Afinitas sesi.
Klik Buat atau Deploy.

Command line

Untuk menentukan afinitas sesi, gunakan perintah berikut:

gcloud run services update SERVICE --session-affinity

Ganti

SERVICE dengan nama layanan yang sedang Anda update.

Untuk menghapus afinitas sesi, gunakan perintah

gcloud run services update SERVICE --no-session-affinity

YAML

Anda dapat mendownload dan melihat konfigurasi layanan yang ada menggunakan perintah gcloud run services describe --format export, yang memberikan hasil yang telah diolah dalam format YAML. Kemudian, Anda dapat mengubah kolom yang dijelaskan di bawah ini dan mengunggah YAML yang telah dimodifikasi menggunakan perintah gcloud run services replace. Pastikan Anda hanya mengubah kolom seperti yang didokumentasikan.

Untuk melihat dan mendownload konfigurasi:

gcloud run services describe SERVICE --format export > service.yaml

Tambahkan anotasi run.googleapis.com/sessionAffinity::
```
spec:
 template:
   metadata:
     annotations:
       run.googleapis.com/sessionAffinity: 'BOOL'
```
Ganti
- 'BOOL' dengan nilai 'true' untuk menetapkan afinitas sesi, atau 'false' untuk menghapus afinitas sesi.
Ganti layanan dengan konfigurasi barunya menggunakan perintah berikut:
```
gcloud run services replace service.yaml
```

Lihat setelan afinitas sesi

Untuk melihat setelan afinitas sesi saat ini untuk layanan Cloud Run Anda:

Konsol

Di konsol Google Cloud, buka Cloud Run:

Buka Cloud Run
Klik layanan yang Anda minati untuk membuka halaman Detail layanan.
Klik tab Revisi.
Di panel detail di sebelah kanan, setelan afinitas sesi tercantum di bagian tab Networking.

Command line

Gunakan perintah berikut:
```
gcloud run services describe SERVICE
```
Temukan setelan afinitas sesi dalam konfigurasi yang ditampilkan.