排定函式


如果您想排定函式在特定時間執行,請使用 onSchedule 處理常式建立 Pub/Sub 主題,該主題會使用 Cloud Scheduler 觸發該主題上的事件。

事前準備

如要在 Firebase 專案中使用這項解決方案,專案必須採用 Blaze 定價方案。如果尚未採用 Blaze 方案,請升級定價方案

雖然需要帳單,但整體費用可控,因為每項 Cloud Scheduler 工作每月費用為 $0.10 美元,且每個 Google 帳戶可免費建立三項工作。使用 Blaze Pricing Calculator,根據您的預測使用量產生預估費用。

您必須為專案啟用 Pub/SubCloud Scheduler API。這些功能應已為大多數 Firebase 專案啟用;您可以在 Google Cloud 控制台中確認。

編寫排程函式

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 參考資料

部署排程函式

部署排程函式時,系統會自動建立相關排程器工作和 pub/sub 主題。Firebase CLI 會回應主題名稱,您可以在 Google Cloud 控制台中查看工作和主題。主題的命名方式如下:

firebase-scheduled-function_name-region

例如:

firebase-scheduled-scheduledFunctionCrontab-us-east1.