Fungsi Cloud Run Anda berjalan di lingkungan yang terdiri dari versi sistem operasi dengan paket add-on, dukungan bahasa, dan library Node.js Functions Framework yang mendukung dan memanggil fungsi Anda. Lingkungan ini diidentifikasi berdasarkan versi bahasa, dan dikenal sebagai ID runtime.
Persiapan fungsi
Anda dapat menyiapkan fungsi langsung dari konsol Google Cloud atau menulisnya di komputer lokal, lalu menguploadnya. Untuk menyiapkan mesin lokal Anda untuk pengembangan Node.js, lihat Menyiapkan lingkungan pengembangan Node.js.
Memilih runtime Anda
Fungsi Cloud Run mendukung beberapa versi Node.js, yang tercantum di halaman Runtime bahasa dan image dasar yang didukung. Anda dapat memilih runtime Node.js pilihan untuk fungsi Anda selama deployment:
gcloud
Untuk menggunakan fungsi Cloud Run guna men-deploy fungsi HTTP menggunakan gcloud CLI, lihat Men-deploy menggunakan Google Cloud CLI.
Konsol
Jika Anda menggunakan konsol Google Cloud , pilih runtime saat membuat dan men-deploy fungsi. Lihat panduan memulai konsolGoogle Cloud untuk mengetahui petunjuk mendetail.
Struktur kode sumber
Agar fungsi Cloud Run dapat menemukan definisi fungsi Anda, kode sumber harus mengikuti struktur tertentu. Lihat artikel Menulis fungsi Cloud Run untuk mengetahui informasi selengkapnya.
Menentukan dependensi
Anda dapat menentukan dependensi fungsi dengan mencantumkannya dalam
file package.json
. Untuk informasi selengkapnya, lihat
Menentukan dependensi di Node.js.
Skrip build NPM
Secara default, runtime Node.js akan mengeksekusi npm run build
jika skrip
build
terdeteksi di package.json
. Jika memerlukan kontrol tambahan pada
langkah-langkah build sebelum memulai aplikasi, Anda dapat memberikan langkah build kustom
dengan menambahkan skrip gcp-build
ke file package.json
.
Anda dapat mencegah build agar tidak menjalankan skrip npm run build
dengan:
Menambahkan skrip
gcp-build
dengan nilai kosong di filepackage.json
Anda:"gcp-build":""
.Menetapkan variabel lingkungan build
GOOGLE_NODE_RUN_SCRIPTS
ke string kosong untuk mencegah semua skrip berjalan.
Penyelesaian fungsi asinkron
Saat menangani tugas asinkron yang melibatkan callback atau objek
Promise
, Anda harus secara eksplisit memberi tahu runtime bahwa fungsi Anda telah selesai
mengeksekusi tugas ini. Anda dapat melakukannya dengan beberapa cara, seperti yang ditunjukkan dalam
contoh berikut. Kuncinya adalah kode Anda harus menunggu
tugas asinkron atau Promise
selesai sebelum ditampilkan; jika tidak,
komponen asinkron fungsi Anda mungkin dihentikan sebelum selesai.
Fungsi berbasis peristiwa
Tampilan implisit
exports.implicitlyReturning = async (event, context) => {
return await asyncFunctionThatReturnsAPromise();
};
Tampilan eksplisit
exports.explicitlyReturning = function (event, context) {
return asyncFunctionThatReturnsAPromise();
};
Fungsi HTTP
Menggunakan middleware untuk menangani permintaan HTTP
Fungsi HTTP Node.js menyediakan objek request
dan response
yang kompatibel dengan ExpressJS
untuk menyederhanakan pemakaian permintaan HTTP. Fungsi Cloud Run
otomatis membaca isi permintaan, sehingga Anda akan selalu menerima isi
permintaan, apa pun jenis medianya. Artinya, permintaan HTTP harus dianggap telah
dibaca sepenuhnya pada saat kode Anda dieksekusi. Penyusunan
aplikasi ExpressJS harus digunakan dengan peringatan ini—khususnya,
middleware yang memperkirakan isi permintaan belum dibaca mungkin tidak berperilaku seperti
yang diharapkan.
Menggunakan Modul ES
Modul ECMAScript (modul ES atau ESM) adalah fitur standar TC39 yang tidak ditandai
di Node versi 14+ untuk memuat modul JavaScript. Tidak seperti CommonJS, ESM
menyediakan API asinkron untuk memuat modul. Cara ini juga memberikan peningkatan sintaksis populer dengan pernyataan import
dan export
yang dapat digunakan dalam fungsi Cloud Run (bukan pernyataan require
).
Untuk menggunakan ESM dalam fungsi Cloud Run, Anda harus mendeklarasikan "type": "module"
dalam package.json
.
{
...
"type": "module",
...
}
Selanjutnya, Anda dapat menggunakan pernyataan import
dan export
.
Pelajari lebih lanjut cara menggunakan modul ES.