Le Déclencheur de planification vous permet d'exécuter votre intégration périodiquement à des intervalles de temps spécifiques. Ce déclencheur est utile lorsque vous souhaitez exécuter automatiquement votre intégration sans aucune intervention manuelle. Par exemple, vous pouvez envisager d'utiliser le déclencheur de planification pour les types de tâches suivants :
- Importer des fichiers d'un système vers un autre système à intervalles réguliers
- Envoyer des rappels périodiques par e-mail
- Synchroniser la base de données à intervalles réguliers
Avant de commencer
Assurez-vous d'attribuer le rôle IAM Demandeur d'intégrations Apigee à l'agent de service Apigee (
service-PROJECT_ID
@gcp-sa-apigee.iam.gserviceaccount.com
) dans votre projet Google Cloud.
Pour en savoir plus sur l'attribution des rôles IAM, consultez la page Gérer les accès dans Google Cloud.
Ajouter un déclencheur de planification
Pour ajouter un déclencheur de planification à une intégration nouvelle ou existante, procédez comme suit :- Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
- Cliquez sur Développer > Intégrations.
- Sélectionnez une intégration existante ou créez-en une en cliquant sur Créer une intégration.
Si vous créez une intégration :
- Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
- Dans la liste des régions compatibles, sélectionnez une région pour l'intégration.
- Cliquez sur Créer.
La page de conception d'intégration s'affiche.
- Dans la barre de navigation de la page de conception d'intégration, cliquez sur +Ajouter une tâche ou un déclencheur > Déclencheurs pour afficher la liste des déclencheurs disponibles.
- Cliquez sur l'élément Déclencheur de planification et placez-le dans le concepteur.
Configurer un déclencheur de planification
Cliquez sur l'élément Déclencheur de planification dans l'éditeur d'intégrations pour afficher le volet de configuration du déclencheur.
Vous pouvez configurer le déclencheur de programmation à l'aide de l'un des modes suivants :
- Basique : fournit une interface utilisateur pour configurer la fréquence d'exécution.
- Avancé : utilise une expression Cron pour configurer la fréquence d'exécution.
En mode De base, vous pouvez choisir d'exécuter l'intégration à une heure spécifique ou à intervalles horaires. Si vous souhaitez exécuter l'intégration à une heure spécifique, sélectionnez l'option Exécuter à une heure spécifique dans le menu déroulant Heures, puis définissez les propriétés suivantes :
- Time : heure (au format 24 heures) à laquelle l'intégration doit s'exécuter.
- Days : jours où l'intégration doit être exécutée. Vous pouvez choisir d'exécuter l'intégration tous les jours, certains jours de la semaine, un jour spécifique du mois, etc.
- Months : le ou les mois dans lesquels l'intégration doit être exécutée. Vous pouvez exécuter l'intégration tous les mois ou choisir des mois spécifiques.
En mode Avancé, vous pouvez spécifier la fréquence d'exécution à l'aide d'une expression Cron. L'expression Cron comporte cinq valeurs qui doivent être spécifiées dans l'ordre suivant :
- minute (0-59)
- heure (0-23)
- jour du mois (1-31)
- mois, exprimé en l'une des valeurs suivantes :
- Numéro 1-12
- Une abréviation de trois lettres correspondant à un mois (par exemple, Jan, feb (February, février), Mar, etc.)
- Jour de la semaine, exprimé en l'une des valeurs suivantes :
- Nombre compris entre 0 et 6, commençant par dimanche en tant que 0
- Code à trois lettres pour le jour (par exemple, mon (Monday, lundi), tue (Tuesday, mardi), wed (Wednesday, mercredi, etc.)
Par exemple, pour exécuter l'intégration le premier jour de chaque mois, utilisez l'expression Cron * * 1 * *
Bonnes pratiques
Nous vous recommandons de désactiver l'option Déclencheurs de planification lorsqu'ils ne sont plus nécessaires. Si vous laissez un déclencheur de planification redondant actif, il continuera de déclencher automatiquement l'intégration.
Pour désactiver un déclencheur de planification, vous pouvez effectuer l'une des opérations suivantes :
- Annulez la publication de l'intégration contenant le Déclencheur de planification. Votre intégration n'est alors plus active et le déclencheur n'est pas exécuté.
- Remplacez le déclencheur de planification par un autre déclencheur et publiez à nouveau l'intégration. La version active et republiée de l'intégration n'utilisera pas le déclencheur de planification.
- Supprimez la version actuelle de l'intégration. Vous trouverez l'option Supprimer sous la liste des versions, à côté du nom de l'intégration.