Zaplanowane funkcje (1 generacji)

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

Zanim zaczniesz

Funkcje zaplanowane są płatne, ale ogólny koszt powinien być przystępny, ponieważ każde Cloud Schedulerzadanie kosztuje 0, 10 USD miesięcznie, a na każde konto Google przysługują 3 bezpłatne zadania. Skorzystaj z kalkulatora cen Blaze, aby oszacować koszty na podstawie przewidywanego wykorzystania.

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

Pisanie zaplanowanej funkcji

W Cloud Functions for Firebase logika planowania znajduje się w kodzie funkcji i nie ma specjalnych wymagań dotyczących wdrażania. Aby utworzyć funkcję wywoływaną zgodnie z harmonogramem, użyj funkcji functions.pubsub.schedule('your schedule').onRun((context)). Aby na przykład uruchamiać funkcję co 5 minut za pomocą składni App Engine cron.yaml, 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 zarówno składnię Unix Crontab, jak i App Engine. Aby na przykład użyć Crontaba 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ść parametru 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.

Wdrażanie zaplanowanej funkcji

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

firebase-scheduled-function_name-region

Przykład:

firebase-scheduled-scheduledFunctionCrontab-us-east1.