Secara default, layanan Cloud Run memiliki maksimum 100 instance. Anda dapat meningkatkan jumlah ini hingga maksimum yang diizinkan untuk wilayah Anda. Batas maksimum untuk setiap region juga terpengaruh oleh konfigurasi CPU dan memori untuk layanan Cloud Run Anda. Secara khusus, jumlah maksimum instance yang tersedia untuk layanan Anda adalah minimum dari setiap hal berikut:
- dasar pengukuran kuota regional dibagi dengan kelipatan 1 CPU yang diminta
- dasar pengukuran kuota regional dibagi dengan kelipatan memori 2 GB yang diminta
Misalnya, kuota dasar sebanyak 1000 instance dengan 4GB memori atau 2CPU sama-sama akan mendapat batas efektif sebanyak 500.
Anda dapat melihat dasar pengukuran kuota per region untuk region Anda di halaman kuota di konsol.
Cara meningkatkan kuota regional dasar pengukuran
Jika memerlukan jumlah maksimum instance yang lebih besar untuk region tempat layanan Cloud Run Anda di-deploy, Anda dapat meminta peningkatan kuota.
Praktik terbaik untuk menetapkan instance maksimum
Bagian berikut menjelaskan praktik terbaik untuk mengonfigurasi batas instance maksimum untuk layanan Anda.
Nilai instance maksimum yang optimal untuk layanan berbasis peristiwa
Layanan berbasis peristiwa, seperti fungsi, dapat mengalami lonjakan traffic yang sporadis berdasarkan peristiwa yang masuk. Untuk menentukan nilai instance maksimum yang optimal untuk layanan ini, Anda perlu mempertimbangkan faktor-faktor seperti waktu pemanggilan layanan, pemanggilan rata-rata yang diharapkan, frekuensi pemanggilan puncak, dan toleransi error untuk kegagalan pemanggilan.
Pedoman yang baik adalah memulai dengan nilai instance maksimum sebesar 3, lalu memantau kegagalan pemanggilan dan menyesuaikan nilai instance maksimum ke atas sesuai kebutuhan.
Menangani permintaan saat semua instance sedang sibuk
Dalam keadaan normal, layanan Anda akan ditingkatkan skalanya dengan membuat instance baru untuk menangani beban traffic yang masuk. Namun, jika Anda telah menetapkan batas instance maksimum, Anda mungkin akan menghadapi skenario ketika tidak ada instance yang cukup untuk memenuhi beban traffic yang masuk.
Dalam skenario tersebut, Cloud Run akan mencoba menyajikan permintaan masuk baru hingga 30 detik:
- Jika instance selesai memproses permintaannya selama jangka waktu ini, instance tersebut mungkin akan mulai memproses permintaan masuk baru.
- Jika tidak ada instance yang tersedia, permintaan akan gagal.
Cloud Run otomatis menyimpan peristiwa yang ditujukan untuk layanan berbasis peristiwa hingga kapasitas tersedia.
Batas instance maksimum yang melebihi kemampuan penskalaan Cloud Run
Saat menentukan batas instance maksimum, Anda juga menentukan batas atas. Menetapkan batas besar tidak berarti bahwa layanan Anda akan ditingkatkan skalanya hingga jumlah instance yang ditentukan. Hal ini hanya berarti bahwa jumlah instance yang berdampingan pada waktu tertentu tidak boleh melebihi batas.
Selain itu, menetapkan batas instance maksimum dapat memengaruhi strategi penskalaan yang digunakan Cloud Run untuk memenuhi permintaan traffic Anda. Secara umum, Cloud Run akan memprioritaskan kepatuhan terhadap batas yang Anda tentukan daripada meningkatkan skala dan berpotensi melampaui batas.
Menangani lonjakan traffic
Dalam beberapa kasus, seperti lonjakan traffic yang cepat, Cloud Run mungkin, dalam jangka waktu yang singkat, membuat lebih banyak instance daripada batas instance maksimum yang ditentukan. Jika layanan Anda tidak dapat menoleransi perilaku sementara ini, Anda mungkin ingin mempertimbangkan margin keamanan dan menetapkan nilai instance maksimum yang lebih rendah daripada yang dapat ditoleransi oleh layanan Anda.
Deployment
Saat Anda men-deploy revisi baru, Cloud Run akan memigrasikan traffic dari revisi sebelumnya ke revisi baru. Karena batas instance maksimum ditetapkan untuk setiap revisi secara independen, Anda mungkin melampaui batas yang ditentukan untuk sementara selama periode setelah deployment.
Misalnya, layanan mungkin memiliki batas instance maksimum sebanyak 5. Dalam keadaan normal, layanan meningkatkan skala hingga 5 instance saat menangani permintaan. Saat Anda men-deploy revisi baru, revisi baru memiliki batas instance maksimumnya sendiri, yaitu 5.
Permintaan yang sudah ditangani oleh revisi sebelumnya tidak akan terganggu saat Anda men-deploy revisi baru. Sebaliknya, permintaan ini akan terus diproses. Permintaan masuk baru akan ditangani oleh revisi layanan Anda yang baru di-deploy.
Dengan demikian, layanan dalam contoh sebelumnya mungkin memiliki hingga 10 instance total (5 untuk setiap revisi) selama periode setelah men-deploy revisi baru. Jumlah waktu yang diperlukan untuk menghentikan instance revisi sebelumnya bergantung pada waktu yang diperlukan bagi instance tersebut untuk menyelesaikan penanganan permintaan aktif apa pun. Ini adalah faktor tambahan yang perlu dipertimbangkan saat memilih batas instance maksimum yang sesuai.