Функции расписания

Если вы хотите запланировать выполнение функций в указанное время, используйте обработчик onSchedule предоставляемый firebase-functions/v2/scheduler . Эти функции используют Cloud Scheduler для вызова логики функций в заданное вами время или с заданными интервалами.

Прежде чем начать

Хотя запланированные функции оплачиваются отдельно, общая стоимость, как правило, приемлема, поскольку каждое задание Cloud Scheduler стоит 0,10 доллара США в месяц, и на один аккаунт Google можно бесплатно выполнить до трех заданий. Используйте калькулятор цен Blaze, чтобы рассчитать примерную стоимость на основе предполагаемого использования.

Для вашего проекта необходимо включить API Cloud Scheduler . В большинстве проектов Firebase он уже должен быть включен; вы можете проверить это в консоли Google Cloud .

Напишите запланированную функцию

В Cloud Functions for Firebase логика планирования находится в коде ваших функций, и для ее развертывания не требуется никаких специальных условий. Например, чтобы ежедневно удалять неактивные учетные записи пользователей, вы можете написать функцию, начинающуюся со следующих операторов импорта:

Node.js 

// The Cloud Functions for Firebase SDK to set up triggers and logging.
const {onSchedule} = require("firebase-functions/scheduler");
const {logger} = require("firebase-functions");

// The Firebase Admin SDK to delete inactive users.
const admin = require("firebase-admin");
admin.initializeApp();

// The es6-promise-pool to limit the concurrency of promises.
const PromisePool = require("es6-promise-pool").default;
// Maximum concurrent account deletions.
const MAX_CONCURRENT = 3;
index.js

Python 

# The Cloud Functions for Firebase SDK to set up triggers and logging.
from firebase_functions import scheduler_fn

# The Firebase Admin SDK to delete users.
import firebase_admin
from firebase_admin import auth

firebase_admin.initialize_app()
main.py

Затем вы можете использовать onSchedule для запуска задачи Cloud Scheduler :

Node.js 

// Run once a day at midnight, to clean up the users
// Manually run the task here https://console.cloud.google.com/cloudscheduler
exports.accountcleanup = onSchedule("every day 00:00", async (event) => {
  // Fetch all user details.
  const inactiveUsers = await getInactiveUsers();

  // Use a pool so that we delete maximum `MAX_CONCURRENT` users in parallel.
  const promisePool = new PromisePool(
      () => deleteInactiveUser(inactiveUsers),
      MAX_CONCURRENT,
  );
  await promisePool.start();

  logger.log("User cleanup finished");
});
index.js

Python 

# Run once a day at midnight, to clean up inactive users.
# Manually run the task here https://console.cloud.google.com/cloudscheduler
@scheduler_fn.on_schedule(schedule="every day 00:00")
def accountcleanup(event: scheduler_fn.ScheduledEvent) -> None:
    """Delete users who've been inactive for 30 days or more."""
    user_page: auth.ListUsersPage | None = auth.list_users()
    while user_page is not None:
        inactive_uids = [
            user.uid for user in user_page.users if is_inactive(user, timedelta(days=30))
        ]
        auth.delete_users(inactive_uids)
        user_page = user_page.get_next_page()
main.py

Cloud Scheduler поддерживает как синтаксис Unix Crontab, так и синтаксис App Engine . Например, чтобы использовать Crontab, выполните следующие действия:

Node.js 

exports.scheduledFunctionCrontab = onSchedule("5 11 * * *", async (event) => {
  // ...
});

Python 

@scheduler_fn.on_schedule(schedule="5 11 * * *")

Развернуть запланированную функцию

При развертывании запланированной функции автоматически создаются задание планировщика и HTTP-функция. Firebase CLI выводит имя функции, и вы можете просмотреть задание и функцию в консоли Google Cloud . Название топика формируется в соответствии со следующим соглашением:

firebase-schedule- function_name - region

Например:

firebase-schedule-accountcleanup-us-east1.

В запланированное время учетная запись вычислительной службы по умолчанию вызывает соответствующую HTTP-функцию. Это означает, что только связанное с ней задание Cloud Scheduler имеет разрешение на выполнение этой функции.