Hosting: Firebase Functions
Panduan ini akan membimbing kamu untuk men-deploy bot di Firebase Functions.
Persyaratan
Untuk mengikuti panduan ini, kamu perlu memiliki sebuah akun Google. Kalau belum punya, kamu bisa membuatnya di sini.
Persiapan
Pada bagian ini, kami akan memandu kamu melalui proses persiapan yang diperlukan. Jika kamu memerlukan penjelasan yang lebih detail untuk setiap langkah-langkahnya, silahkan lihat dokumentasi resmi Firebase.
Membuat Proyek Firebase
- Buka Firebase console lalu klik Add Project untuk menambahkan project baru.
- Setujui syarat dan ketentuan Firebase yang berlaku.
- Klik Continue untuk melanjutkan.
- Tentukan apakah kamu ingin menggunakan analytic atau tidak.
- Klik Create Project untuk membuat project baru.
Menyiapkan Pengaturan
Untuk membuat sebuah function serta men-deploy-nya ke runtime Firebase Functions, kamu perlu menginstal Node.js dan Firebase CLI terlebih dahulu.
Perlu diketahui bahwa Firebase Functions hanya mendukung Node.js versi 14, 16, dan 18. Untuk informasi lebih lanjut mengenai versi Node.js yang didukung, lihat dokumentasi berikut.
Sesudah Node.js dan NPM terpasang, instal Firebase CLI secara global:
npm install -g firebase-tools
Menyiapkan Proyek
- Jalankan
firebase loginuntuk mengautentikasi Firebase CLI dengan akun kamu melalui browser. cdke direktori proyek kamu.- Jalankan
firebase init functions, lalu ketikyketika diberi pertanyaan apakah kamu ingin membuat codebase baru. - Pilih
use existing project, lalu pilih proyek yang telah kamu buat pada langkah 1. - CLI akan memberikan dua opsi dukungan bahasa pemrograman:
- JavaScript
- TypeScript
- Opsional, pilih opsi ESLint.
- CLI kemudian akan bertanya apakah kamu ingin menginstal dependency melalui npm. Tolak jika kamu menggunakan package manager lain, misalnya
yarnataupnpm. Konsekuensinya, kamu haruscdke direktorifunctionslalu instal dependency secara manual. - Buka file
.lalu cari key:/functions /package .json "engines":. Versi{"node": "16"} nodeharus sesuai dengan versi Node.js yang terinstal. Jika tidak sesuai, proyekmu kemungkinan besar tidak akan bisa berjalan.
Menyiapkan Kode
Kamu bisa menggunakan contoh bot singkat ini sebagai permulaan:
import * as functions from "firebase-functions";
import { Bot, webhookCallback } from "grammy";
const bot = new Bot(""); // <-- taruh token bot-mu di antara ""
bot.command(
"start",
(ctx) => ctx.reply("Selamat datang! Bot berhasil dijalankan."),
);
bot.command("ping", (ctx) => ctx.reply(`Pong! ${new Date()}`));
// Selama mengembangkan bot, kamu bisa men-trigger function kamu melalui https://localhost/<firebase-namaproyek>/us-central1/helloWorld
export const helloWorld = functions.https.onRequest(webhookCallback(bot));
Pengembangan Lokal
Selama proses pengembangan, kamu bisa menggunakan emulator firebase untuk menjalankan kode secara lokal. Cara ini jauh lebih cepat dibandingkan dengan men-deploy setiap perubahan ke Firebase. Untuk menginstal emulator, jalankan perintah berikut:
firebase init emulators
Emulator functions seharusnya sudah terpilih. Kalau belum, arahkan dengan menggunakan tombol panah, lalu tekan space untuk memilih. Jika diberi pertanyaan mengenai port mana yang akan digunakan untuk setiap emulator, cukup tekan enter.
Untuk memulai emulator dan menjalankan kodenya, gunakan:
npm run serve
TIP
Konfigurasi bawaan script npm tidak menjalankan compiler TypeScript dalam mode watch. Oleh karena itu, jika menggunakan TypeScript, kamu juga perlu menjalankan:
npm run build:watch
Setelah emulator dijalankan, semestinya kamu akan menemukan sebuah baris output di console yang kurang lebih terlihat seperti ini:
+ functions[us-central1-helloWorld]: http function initialized (http://127.0.0.1:5001/<firebase-namaproyek>/us-central1/helloWorld).
Itu adalah URL lokal untuk cloud function kamu. Sayangnya, function tersebut hanya akan tersedia untuk localhost di komputer kamu saja. Untuk menguji bot secara nyata, kamu perlu mengekspos function ke internet agar API Telegram bisa mengirim update ke bot-mu. Ada beberapa penyedia layanan yang bisa kamu gunakan untuk melakukan hal tersebut, misalnya localtunnel atau ngrok. Dalam kesempatan kali ini, kita akan menggunakan localtunnel.
Pertama-tama, instal localtunnel:
npm i -g localtunnel
Kemudian, forward port 5001:
lt --port 5001
localtunnel kemudian akan memberimu sebuah URL unik mirip seperti ini: https://.
Terakhir, beri tahu Telegram alamat pengiriman update-nya. Kamu bisa melakukannya dengan cara memanggil set. Buka tab baru di browser, lalu kunjungi URL berikut:
https://api.telegram.org/bot<BOT_TOKEN>/setWebhook?url=<WEBHOOK_URL>/<firebase-namaproyek>/us-central1/helloWorld
Ganti <BOT dengan token bot kamu, dan <WEBHOOK dengan URL yang kamu dapatkan dari localtunnel.
Jika semuanya berjalan dengan baik, Telegram akan membalas dengan:
{
"ok": true,
"result": true,
"description": "Webhook was set"
}
Bot kamu sekarang siap digunakan untuk proses pengembangan.
Men-deploy
Untuk men-deploy function, cukup jalankan:
firebase deploy
Firecase CLI akan memberimu URL function-nya ketika proses deployment selesai dijalankan. URL-nya kurang lebih terlihat seperti ini: https://. Untuk penjelasan lebih lanjut, kamu bisa melihat langkah ke-8 di panduan memulai berikut.
Setelah di-deploy, kamu perlu memberi tahu Telegram untuk mengirim update ke bot kamu dengan cara memanggil method set. Buka sebuah tab browser baru, lalu kunjungi URL berikut:
https://api.telegram.org/bot<BOT_TOKEN>/setWebhook?url=https://<REGION>.<MY_PROJECT>.cloudfunctions.net/helloWorld
Ganti <BOT dengan token bot-mu, <REGION> dengan nama region function kamu di-deploy, dan <MY dengan nama proyek Firebase-mu. Firebase CLI semestinya sudah menyediakan URL lengkap cloud function kamu, sehingga kamu cuma perlu menyalinnya lalu tempel tepat setelah paramater ?url di method set.
Jika semuanya berjalan lancar, kamu akan menerima respon berikut dari Telegram:
{
"ok": true,
"result": true,
"description": "Webhook was set"
}
Selesai. Bot kamu siap digunakan. Buka Telegram dan lihat ia merespon pesan!