หากต้องการกำหนดเวลาให้ฟังก์ชันทำงานตามเวลาที่ระบุ ให้ใช้แฮนเดิล onSchedule เพื่อสร้างหัวข้อ Pub/Sub ที่ใช้ Cloud Scheduler เพื่อทริกเกอร์เหตุการณ์ในหัวข้อนั้น
ก่อนเริ่มต้น
แม้ว่าจะมีการเรียกเก็บเงินสำหรับฟังก์ชันที่กำหนดเวลาไว้ แต่คุณสามารถคาดหวังได้ว่าค่าใช้จ่ายโดยรวมจะจัดการได้ เนื่องจากงาน Cloud Scheduler แต่ละงานมีค่าใช้จ่าย $0.10 (USD) ต่อเดือน และมีสิทธิ์ใช้งาน 3 งานต่อบัญชี Google โดยไม่มีค่าใช้จ่าย ใช้เครื่องคำนวณราคาของแพ็กเกจ Blaze เพื่อสร้างค่าใช้จ่ายโดยประมาณตามการใช้งานที่คาดการณ์ไว้
ต้องเปิดใช้ Pub/Sub และ Cloud Scheduler API สำหรับโปรเจ็กต์ของคุณ ซึ่งควรเปิดใช้อยู่แล้วสำหรับโปรเจ็กต์ Firebase ส่วนใหญ่ โดยคุณสามารถตรวจสอบได้ในคอนโซล Google Cloud
เขียนฟังก์ชันที่กำหนดเวลาไว้
ใน Cloud Functions for Firebase ตรรกะการกำหนดเวลาจะอยู่ในโค้ดฟังก์ชัน โดยไม่มีข้อกำหนดพิเศษเกี่ยวกับเวลาในการทำให้ใช้งานได้ หากต้องการสร้างฟังก์ชันที่กำหนดเวลาไว้ ให้ใช้ functions.pubsub.schedule('your schedule').onRun((context))
ตัวอย่างเช่น หากต้องการเรียกใช้ฟังก์ชันทุกๆ 5 นาทีด้วยไวยากรณ์ App Engine cron.yaml ให้ทำดังนี้
exports.scheduledFunction = functions.pubsub.schedule('every 5 minutes').onRun((context) => {
console.log('This will be run every 5 minutes!');
return null;
});
Cloud Scheduler รองรับทั้งไวยากรณ์ Unix Crontab และ App Engine ตัวอย่างเช่น หากต้องการใช้ Crontab เพื่อเลือกเขตเวลาที่เฉพาะเจาะจงในการเรียกใช้ฟังก์ชันที่กำหนดเวลาไว้ ให้ทำดังนี้
exports.scheduledFunctionCrontab = functions.pubsub.schedule('5 11 * * *')
.timeZone('America/New_York') // Users can choose timezone - default is America/Los_Angeles
.onRun((context) => {
console.log('This will be run every day at 11:05 AM Eastern!');
return null;
});
ค่าของ timeZone ต้องเป็นชื่อเขตเวลาจากฐานข้อมูล tz ดูข้อมูลเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ที่รองรับได้ที่ข้อมูลอ้างอิง Cloud Scheduler
ทำให้ฟังก์ชันที่กำหนดเวลาไว้ใช้งานได้
เมื่อคุณทำให้ฟังก์ชันที่กำหนดเวลาไว้ใช้งานได้ ระบบจะสร้างงานของตัวจัดกำหนดการและหัวข้อ Pub/Sub ที่เกี่ยวข้องโดยอัตโนมัติ Firebase CLI จะแสดงชื่อหัวข้อ และคุณสามารถดูงานและหัวข้อได้ในคอนโซล Google Cloud หัวข้อจะตั้งชื่อตามรูปแบบต่อไปนี้
firebase-scheduled-function_name-region
เช่น
firebase-scheduled-scheduledFunctionCrontab-us-east1.