Если вы хотите запланировать запуск функций в определенное время, используйте обработчик onSchedule
, чтобы создать тему Pub/Sub , которая использует Cloud Scheduler для запуска событий по этой теме.
Прежде чем начать
Чтобы использовать это решение в своем проекте Firebase, ваш проект должен находиться в тарифном плане Blaze. Если его еще нет в плане Blaze, обновите свой тарифный план .
Хотя выставление счетов требуется, вы можете рассчитывать на то, что общая стоимость будет управляемой, поскольку каждое задание Cloud Scheduler стоит 0,10 доллара США в месяц, и на одну учетную запись Google разрешено три задания бесплатно. Воспользуйтесь калькулятором цен Blaze, чтобы рассчитать стоимость на основе прогнозируемого использования.
API Pub/Sub и Cloud Scheduler должны быть включены для вашего проекта. Они уже должны быть включены для большинства проектов Firebase; вы можете проверить в консоли Google Cloud .
Напишите запланированную функцию
В Cloud Functions for Firebase логика планирования находится в коде ваших функций без каких-либо особых требований ко времени развертывания. Чтобы создать запланированную функцию, используйте functions.pubsub.schedule('your schedule').onRun((context))
. Например, чтобы запускать функцию каждые пять минут с помощью синтаксиса cron.yaml App Engine , сделайте следующее:
exports.scheduledFunction = functions.pubsub.schedule('every 5 minutes').onRun((context) => {
console.log('This will be run every 5 minutes!');
return null;
});
Синтаксис Unix Crontab и App Engine поддерживается Cloud Scheduler . Например, чтобы использовать 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 отображает имя темы, и вы можете просмотреть задание и тему в консоли Google Cloud . Тема названа в соответствии со следующим соглашением:
firebase-scheduled- function_name - region
Например:
firebase-scheduled-scheduledFunctionCrontab-us-east1.
, Если вы хотите запланировать запуск функций в определенное время, используйте обработчик onSchedule
, чтобы создать тему Pub/Sub , которая использует Cloud Scheduler для запуска событий по этой теме.
Прежде чем начать
Чтобы использовать это решение в своем проекте Firebase, ваш проект должен находиться в тарифном плане Blaze. Если его еще нет в плане Blaze, обновите свой тарифный план .
Хотя выставление счетов требуется, вы можете рассчитывать на то, что общая стоимость будет управляемой, поскольку каждое задание Cloud Scheduler стоит 0,10 доллара США в месяц, и на одну учетную запись Google разрешено три задания бесплатно. Воспользуйтесь калькулятором цен Blaze, чтобы составить смету расходов на основе прогнозируемого использования.
API-интерфейсы Pub/Sub и Cloud Scheduler должны быть включены для вашего проекта. Они уже должны быть включены для большинства проектов Firebase; вы можете проверить в консоли Google Cloud .
Напишите запланированную функцию
В Cloud Functions for Firebase логика планирования находится в коде ваших функций без каких-либо особых требований ко времени развертывания. Чтобы создать запланированную функцию, используйте functions.pubsub.schedule('your schedule').onRun((context))
. Например, чтобы запускать функцию каждые пять минут с помощью синтаксиса cron.yaml App Engine , сделайте следующее:
exports.scheduledFunction = functions.pubsub.schedule('every 5 minutes').onRun((context) => {
console.log('This will be run every 5 minutes!');
return null;
});
Синтаксис Unix Crontab и App Engine поддерживается Cloud Scheduler . Например, чтобы использовать 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 отображает имя темы, и вы можете просмотреть задание и тему в консоли Google Cloud . Тема названа в соответствии со следующим соглашением:
firebase-scheduled- function_name - region
Например:
firebase-scheduled-scheduledFunctionCrontab-us-east1.