Tutoriel : créer un pipeline qui exécute des commandes avec compute - AWS CodePipeline
PrérequisÉtape 1 : créer des fichiers source et les transférer vers votre GitHub dépôtÉtape 2 : Créer votre pipeline Étape 3 : Exécutez votre pipeline et vérifiez les commandes de construction

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 : créer un pipeline qui exécute des commandes avec compute

Dans ce didacticiel, vous allez configurer un pipeline qui exécute en continu les commandes de génération fournies à l'aide de l'action Commandes dans une phase de génération. Pour plus d'informations sur l'action Commandes, consultezRéférence d'action des commandes.

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 Comptes AWS à une personne sûre et fiable.

Prérequis

Vous devez déjà disposer des éléments suivants :

Étape 1 : créer des fichiers source et les transférer vers votre GitHub dépôt

Dans cette section, vous allez créer et transférer vos exemples de fichiers source vers le référentiel que le pipeline utilise pour votre étape source. Dans cet exemple, vous produisez et publiez ce qui suit :

  • Un fichier README.txt.

Pour créer des fichiers source

  1. Créez un fichier avec le texte suivant :

    Sample readme file

  2. Enregistrez le fichier sous le nom README.txt.

Pour transférer des fichiers vers votre GitHub dépôt

  1. Poussez ou chargez les fichiers dans votre référentiel . Ces fichiers constituent l'artefact source créé par l'assistant Create Pipeline (Création de pipeline) pour votre action de déploiement dans AWS CodePipeline. Vos fichiers doivent être similaires à ce qui suit dans votre répertoire local :

    README.txt

  2. Pour utiliser la ligne de commande Git à partir d'un référentiel cloné sur votre ordinateur local :

    1. Exécutez la commande suivante pour organiser tous vos fichiers à la fois :

      git add -A

    2. Exécutez la commande suivante pour valider les fichiers avec un message de validation.

      git commit -m "Added source files"

    3. Exécutez la commande suivante pour publier les fichiers depuis votre référentiel local vers votre référentiel  :

      git push

Étape 2 : Créer votre pipeline

Dans cette section, vous créez un pipeline avec les actions suivantes :

  • Un stage source avec une action GitHub (version 2) pour le référentiel dans lequel les fichiers source sont stockés.

  • Une phase de construction avec l'action Commandes.

Pour créer un pipeline avec l'assistant

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

  2. Sur la page Bienvenue, la page Démarrez ou la page Pipelines, choisissez Créer un pipeline.

  3. Dans l'Étape 1 : Choisir les paramètres d'un pipeline, dans Nom du pipeline, saisissez MyCommandsPipeline.

  4. Le seul type de pipeline que vous pouvez choisir dans la console est le V2. Pour de plus amples informations, veuillez consulter Types de canalisations.

  5. Dans Rôle de service, choisissez Nouveau rôle de service CodePipeline pour autoriser la création d'un rôle de service dansIAM.

    Note

    Si vous utilisez un rôle de service existant, pour utiliser l'action Commandes, vous devez ajouter les autorisations suivantes pour le rôle de service. Réduisez les autorisations au niveau des ressources du pipeline en utilisant les autorisations basées sur les ressources dans la déclaration de politique relative aux rôles de service. Pour plus d'informations, consultez l'exemple de stratégie dansAutorisations relatives aux politiques de rôle de service.

    • journaux : CreateLogGroup

    • journaux : CreateLogStream

    • journaux : PutLogEvents

  6. Laissez les paramètres sous Advanced settings (Paramètres avancés) à leurs valeurs par défaut, puis choisissez Suivant.

  7. Dans Étape 2 : Ajouter une étape source, dans Fournisseur de source, choisissez AWS CodeCommit. Dans Nom du référentiel, choisissez le nom du CodeCommit référentiel dans lequel vous l'avez crééÉtape 1 : Création d'un CodeCommit référentiel. Dans Nom de branche, choisissez le nom de la branche qui contient votre dernière mise à jour du code.

    Après avoir sélectionné le nom du référentiel et la branche, un message indique la règle Amazon CloudWatch Events à créer pour ce pipeline.

    Choisissez Suivant.

  8. À l'étape 3 : Ajouter une phase de construction, sélectionnez Commandes.

    Note

    L'exécution de l'action Commandes entraînera des frais distincts. AWS CodeBuild

    Entrez la commande suivante : 

    ls
echo hello world
cat README.txt
echo pipeline Execution Id is #{codepipeline.PipelineExecutionId}

    Choisissez Suivant.

    Étape 3 : page de création d'un nouveau pipeline avec l'action Commandes

  9. Choisissez d'ignorer l'étape Déploiement.

    Choisissez Suivant.

  10. Dans Step 5: Review, vérifiez les informations puis choisissez Create pipeline.

  11. Pour terminer la création de votre action, ajoutez une variable d'environnement à l'action qui produira une variable de sortie pour l'action. Dans l'action Commandes, choisissez Modifier. Sur l'écran d'édition, spécifiez un espace de noms variable pour votre action en le saisissant compute dans le champ Espace de noms variable.

    Ajoutez la variable CodeBuild de sortieAWS_Default_Region, puis choisissez Ajouter une variable.

    La page d'édition pour l'action Commandes

Étape 3 : Exécutez votre pipeline et vérifiez les commandes de construction

Apportez une modification pour exécuter votre pipeline. Vérifiez que les commandes de génération ont été exécutées en consultant l'historique d'exécution, les journaux de génération et les variables de sortie.

Pour afficher les journaux d'actions et les variables de sortie

  1. Une fois le pipeline exécuté avec succès, vous pouvez consulter les journaux et les résultats de l'action.

  2. Pour afficher les variables de sortie de l'action, choisissez Historique, puis Chronologie.

    Affichez la variable de sortie qui a été ajoutée à l'action. La sortie de l'action Commandes indique la variable de sortie résolue pour l'action Région.

    La sortie de l'action Commandes indiquant la variable de sortie résolue en action Region

  3. Pour consulter les journaux de l'action, choisissez Afficher les détails de l'action Commandes réussie. Consultez les journaux de l'action Commandes.

    Exemples de journaux pour l'action Commandes