Mengaktifkan percobaan ulang fungsi berbasis peristiwa (generasi ke-1)
Dokumen ini menjelaskan cara mengaktifkan percobaan ulang untuk fungsi berdasarkan peristiwa. Percobaan ulang otomatis tidak tersedia untuk fungsi HTTP.
Semantik percobaan ulang
Fungsi Cloud Run menyediakan eksekusi fungsi berbasis peristiwa setidaknya satu kali untuk setiap peristiwa yang dipancarkan oleh sumber peristiwa. Secara default, jika pemanggilan fungsi dihentikan dengan error, fungsi tersebut tidak akan dipanggil lagi dan peristiwa akan dihapus. Saat Anda mengaktifkan percobaan ulang pada peristiwa berbasis peristiwa fungsi Cloud Run akan mencoba kembali pemanggilan fungsi yang gagal hingga proses itu berhasil diselesaikan, atau periode percobaan ulang akan berakhir.
Periode percobaan ulang ini akan berakhir setelah 7 hari. Fungsi Cloud Run mencoba ulang fungsi berbasis peristiwa yang baru dibuat menggunakan strategi backoff eksponensial, dengan backoff yang meningkat antara 10 dan 600 detik. Kebijakan ini diterapkan ke fungsi baru saat pertama kali di-deploy. Kebijakan ini tidak berlaku surut untuk fungsi yang sudah ada dan pertama kali di-deploy sebelum perubahan yang dijelaskan dalam catatan rilis ini mulai diterapkan, meskipun Anda men-deploy ulang fungsi tersebut.
Jika percobaan ulang tidak diaktifkan untuk suatu fungsi, yang merupakan setelan default, fungsi tersebut akan selalu melaporkan keberhasilan eksekusinya, dan kode respons 200 OK
mungkin muncul dalam log-nya. Ini bisa terjadi meskipun fungsi mengalami error. Kepada
menjelaskan ketika {i>function<i} Anda
mengalami {i>error<i}, pastikan untuk
melaporkan error
dengan tepat.
Alasan fungsi berbasis peristiwa gagal diselesaikan
Terkadang, fungsi keluar sebelum waktunya karena terjadi error internal, dan secara default fungsi tersebut akan atau tidak akan dicoba ulang secara otomatis.
Biasanya, fungsi berbasis peristiwa dapat gagal diselesaikan karena terjadi error pada kode fungsi itu sendiri. Alasan terjadinya hal ini meliputi:
- Fungsi berisi bug dan runtime menampilkan pengecualian.
- Fungsi tersebut tidak dapat menjangkau endpoint layanan, atau waktu habis saat mencoba melakukannya.
- Fungsi sengaja menampilkan pengecualian (misalnya, saat parameter menggagalkan validasi).
- Fungsi Node.js menampilkan promise yang ditolak, atau meneruskan nilai non-
null
ke callback.
Dalam setiap kasus ini, fungsi akan berhenti dieksekusi secara default dan peristiwa akan terjadi akan dibuang. Untuk mencoba kembali fungsi ini saat terjadi error, Anda dapat mengubah kebijakan coba lagi default dengan menyetel properti "coba lagi jika gagal". Hal ini menyebabkan peristiwa tersebut dicoba ulang berulang kali hingga fungsi berhasil diselesaikan atau waktu tunggu percobaan ulang berakhir.
Mengaktifkan atau menonaktifkan percobaan ulang
Untuk mengaktifkan atau menonaktifkan percobaan ulang, Anda dapat menggunakan alat command line gcloud
atau Google Cloud Console. Secara default, percobaan ulang dinonaktifkan.
Konfigurasikan percobaan ulang dari alat command line gcloud
Untuk mengaktifkan percobaan ulang menggunakan alat command line gcloud
, sertakan flag --retry
saat men-deploy fungsi Anda:
gcloud functions deploy FUNCTION_NAME --retry FLAGS...
Untuk menonaktifkan percobaan ulang, deploy ulang fungsi tanpa tanda --retry
:
gcloud functions deploy FUNCTION_NAME FLAGS...
Mengonfigurasi percobaan ulang dari konsol
Jika Anda membuat fungsi baru:
- Dari layar Create Function, di bagian Trigger, pilih jenis peristiwa yang akan bertindak sebagai pemicu untuk fungsi Anda.
- Centang kotak Coba lagi jika gagal untuk mengaktifkan percobaan ulang.
Jika Anda mengupdate fungsi yang sudah ada:
- Dari halaman Cloud Run functions Overview klik nama fungsi yang Anda perbarui untuk membuka layar Detail fungsi, lalu pilih Edit dari panel menu untuk menampilkan panel Trigger.
- Centang atau hapus centang pada kotak Coba lagi saat gagal untuk mengaktifkan atau menonaktifkan percobaan ulang.
Praktik terbaik
Bagian ini menjelaskan praktik terbaik untuk menggunakan percobaan ulang.
Menggunakan percobaan ulang untuk menangani error sementara
Karena fungsi terus dicoba ulang hingga berhasil dijalankan, error permanen, seperti bug, harus dihilangkan dari kode Anda melalui pengujian menyeluruh sebelum percobaan ulang diaktifkan. Percobaan ulang paling baik digunakan untuk menangani gangguan atau sementara kegagalan yang memiliki kemungkinan resolusi tinggi setelah dicoba ulang, seperti layanan yang tidak stabil atau batas waktu habis.
Menetapkan kondisi akhir agar percobaan ulang tidak terjebak dalam loop tanpa henti
Salah satu praktik terbaik adalah melindungi fungsi Anda dari loop terus-menerus saat menggunakan percobaan ulang. Anda dapat melakukannya dengan menyertakan kondisi akhir yang ditetapkan dengan baik, sebelum fungsi mulai diproses. Ingat bahwa teknik ini hanya berfungsi jika fungsi Anda berhasil dimulai dan dapat mengevaluasi kondisi akhir.
Pendekatan yang sederhana tetapi efektif adalah dengan menghapus peristiwa yang memiliki stempel waktu lebih lama dari rentang tertentu. Langkah ini dapat menghindari eksekusi berlebihan saat kegagalan terus-menerus terjadi atau berlangsung lebih lama daripada perkiraan.
Misalnya, cuplikan kode ini menghapus semua peristiwa yang lebih lama dari 10 detik:
Node.js
Python
Go
Java
C#
Ruby
PHP
Membedakan antara fungsi yang dapat dicoba lagi dan error fatal
Jika fungsi Anda mengaktifkan percobaan ulang, error yang tidak ditangani akan memicu percobaan ulang. Pastikan kode Anda menangkap error yang seharusnya tidak menyebabkan percobaan ulang.
Node.js
Python
Go
Java
C#
Ruby
PHP
Membuat fungsi berbasis peristiwa yang dapat dicoba ulang jadi bersifat idempoten
Fungsi berdasarkan peristiwa yang dapat dicoba lagi harus bersifat idempoten. Berikut adalah beberapa panduan umum untuk membuat fungsi bersifat idempoten:
- Banyak API eksternal (seperti Stripe) yang dapat Anda gunakan untuk menyuplai kunci idempotensi sebagai parameter. Jika menggunakan API seperti itu, Anda harus menggunakan ID peristiwa sebagai kunci idempotensi.
- Idempotensi berfungsi dengan baik pada pengiriman "setidaknya sekali" karena memberikan keamanan untuk mencoba ulang. Jadi, salah satu praktik terbaik yang umum untuk menulis kode tepercaya adalah dengan menggabungkan idempotensi dengan percobaan ulang.
- Pastikan kode Anda idempoten secara internal. Contoh:
- Pastikan mutasi bisa terjadi lebih dari sekali tanpa mengubah hasilnya.
- Jalankan kueri pada status database dalam transaksi sebelum memutasikan status tersebut.
- Pastikan semua efek samping bersifat idempoten.
- Lakukan pemeriksaan transaksi di luar fungsi, terlepas dari kode. Sebagai contoh, pertahankan status di suatu tempat yang mencatat bahwa ID peristiwa tertentu telah diproses.
- Tangani panggilan fungsi duplikat yang tidak umum. Misalnya, jalankan proses pembersihan terpisah yang akan melakukan pembersihan setelah panggilan fungsi duplikat.
Mengonfigurasi kebijakan percobaan ulang
Tergantung pada kebutuhan fungsi, Anda dapat mengonfigurasi kebijakan percobaan ulang secara langsung. Dengan begitu, Anda akan dapat menyiapkan kombinasi berikut:
- Mempersingkat periode percobaan ulang dari 7 hari menjadi hanya 10 menit.
- Mengubah waktu backoff minimum dan maksimum untuk strategi percobaan ulang backoff eksponensial.
- Mengubah strategi percobaan ulang untuk mencoba ulang dengan seketika.
- Mengonfigurasi topik yang dihentikan pengirimannya.
- Menetapkan jumlah upaya pengiriman maksimum dan minimum.
Untuk mengonfigurasi kebijakan percobaan ulang:
- Tulis fungsi HTTP.
- Gunakan Pub/Sub API untuk membuat langganan Pub/Sub, dengan menentukan URL fungsi sebagai target.
Lihat dokumentasi Pub/Sub mengenai penanganan kegagalan untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi Pub/Sub secara langsung.
Langkah berikutnya
- Men-deploy fungsi Cloud Run.
- Memanggil Fungsi Pemicu Pub/Sub.
- Memanggil Fungsi Pemicu Cloud Storage.
- Fungsi Cloud Run dengan Tutorial Pub/Sub.
- Tutorial Cloud Run dengan Cloud Storage.