Zaplanowane funkcje (1 generacji)

Jeśli chcesz zaplanować uruchamianie funkcji o określonych porach, użyj modułu obsługi onSchedule, aby utworzyć Pub/Sub, który będzie używać Cloud Scheduler do wyzwalania zdarzeń w tym temacie.

Zanim zaczniesz

Za zaplanowane funkcje są naliczane opłaty, ale ogólny koszt powinien być do opanowania, ponieważ każde Cloud Scheduler zadanie kosztuje 0, 10 USD miesięcznie, a na każde konto Google przysługują 3 bezpłatne zadania. Kalkulator cen Blaze pozwala oszacować koszty na podstawie przewidywanego wykorzystania.

W projekcie musisz włączyć interfejsy API Pub/Sub i Cloud Scheduler. W większości projektów Firebase powinny być już włączone. Możesz to sprawdzić w Google Cloud konsoli.

Pisanie zaplanowanej funkcji

W Cloud Functions for Firebase logika planowania znajduje się w kodzie funkcji, nie ma specjalnych wymagań dotyczących wdrożenia. Aby utworzyć zaplanowaną funkcję, użyj functions.pubsub.schedule('your schedule').onRun((context)). Aby na przykład uruchamiać funkcję co 5 minut za pomocą App Engine cron.yaml składni, wykonaj te czynności:

exports.scheduledFunction = functions.pubsub.schedule('every 5 minutes').onRun((context) => {
  console.log('This will be run every 5 minutes!');
  return null;
});

Cloud Scheduler obsługuje składnię Unix Crontab i App Engine syntax Cloud Scheduler. Aby na przykład użyć Crontab do wybrania konkretnej strefy czasowej, w której ma być uruchamiana zaplanowana funkcja, wykonaj te czynności:

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;
});

Wartość timeZone musi być nazwą strefy czasowej z bazy danych tz. Więcej informacji o obsługiwanych właściwościach znajdziesz w dokumentacji Cloud Scheduler reference.

Wdrażanie zaplanowanej funkcji

Gdy wdrażasz zaplanowaną funkcję, powiązane zadanie harmonogramu i temat Pub/Sub są tworzone automatycznie. Interfejs CLI Firebase wyświetla nazwę tematu, a zadanie i temat możesz wyświetlić w Google Cloud konsoli. Nazwa tematu jest zgodna z tą konwencją:

firebase-scheduled-function_name-region

Przykład:

firebase-scheduled-scheduledFunctionCrontab-us-east1.