Conditions préalables Étape 1 : Créez des fichiers sources et transférez-les vers votre GitHub référentiel Étape 2 : Créer votre pipeline Étape 3 : Exécutez votre pipeline et vérifiez les commandes de construction

Tutoriel : Création d'un pipeline qui exécute des commandes avec compute (type V2)

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 au cours d'une phase de génération. Pour plus d'informations sur l'action Commandes, consultezRéférence des actions des commandes.

Important

Dans le cadre de la création d'un pipeline, un compartiment d'artefacts S3 fourni par le client sera utilisé par CodePipeline les artefacts. (Ce compartiment 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 société sûre et fiable.

Conditions préalables

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

Un GitHub référentiel. Vous pouvez utiliser le GitHub référentiel que vous avez créé dansTutoriel : Utiliser un clone complet avec une source de GitHub pipeline.

Étape 1 : Créez des fichiers sources et transférez-les vers votre GitHub référentiel

Dans cette section, vous allez créer et envoyer vos exemples de fichiers source vers le référentiel que le pipeline utilise pour votre stage source. Pour cet exemple, vous produisez et envoyez les éléments suivants :

Un fichier README.txt.

Pour créer des fichiers source

Créez un fichier contenant le texte suivant :
```
Sample readme file
```
Enregistrez le fichier sous le nom README.txt.

Pour transférer des fichiers vers votre GitHub référentiel

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
```
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 :

Une étape source avec une action GitHub (via GitHub App) pour le référentiel dans lequel les fichiers sources sont stockés.
Une étape de construction avec l'action Commandes.

Pour créer un pipeline avec l'assistant

Connectez-vous à Console de gestion AWS et ouvrez la CodePipeline console à l'adresse http://console.aws.amazon.com/codesuite/codepipeline/home.
Sur la page Bienvenue, la page Démarrez ou la page Pipelines, choisissez Créer un pipeline.
Sur la page Étape 1 : Choisissez l'option de création, sous Options de création, choisissez l'option Créer un pipeline personnalisé. Choisissez Suivant.
À l'étape 2 : choisissez les paramètres du pipeline, dans Nom du pipeline, entrezMyCommandsPipeline.
CodePipeline fournit des pipelines de type V1 et V2, dont les caractéristiques et le prix diffèrent. Le type V2 est le seul que vous pouvez choisir dans la console. Pour plus d’informations, consultez types de pipeline. Pour plus d'informations sur la tarification de CodePipeline, consultez la section Tarification.
Dans Rôle de service, choisissez Nouveau rôle de service pour permettre CodePipeline de créer un rôle de service dans IAM.
Note
Si vous utilisez un rôle de service existant, pour utiliser l'action Commandes, vous devez ajouter les autorisations suivantes pour ce rôle de service. Réduisez les autorisations au niveau des ressources du pipeline en utilisant des autorisations basées sur les ressources dans la déclaration de politique des rôles de service. Pour plus d'informations, consultez l'exemple de politique dansAutorisations relatives aux politiques de rôle de service.
- journaux : CreateLogGroup
- journaux : CreateLogStream
- journaux : PutLogEvents
Laissez les paramètres sous Advanced settings (Paramètres avancés) à leurs valeurs par défaut, puis choisissez Suivant.
Sur la page Étape 3 : Ajouter une étape source, ajoutez une étape source :
1. Dans Source provider, choisissez GitHub (via GitHub App).
2. Sous Connexion, choisissez une connexion existante ou créez-en une nouvelle. Pour créer ou gérer une connexion pour votre action GitHub source, consultezGitHub connexions.
3. Dans Nom du référentiel, choisissez le nom de votre référentiel GitHub.com .
4. Dans Branche par défaut, choisissez la branche que vous souhaitez spécifier lorsque le pipeline est démarré manuellement ou avec un événement source qui n'est pas une balise Git. Si la source de la modification n'est pas le déclencheur ou si l'exécution d'un pipeline a été démarrée manuellement, la modification utilisée sera le commit HEAD de la branche par défaut. En option, vous pouvez également spécifier des webhooks avec filtrage (déclencheurs). Pour de plus amples informations, veuillez consulter Automatisez le démarrage des pipelines en utilisant des déclencheurs et des filtres.
Choisissez Suivant.
À l'étape 4 : Ajouter une étape de construction, choisissez Commandes.

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

Entrez la commande suivante :
```
ls
echo hello world
cat README.txt
echo pipeline Execution Id is #{codepipeline.PipelineExecutionId}
```
Choisissez Suivant.
À l'étape 5 : Ajouter une phase de test, choisissez Ignorer la phase de test, puis acceptez le message d'avertissement en choisissant de nouveau Ignorer.

Choisissez Suivant.
À l'étape 6 : Ajouter une phase de déploiement, choisissez Ignorer l'étape de déploiement, puis acceptez le message d'avertissement en choisissant de nouveau Ignorer.

Choisissez Suivant.
À l'étape 7 : Passez en revue, passez en revue les informations, puis choisissez Créer un pipeline.
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.

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

Publiez 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 des exécutions, les journaux de génération et les variables de sortie.

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

Une fois le pipeline exécuté avec succès, vous pouvez consulter les journaux et les résultats de l'action.
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 dans la région de l'action.
Pour afficher les journaux de l'action, choisissez Afficher les détails de l'action Commandes réussie. Consultez les journaux de l'action Commandes.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.