Utiliser Amazon EventBridge Scheduler pour démarrer l'exécution d'une machine à états Step Functions - AWS Step Functions
Configurer le rôle d'exécutionCréer une planificationRessources connexes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utiliser Amazon EventBridge Scheduler pour démarrer l'exécution d'une machine à états Step Functions

Amazon EventBridge Scheduler est un planificateur sans serveur qui vous permet de créer, d'exécuter et de gérer des tâches à partir d'un service géré centralisé. Avec EventBridge Scheduler, vous pouvez créer des plannings à l'aide d'expressions cron et rate pour les modèles récurrents, ou configurer des appels ponctuels. Vous pouvez configurer des fenêtres temporelles flexibles pour la livraison, définir des limites de nouvelles tentatives et définir la durée de rétention maximale API en cas d'échec des appels.

Par exemple, avec EventBridge Scheduler, vous pouvez démarrer l'exécution d'une machine à états selon un calendrier lorsqu'un événement lié à la sécurité se produit ou pour automatiser une tâche de traitement de données.

Cette page explique comment utiliser le EventBridge Scheduler pour démarrer l'exécution d'une machine d'état Step Functions selon un calendrier.

Configurer le rôle d'exécution

Lorsque vous créez un nouveau calendrier, le EventBridge planificateur doit être autorisé à appeler son API opération cible en votre nom. Vous accordez ces autorisations au EventBridge Scheduler à l'aide d'un rôle d'exécution. La politique d'autorisation que vous associez au rôle d'exécution de votre planification définit les autorisations requises. Ces autorisations dépendent de la cible que API vous souhaitez que EventBridge Scheduler appelle.

Lorsque vous utilisez la console du EventBridge planificateur pour créer un calendrier, comme dans la procédure suivante, le EventBridge planificateur définit automatiquement un rôle d'exécution en fonction de la cible que vous avez sélectionnée. Si vous souhaitez créer un calendrier à l'aide de l'un des EventBridge planificateursSDKs, le ou AWS CLI AWS CloudFormation, vous devez disposer d'un rôle d'exécution existant qui accorde les autorisations dont le EventBridge planificateur a besoin pour appeler une cible. Pour plus d'informations sur la configuration manuelle d'un rôle d'exécution pour votre calendrier, consultez la section Configuration d'un rôle d'exécution dans le guide de l'utilisateur du EventBridge planificateur.

Créer une planification

