Tutoriel : Utiliser une AWS Step Functions action d'appel dans un pipeline - AWS CodePipeline
Condition préalable : créer ou choisir un pipeline simpleÉtape 1 : Créer l'exemple de machine d'étatÉtape 2 : Ajouter une action d'appel Step Functions à votre pipeline

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.

Tutoriel : Utiliser une AWS Step Functions action d'appel dans un pipeline

Vous pouvez l'utiliser AWS Step Functions pour créer et configurer des machines d'état. Ce didacticiel vous montre comment ajouter une action d'appel à un pipeline qui active les exécutions de machines d'état à partir de votre pipeline.

Important

Dans le cadre de la création d'un pipeline, un compartiment d'artefacts S3 fourni par le client sera utilisé CodePipeline pour les artefacts. (Ceci est différent du compartiment utilisé pour une action source S3.) Si le compartiment d'artefacts S3 se trouve dans un compte différent de celui de votre pipeline, assurez-vous que le compartiment d'artefacts S3 appartient à cette personne sûre et Comptes AWS qu'elle sera fiable.

Dans ce didacticiel, vous effectuez les tâches suivantes :

  • Créez une machine à états standard dans AWS Step Functions.

  • Entrez JSON directement l'entrée de la machine à états. Vous pouvez également télécharger le fichier d'entrée de la machine à états dans un compartiment Amazon Simple Storage Service (Amazon S3).

  • Mettez à jour votre pipeline en ajoutant l'action de la machine d'état.

Condition préalable : créer ou choisir un pipeline simple

Dans ce didacticiel, vous ajoutez une action d'appel à un pipeline existant. Vous pouvez utiliser le pipeline que vous avez créé dans Didacticiel : Création d'un pipeline simple (compartiment S3) ou Tutoriel : Création d'un pipeline simple (CodeCommitréférentiel).

Vous utilisez un pipeline existant avec une action source et au moins une structure en deux étapes, mais vous n'utilisez pas d'artefacts source pour cet exemple.

Note

Vous devrez peut-être mettre à jour le rôle de service utilisé par votre pipeline avec les autorisations supplémentaires requises pour exécuter cette action. Pour ce faire, ouvrez la console AWS Identity and Access Management (IAM), recherchez le rôle, puis ajoutez les autorisations à la politique du rôle. Pour de plus amples informations, veuillez consulter Ajout d'autorisations au rôle de service CodePipeline.

Étape 1 : Créer l'exemple de machine d'état

Dans la console Step Functions, créez une machine à états à l'aide du modèle HelloWorld d'exemple. Pour obtenir des instructions, consultez la section Créer une machine à états dans le guide du AWS Step Functions développeur.

Étape 2 : Ajouter une action d'appel Step Functions à votre pipeline

Ajoutez une action d'appel Step Functions à votre pipeline comme suit :

  1. Connectez-vous à la CodePipeline console AWS Management Console et ouvrez-la à l'adresse http://console.aws.amazon.com/codesuite/codepipeline/home.

    Les noms de tous les pipelines associés à votre AWS compte sont affichés.

  2. Dans Name, choisissez le nom du pipeline que vous souhaitez modifier. Une vue détaillée du pipeline s'affiche alors, laquelle indique notamment l'état de chaque action, dans chaque étape du pipeline.

  3. Sur la page des détails du pipeline, choisissez Edit.

  4. Sur la deuxième étape de votre pipeline simple, choisissez Modifier l’étape. Sélectionnez Delete (Supprimer). Ceci supprime la deuxième étape maintenant que vous n'en avez plus besoin.

  5. Au bas du diagramme, choisissez + Ajouter une étape.

  6. Dans Nom d’étape, saisissez un nom pour l’étape, par exemple Invoke, puis choisissez Ajouter une étape.

  7. Choisissez + Ajouter un groupe d'actions.

  8. Dans Nom de l'action, saisissez un nom, par exemple Invoke.

  9. Dans Action provider, sélectionnez AWS Step Functions. Acceptez la région du pipeline comme Région par défaut.

  10. Dans Artefacts d'entrée, choisissez SourceArtifact.

  11. Dans State machine ARN, choisissez le nom de ressource Amazon (ARN) pour la machine à états que vous avez créée précédemment.

  12. (Facultatif) Dans Préfixe du nom d'exécution, saisissez un préfixe à ajouter à l'ID d'exécution de la machine d'état.

  13. Dans Type d'entrée, choisissez Littéral.

  14. Dans Entrée, entrez l'entrée attendue JSON par la machine à états d'HelloWorldéchantillonnage.

    Note

    L'entrée dans l'exécution de la machine à états est différente du terme utilisé CodePipeline pour décrire les artefacts d'entrée pour les actions.

    Pour cet exemple, entrez ce qui suit JSON :

    {"IsHelloWorldExample": true}

  15. Sélectionnez Exécuté.

  16. Sur l’étape que vous modifiez, choisissez Terminé. Dans le volet AWS CodePipeline , choisissez Enregistrer puis Enregistrer dans le message d'avertissement.

  17. Pour soumettre vos modifications et lancer l'exécution d'un pipeline, choisissez Changement de version, puis Publication.

  18. Une fois votre pipeline terminé, choisissez AWS Step Functions dans votre action d'invocation. Dans la AWS Step Functions console, consultez l'ID d'exécution de votre machine à états. L'ID affiche le nom de votre machine d'état HelloWorld et l'ID d'exécution de la machine d'état avec le préfixe my-prefix.

    arn:aws:states:us-west-2:account-ID:execution:HelloWorld:my-prefix-0d9a0900-3609-4ebc-925e-83d9618fcca1