Planifier des fonctions (1re génération)

Si vous souhaitez planifier l'exécution de fonctions à des heures spécifiées, utilisez le gestionnaire onSchedule pour créer un sujet Pub/Sub qui utilise Cloud Scheduler pour déclencher des événements sur ce sujet.

Avant de commencer

Bien que les fonctions programmées soient facturées, le coût global reste gérable, car chaque tâche Cloud Scheduler coûte 0,10 $ par mois et vous pouvez exécuter trois tâches sans frais par compte Google. Utilisez le simulateur de coût Blaze pour générer une estimation des coûts en fonction de votre utilisation prévue.

Les API Pub/Sub et Cloud Scheduler doivent être activées pour votre projet. Elles devraient déjà être activées pour la plupart des projets Firebase. Vous pouvez le vérifier dans la console Google Cloud.

Écrire une fonction planifiée

Dans Cloud Functions for Firebase, la logique de planification réside dans le code de vos fonctions, sans exigences particulières au moment du déploiement. Pour créer une fonction planifiée, utilisez functions.pubsub.schedule('your schedule').onRun((context)). Par exemple, pour exécuter une fonction toutes les cinq minutes avec la syntaxe App Engine cron.yaml, procédez comme suit :

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

Cloud Scheduler accepte les syntaxes Unix Crontab et App Engine. Par exemple, pour utiliser Crontab afin de sélectionner un fuseau horaire spécifique dans lequel exécuter une fonction planifiée, procédez comme suit :

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

La valeur de timeZone doit être un nom de fuseau horaire issu de la base de données tz. Pour en savoir plus sur les propriétés compatibles, consultez la documentation de référence sur Cloud Scheduler.

Déployer une fonction planifiée

Lorsque vous déployez une fonction planifiée, le job de planificateur et le sujet Pub/Sub associés sont créés automatiquement. La CLI Firebase renvoie le nom du sujet, et vous pouvez afficher le job et le sujet dans la console Google Cloud. Le sujet est nommé selon la convention suivante :

firebase-scheduled-function_name-region

Exemple :

firebase-scheduled-scheduledFunctionCrontab-us-east1.