Pour créer une planification à l'aide de la console

  1. Ouvrez la console Amazon EventBridge Scheduler à https://console.aws.amazon.com/scheduler/ la maison.

  2. Sur la page Planifications, choisissez Créer une planification.

  3. Sur la page Spécifier le détail de la planification, dans la section Nom et description de la planification, procédez comme suit :

    1. Pour Nom de la planification, saisissez un nom à attribuer à votre planification. Par exemple, MyTestSchedule.

    2. (Facultatif) Dans le champ Description, saisissez une description de la planification. Par exemple, My first schedule.

    3. Pour Groupe de planifications, choisissez un groupe de planifications dans la liste déroulante. Si vous n'avez pas de groupe, choisissez par défaut. Pour créer un groupe de planifications, choisissez Crée votre propre planification.

      Vous utilisez des groupes de planifications pour leur ajouter des balises.

    1. Choisissez vos options de planification.

      Occurrence Faites ceci...

      Planification ponctuelle

      Une planification ponctuelle n'invoque un objectif qu'une seule fois à la date et à l'heure que vous indiquez.

      Pour Date et heure, procédez comme suit :

      • Entrez une date valide au format YYYY/MM/DD.

      • Entrez un horodatage au format hh:mm de 24 heures.

      • Dans le champ Fuseau horaire, choisissez le fuseau horaire.

      Planification récurrente

      Une planification récurrente invoque un objectif à un taux que vous spécifiez à l'aide d'une expression cron ou d'une expression rate.

      1. Pour Schedule type (Planifier le type), effectuez l'une des étapes suivantes :

      2. Pour Fenêtre temporelle flexible, choisissez Désactivé pour désactiver cette option ou choisir l'une des fenêtres temporelles prédéfinies. Par exemple, si vous choisissez15 minutes et que vous définissez une planification récurrente pour invoquer son objectif une fois par heure, la planification s'exécute dans les 15 minutes suivant le début de chaque heure.

  5. (Facultatif) Si vous avez choisi Planification récurrente à l'étape précédente, dans la section Délai, procédez comme suit :

    1. Dans le champ Fuseau horaire, choisissez un fuseau horaire.

    2. Pour Date et heure de début, entrez une date valide au format YYYY/MM/DD, puis spécifiez un horodatage au format hh:mm de 24 heures.

    3. Pour Date et heure de fin, entrez une date valide au format YYYY/MM/DD, puis spécifiez un horodatage au format hh:mm de 24 heures.

  6. Choisissez Suivant.

  7. Sur la page Sélectionner une cible, choisissez l' AWS APIopération invoquée par le EventBridge planificateur :

    1. Choisissez AWS Step Functions StartExecution.

    2. Dans la StartExecutionsection, sélectionnez une machine à états ou choisissez Créer une nouvelle machine à états.

      À l'heure actuelle, vous ne pouvez pas exécuter de flux de travail Synchrous Express de manière planifiée.

    3. Entrez une JSON charge utile pour l'exécution. Même si votre machine à états ne nécessite aucune JSON charge utile, vous devez toujours inclure les entrées JSON au format indiqué dans l'exemple suivant.

      {
    "Comment": "sampleJSONData"
}

  8. Choisissez Suivant.

  9. Sur la page Settings (Paramètres), procédez comme suit :

    1. Pour activer la planification, sous État de la planification, activez Activer la planification.

    2. Pour configurer une politique de nouvelles tentatives pour votre calendrier, sous Politique de nouvelles tentatives et file d'attente de lettres mortes (DLQ), procédez comme suit :

      • Activez Réessayer.

      • Pour Âge maximal de l'événement, entrez le nombre maximum d'heures et de minutes pendant lequel le EventBridge planificateur doit conserver un événement non traité.

      • La durée maximale est 24 heures.

      • Pour Nombre maximum de tentatives, entrez le nombre maximum de fois que le EventBridge planificateur réessaie le calendrier si la cible renvoie une erreur.

        La valeur maximale est 185 nouvelles tentatives.

      Avec les politiques de nouvelle tentative, si un calendrier ne parvient pas à invoquer sa cible, le EventBridge planificateur le réexécute. Si elle est configurée, vous devez définir la durée de rétention maximale et les nouvelles tentatives pour la planification.

    3. Choisissez l'endroit où EventBridge Scheduler stocke les événements non livrés.

      Option file d'attente de lettres mortes () DLQ Faites ceci...
      Ne stockez pas Sélectionnez Aucun.
      Enregistrez l'événement dans le même Compte AWS endroit où vous créez le calendrier

      1. Choisissez Select an Amazon SQS queue dans my Compte AWS as DLQ a.

      2. Choisissez le nom de ressource Amazon (ARN) de la SQS file d'attente Amazon.

      Stockez l'événement dans un endroit Compte AWS différent de celui dans lequel vous créez le calendrier

      1. Choisissez Spécifier une SQS file d'attente Amazon dans un autre en Comptes AWS tant que DLQ.

      2. Entrez le nom de ressource Amazon (ARN) de la SQS file d'attente Amazon.

    4. Pour utiliser une clé gérée par le client afin de chiffrer votre entrée cible, sous Chiffrement, choisissez Personnaliser les paramètres de chiffrement (avancé).

      Si vous choisissez cette option, entrez une KMS clé existante ARN ou choisissez Create an AWS KMS key pour accéder à la AWS KMS console. Pour plus d'informations sur la manière dont EventBridge Scheduler chiffre vos données au repos, consultez la section Chiffrement au repos dans le guide de l'utilisateur d'Amazon EventBridge Scheduler.

    5. Pour que le EventBridge planificateur crée un nouveau rôle d'exécution pour vous, choisissez Créer un nouveau rôle pour ce calendrier. Ensuite, saisissez un nom pour Nom du rôle. Si vous choisissez cette option, le EventBridge planificateur associe au rôle les autorisations requises pour votre cible modélisée.

  10. Choisissez Suivant.

  11. Sur la page Examiner et créer une planification, examinez les détails de votre planification. Dans chaque section, choisissez Modifier pour revenir à cette étape et modifier ses détails.

  12. Choisissez Créer une planification.

    Vous pouvez consulter la liste de vos planifications nouvelles et existantes sur la page Planifications. Sous la colonne État, vérifiez que votre nouvelle planification est activée.

Pour confirmer que EventBridge Scheduler a invoqué la machine à états, consultez les journaux Amazon CloudWatch de la machine à états.

Pour plus d'informations sur le EventBridge planificateur, consultez les rubriques suivantes :