安排函数运行时间


如果您要安排函数在指定时间运行,可使用 onSchedule 处理程序创建 Pub/Sub 主题,继而使用 Cloud Scheduler 触发与该主题相关的事件。

准备工作

如需在 Firebase 项目中使用此解决方案,您的项目必须采用 Blaze 定价方案。如果您目前使用的不是 Blaze 方案,请升级您的定价方案

虽然需要结算,但总费用应是可控的,因为每项 Cloud Scheduler 作业每月费用为 0.10 美元,并且每个 Google 账号可以享受三项免费作业的福利。您可使用 Blaze 价格计算器根据您的预计使用情况来估算费用。

您必须为您的项目启用 Pub/SubCloud 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.