Mengonfigurasi instance maksimum (generasi ke-1)

Catatan: Konten ini hanya berlaku untuk Cloud Functions (generasi ke-1). Lihat Perbandingan versi Cloud Functions untuk mengetahui informasi selengkapnya.

Untuk versi generasi ke-2 dokumen ini, lihat Mengonfigurasi instance maksimum (generasi ke-2).

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

Cloud 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 Anda mungkin ingin membatasi jumlah total instance yang boleh ada pada waktu tertentu. Misalnya, fungsi Anda mungkin berinteraksi dengan database yang hanya dapat menangani sejumlah koneksi terbuka 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 menskalakan 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 menetapkan batas, Cloud Functions akan menetapkan nilai default 3.000.

Untuk menetapkan batas instance maksimum:

Konsol

1. Buka halaman Ringkasan Cloud Functions.

2. Klik Create function.

3. Lengkapi kolom wajib isi untuk fungsi Anda.

4. Luaskan bagian Runtime, build... di akhir halaman, lalu klik tab Runtime.

5. Pada kolom Maximum number of instances di bagian Autoscaling, masukkan nilai atau gunakan nilai 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, 3000.

Menghapus batas instance maksimum

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

Konsol

Untuk menghapus batas instance maksimum untuk sebuah fungsi:

1. Buka halaman Ringkasan Cloud Functions.

2. Klik fungsi yang ada untuk membuka halaman detailnya. Anda dapat melihat batas instance maksimum fungsi saat ini di tab Details.

3. Klik Edit.

4. Luaskan bagian Runtime, build... di akhir halaman, lalu klik tab Runtime.

5. Di kolom Maximum number of instances di bagian Autoscaling, masukkan 0.

gcloud

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

gcloud functions deploy FUNCTION_NAME --clear-max-instances

Batasan & praktik terbaik

Bagian ini berisi panduan penggunaan instance maksimum.

Pilih nilai instance maksimum

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

Melindungi dari peningkatan skala yang berlebihan

Jika tidak ada batas instance maksimum yang ditentukan, Cloud Functions akan memprioritaskan peningkatan skala untuk memenuhi permintaan yang melebihi batas throughput. Artinya, jumlah instance simultan yang mungkin dimiliki fungsi Anda sebenarnya tidak terbatas, kecuali jika batas tersebut telah dikonfigurasi.

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 Functions 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.

Permintaan yang dikirim ke fungsi HTTP yang kelebihan beban 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 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. Artinya, jumlah instance yang berdampingan pada suatu waktu tidak boleh melebihi batas.

Selain itu, menetapkan batas instance maksimum dapat memengaruhi strategi penskalaan yang digunakan Cloud Functions untuk memenuhi permintaan traffic Anda. Secara umum, Cloud Functions akan memprioritaskan pemenuhan batas yang Anda tentukan, bukan meningkatkan skala dan berpotensi melebihi batas Anda.

Menangani lonjakan traffic

Dalam beberapa kasus, seperti lonjakan traffic yang cepat, Cloud 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 versi baru fungsi, Cloud Functions akan memigrasikan traffic dari versi sebelumnya 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 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 10 instance total (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 suatu fungsi ke 0 akan menghapus batas instance maksimum yang ada pada fungsi tersebut, tetapi tidak menjeda fungsi Anda.