如果您要安排函数在指定时间运行,可使用 onSchedule
处理程序创建 Pub/Sub 主题,继而使用 Cloud Scheduler 触发与该主题相关的事件。
准备工作
如需在 Firebase 项目中使用此解决方案,您的项目必须采用 Blaze 定价方案。如果您目前使用的不是 Blaze 方案,请升级您的定价方案。
虽然需要结算,但总费用应是可控的,因为每项 Cloud Scheduler 作业每月费用为 0.10 美元,并且每个 Google 账号可以享受三项免费作业的福利。您可使用 Blaze 价格计算器根据您的预计使用情况来估算费用。
您必须为您的项目启用 Pub/Sub 和 Cloud Scheduler API。对于大多数 Firebase 项目而言,这些 API 应该已启用;您可以在 Google Cloud 控制台中验证这些 API 是否已启用。
编写预定函数
在 Cloud Functions for Firebase 中,预定逻辑位于您的函数代码中,没有特殊的部署时间要求。如需创建预定函数,请使用 functions.pubsub.schedule('your schedule').onRun((context))
。例如,如需使用 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 参考文档。
部署预定函数
在您部署预定函数时,系统会自动创建相关的调度程序作业和发布/订阅主题。Firebase CLI 会回显主题名称;您可以在 Google Cloud 控制台中查看作业和主题。系统会根据以下惯例为主题命名:
firebase-scheduled-function_name-region
例如:
firebase-scheduled-scheduledFunctionCrontab-us-east1.