Jika Anda membuat fungsi baru, lihat Panduan Memulai Konsol di Cloud Run. Konten di halaman ini hanya berlaku untuk fungsi lama yang ada dan dibuat dengan Cloud Functions v1 API.

Mengonfigurasi instance maksimum (generasi ke-1)

Anda dapat mengontrol perilaku penskalaan fungsi dengan menetapkan jumlah maksimum instance Cloud Run Functions. Menetapkan instance maksimum akan mengontrol biaya dan mencegah resource downstream kewalahan dengan traffic.

Cloud Run Functions melakukan penskalaan dengan membuat instance baru dari fungsi Anda. Setiap instance ini hanya dapat menangani satu permintaan dalam satu waktu, sehingga lonjakan besar dalam volume permintaan dapat menyebabkan pembuatan banyak instance.

Penskalaan otomatis umumnya bermanfaat, tetapi dalam beberapa kasus sebaiknya Anda membatasi jumlah total instance yang boleh ada pada waktu tertentu. Misalnya, fungsi Anda dapat berinteraksi dengan database yang hanya dapat menangani koneksi terbuka dalam jumlah tertentu.

Menetapkan dan menghapus batas instance maksimum

Anda dapat menetapkan jumlah maksimum instance untuk fungsi selama deployment. Setiap fungsi memiliki setelan instance maksimumnya sendiri. Fungsi melakukan penskalaan secara independen satu sama lain.

Menetapkan batas instance maksimum

Anda dapat menetapkan batas instance maksimum menggunakan Google Cloud CLI atau konsol Google Cloud . Jika Anda tidak menentukan batas, Cloud Run Functions akan menetapkan jumlah default sebesar 3.000 instance.

Untuk menetapkan batas instance maksimum:

Konsol

Buka halaman Overview Cloud Run Functions.
Klik Create function.
Lengkapi kolom yang wajib diisi untuk fungsi Anda.
Luaskan bagian Runtime, build... di akhir halaman, lalu klik tab Runtime.
Di kolom Maximum number of instances di bagian Autoscaling, masukkan nilai atau gunakan default.

gcloud

Untuk menetapkan batas instance maksimum, jalankan perintah deploy dengan flag --max-instances:

gcloud functions deploy FUNCTION_NAME --max-instances MAX_INSTANCE_LIMIT

Ganti kode berikut:

FUNCTION_NAME: Nama fungsi.
MAX_INSTANCE_LIMIT: Jumlah yang akan ditetapkan sebagai batas instance maksimum, misalnya 3.000.

Menghapus batas instance maksimum

Anda dapat menghapus batas instance maksimum untuk fungsi menggunakan alat command line gcloud atau konsol Google Cloud .

Konsol

Untuk menghapus batas instance maksimum untuk fungsi:

Buka halaman Overview Cloud Run Functions.
Klik fungsi yang ada untuk membuka halaman detailnya. Anda dapat melihat batas instance maksimum fungsi saat ini di tab Details.
Klik Edit.
Luaskan bagian Runtime, build... di akhir halaman, lalu klik tab Runtime.
Di kolom Maximum number of instances di bagian Autoscaling, masukkan 0.

gcloud

Untuk menghapus batas instance maksimum untuk fungsi, jalankan perintah deploy dengan flag --clear-max-instances:

gcloud functions deploy FUNCTION_NAME --no-gen2 --clear-max-instances

Batasan & praktik terbaik

Bagian ini berisi panduan penggunaan instance maksimum.

Memilih nilai instance maksimum

Nilai optimal untuk setelan instance maksimum bergantung pada karakteristik fungsi Anda, termasuk durasi eksekusi pemanggilan, frekuensi pemanggilan rata-rata dan puncak yang diharapkan, serta toleransi aplikasi Anda terhadap kegagalan pemanggilan. Aturan praktis yang baik adalah memulai dengan nilai instance maksimum 3, lalu memantau kegagalan pemanggilan dan menyesuaikan nilai instance maksimum ke atas sesuai kebutuhan.

Melindungi dari peningkatan skala yang berlebihan

Jika tidak ada batas instance maksimum yang ditentukan, Cloud Run Functions lebih memilih peningkatan skala untuk memenuhi permintaan daripada membatasi throughput. Artinya, jumlah instance simultan yang mungkin dimiliki fungsi Anda secara efektif tidak terbatas kecuali jika Anda telah mengonfigurasi batas tersebut.

Sebaiknya tetapkan batas --max-instances untuk setiap fungsi yang mengirim permintaan ke layanan downstream dengan throughput yang dibatasi atau tidak skalabel. Batas instance maksimum meningkatkan stabilitas sistem secara keseluruhan dan membantu mencegah tingkat permintaan tinggi yang tidak normal.

Meminta penanganan saat semua instance sedang sibuk

Dalam keadaan normal, fungsi 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 Functions akan mencoba melayani 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.

Permintaan yang dikirim ke fungsi HTTP yang kelebihan beban akan gagal dengan kode respons

429 Too Many Requests jika nilai instance maksimum dikonfigurasi, atau
500 Internal Server Error jika tidak ada nilai instance maksimum yang dikonfigurasi

Peristiwa yang ditujukan untuk fungsi berbasis peristiwa akan otomatis disimpan hingga kapasitas tersedia.

Batas instance maksimum yang melebihi kemampuan penskalaan Cloud Run Functions

Saat menentukan batas instance maksimum, Anda juga menentukan batas atas. Menetapkan batas besar tidak berarti bahwa fungsi Anda akan meningkatkan skala 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 Functions untuk memenuhi permintaan traffic Anda. Secara umum, Cloud Run Functions 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 Functions mungkin, dalam jangka waktu yang singkat, membuat lebih banyak instance daripada batas instance maksimum yang ditentukan. Jika fungsi Anda tidak dapat menoleransi perilaku sementara ini, Anda mungkin perlu memperhitungkan margin keamanan dan menetapkan nilai instance maksimum yang lebih rendah daripada yang dapat ditoleransi oleh fungsi Anda.

Deployment

Saat Anda men-deploy fungsi versi baru, Cloud Run Functions akan memigrasikan traffic dari versi lama ke versi baru. Karena batas instance maksimum ditetapkan untuk setiap versi fungsi secara independen, Anda mungkin melampaui batas yang ditentukan untuk sementara selama periode setelah deployment.

Misalnya, sebuah fungsi mungkin memiliki batas instance maksimum sebanyak 5. Dalam keadaan normal, fungsi meningkatkan skala hingga 5 instance saat menangani permintaan. Saat versi baru fungsi di-deploy, versi baru ini memiliki batas instance maksimumnya sendiri, yaitu 5.

Permintaan yang sudah ditangani oleh fungsi versi sebelumnya tidak akan terganggu saat versi baru fungsi di-deploy. Sebaliknya, permintaan ini akan terus diproses. Permintaan masuk baru akan ditangani oleh versi fungsi yang baru di-deploy.

Dengan demikian, fungsi dalam contoh sebelumnya mungkin memiliki hingga total 10 instance (5 untuk setiap versi fungsi Anda) selama periode setelah men-deploy versi baru. Jumlah waktu yang diperlukan untuk menghentikan instance fungsi 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.

Menghapus batas instance maksimum

Menetapkan instance maksimum untuk fungsi ke 0 akan menghapus batas instance maksimum fungsi yang ada, tetapi tidak akan menjeda fungsi Anda.