Didacticiel : Création d'un pipeline simple (référentiel CodeCommit)

Pour créer un CodeCommit référentiel

1. Ouvrez la CodeCommit console à l'adresse https://console.aws.amazon.com/codecommit/.

2. Dans le sélecteur de région, choisissez l' Région AWS endroit où vous souhaitez créer le référentiel et le pipeline. Pour plus d’informations, consultez Régions AWS and Endpoints.

3. Dans la page Référentiels, choisissez Créer un référentiel.

4. Sur la page Créer un référentiel, pour Nom du référentiel, entrez un nom pour votre référentiel (par exemple, MyDemoRepo).

5. Sélectionnez Create (Créer).

Pour configurer un référentiel local

Au cours de cette étape, vous configurez un référentiel local pour vous connecter à votre référentiel CodeCommit distant.

1. Une fois votre nouveau référentiel ouvert dans la console, choisissez Clone URL (URL du clone) en haut à droite de la page, puis Clone SSH (Cloner SSH). L'adresse pour cloner votre référentiel Git est copiée dans votre presse-papiers.

2. Dans votre terminal ou votre ligne de commande, accédez à un répertoire local dans lequel vous souhaitez que votre référentiel local soit stocké. Dans ce didacticiel, nous utilisons /tmp.

3. Exécutez la commande suivante pour cloner le référentiel, en remplaçant l'adresse SSH par celle que vous avez copiée à l'étape précédente. Cette commande crée un répertoire appelé MyDemoRepo. Vous copiez un exemple d'application dans ce répertoire.

   git clone ssh://git-codecommit.us-west-2.amazonaws.com/v1/repos/MyDemoRepo

1. Ensuite, téléchargez un exemple et enregistrez-le dans un dossier ou un répertoire sur votre ordinateur local.

   1. Choisissez l'une des options suivantes. Choisissez SampleApp_Linux.zip si vous souhaitez suivre les étapes de ce didacticiel pour les instances Linux.

      • Si vous souhaitez effectuer un déploiement sur des instances Amazon Linux à l'aide de CodeDeploy, téléchargez l'exemple d'application ici : SampleApp_Linux.zip.

      • Si vous souhaitez effectuer un déploiement sur des instances Windows Server à l'aide de CodeDeploy, téléchargez l'exemple d'application ici : SampleApp_Windows.zip.

      L'exemple d'application contient les fichiers suivants à déployer avec CodeDeploy :

      • appspec.yml— Le fichier de spécification de l'application (AppSpecfichier) est un fichier au format YAML utilisé CodeDeploy pour gérer un déploiement. Pour plus d'informations sur le AppSpec fichier, reportez-vous à la section Référence CodeDeploy AppSpec du fichier dans le Guide de AWS CodeDeploy l'utilisateur.

      • index.html— Le fichier d'index contient la page d'accueil de l'exemple d'application déployé.

      • LICENSE.txt— Le fichier de licence contient les informations de licence de l'exemple d'application.

      • Fichiers pour scripts : l'exemple d'application utilise des scripts pour écrire des fichiers texte dans un emplacement de votre instance. Un fichier est écrit pour chacun des événements du cycle de vie du CodeDeploy déploiement, comme suit :

        • scriptsDossier (exemple Linux uniquement) : le dossier contient les scripts shell suivants pour installer les dépendances et démarrer et arrêter l'exemple d'application pour le déploiement automatique :install_dependencies,start_server, etstop_server.

        • (Exemple Windows uniquement) before-install.bat — Il s'agit d'un script batch pour l'événement du cycle de vie du BeforeInstall déploiement, qui sera exécuté pour supprimer les anciens fichiers écrits lors des déploiements précédents de cet exemple et créer un emplacement sur votre instance où écrire les nouveaux fichiers.

   2. Téléchargez le fichier compressé (zippé).

2. Décompressez les fichiers de SampleApp_Linux.zip dans le répertoire local que vous avez créé précédemment (par exemple, /tmp/MyDemoRepo ouc:\temp\MyDemoRepo).

   Veillez à placer les fichiers directement dans votre répertoire local. N'incluez pas un dossier SampleApp_Linux. Sur votre machine Linux, macOS ou Unix locale, par exemple, votre hiérarchie de répertoires et de fichiers doit ressembler à ceci :

   /tmp
      └-- MyDemoRepo
          │-- appspec.yml
          │-- index.html
          │-- LICENSE.txt
          └-- scripts
              │-- install_dependencies
              │-- start_server
              └-- stop_server

3. Pour télécharger des fichiers dans votre dépôt, appliquez l'une des méthodes suivantes.

   1. Pour télécharger vos fichiers à l' CodeCommit aide de la console, procédez comme suit :

      1. Ouvrez la CodeCommit console et choisissez votre dépôt dans la liste des référentiels.

      2. Choisissez Ajouter un fichier, puis choisissez Charger le fichier.

      3. Sélectionnez Choose file (Choisir un fichier), puis naviguez vers votre fichier. Pour ajouter un fichier dans un dossier, choisissez Créer un fichier, puis entrez le nom du dossier avec le nom du fichier, par exemplescripts/install_dependencies. Collez le contenu du fichier dans le nouveau fichier.

         Validez la modification en entrant votre nom d'utilisateur et votre adresse e-mail.

         Choisissez Valider les modifications.

      4. Répétez cette étape pour chaque fichier.

         Le contenu de votre dépôt doit ressembler à ceci :

         
                │-- appspec.yml
                │-- index.html
                │-- LICENSE.txt
                └-- scripts
                    │-- install_dependencies
                    │-- start_server
                    └-- stop_server

   2. Pour utiliser les commandes git pour télécharger vos fichiers :

      1. Passez dans le répertoire de votre référentiel local :

         (For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
         (For Windows) cd c:\temp\MyDemoRepo

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

         git add -A

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

         git commit -m "Add sample application files"

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

         git push

4. Les fichiers que vous avez téléchargés et ajoutés à votre dépôt local ont maintenant été ajoutés à la main branche de votre CodeCommit MyDemoRepo référentiel et sont prêts à être inclus dans un pipeline.

Pour créer un rôle d'instance

1. Ouvrez la console IAM à l'adresse https://console.aws.amazon.com/iam/).

2. Dans le tableau de bord de la console, choisissez Rôles.

3. Sélectionnez Créer un rôle.

4. Sous Sélectionner le type d'entité de confiance, sélectionnez Service AWS. Sous Choisir un cas d'utilisation, sélectionnez EC2. Sous Sélectionnez votre cas d'utilisation, choisissez EC2. Choisissez Suivant : Autorisations.

5. Recherchez et sélectionnez la politique nommée AmazonEC2RoleforAWSCodeDeploy.

6. Recherchez et sélectionnez la politique nommée AmazonSSMManagedInstanceCore. Choisissez Suivant : Balises.

7. Choisissez Suivant : Vérification. Saisissez un nom pour le rôle (par exemple, EC2InstanceRole).

   Note

   Notez le nom de votre rôle pour l'étape suivante. Vous choisissez ce rôle lorsque vous créez votre instance.

   Sélectionnez Créer un rôle.

Pour lancer une instance

1. Ouvrez la EC2 console Amazon à l'adresse https://console.aws.amazon.com/ec2/.

2. Dans la navigation latérale, choisissez Instances, puis sélectionnez Launch instances en haut de la page.

3. Pour Name (Nom), entrez MyCodePipelineDemo. Cela affecte à l'instance une balise Key of Name et une balise Value deMyCodePipelineDemo. Vous créerez ultérieurement une CodeDeploy application qui déploiera l'exemple d'application sur cette instance. CodeDeploysélectionne les instances à déployer en fonction des balises.

4. Sous Images de l'application et du système d'exploitation (Amazon Machine Image), recherchez l'option AMI Amazon Linux avec le AWS logo et assurez-vous qu'elle est sélectionnée. (Cette AMI est décrite comme l'AMI Amazon Linux 2 (HVM) et est étiquetée « éligible au niveau gratuit ».)

5. Sous Type d'instance, choisissez le t2.micro type éligible au niveau gratuit comme configuration matérielle de votre instance.

6. Sous Paire de clés (connexion), choisissez une paire de clés ou créez-en une.

   Vous pouvez également choisir Proceed sans paire de clés.

   Note

   Pour les besoins de ce didacticiel, vous pouvez procéder sans paire de clés. Pour utiliser SSH pour vous connecter à vos instances, créez ou utilisez une paire de clés.

7. Sous Paramètres réseau, procédez comme suit.

   Dans Attribuer automatiquement une adresse IP publique, assurez-vous que le statut est Activé.

   • En regard de Attribuer un groupe de sécurité, choisissez Créer un groupe de sécurité.

   • Dans la ligne correspondant à SSH, sous Type de source, sélectionnez Mon adresse IP.

   • Choisissez Ajouter un groupe de sécurité, choisissez HTTP, puis sous Type de source, sélectionnez Mon adresse IP.

8. Développez Advanced Details (Détails avancés). Dans le profil d'instance IAM, choisissez le rôle IAM que vous avez créé lors de la procédure précédente (par exemple,EC2InstanceRole).

9. Sous Résumé, sous Nombre d'instances, entrez1.

10. Choisissez Launch instance (Lancer une instance).

11. Sur la page Instances, vous pouvez afficher le statut du lancement. Lorsque vous lancez une instance, son état initial est pending. Une fois que l'instance a démarré, son état devient running et elle reçoit un nom DNS public. (Si la colonne DNS public ne s'affiche pas, choisissez l'icône Afficher/Masquer, puis sélectionnez DNS public.)

Pour créer un rôle CodeDeploy de service

1. Ouvrez la console IAM à l'adresse https://console.aws.amazon.com/iam/).

2. Dans le tableau de bord de la console, choisissez Rôles.

3. Sélectionnez Créer un rôle.

4. Sous Sélectionner une entité de confiance, sélectionnez Service AWS. Sous Use case (Cas d'utilisation), choisissez CodeDeploy. Choisissez CodeDeployparmi les options répertoriées. Choisissez Suivant. La stratégie gérée AWSCodeDeployRole est déjà attachée au rôle.

5. Choisissez Suivant.

6. Entrez un nom pour le rôle (par exemple, CodeDeployRole), puis choisissez Créer un rôle.

Pour créer une application dans CodeDeploy

1. Ouvrez la CodeDeploy console à l'adresse https://console.aws.amazon.com/codedeploy.

2. Si la page Applications n'apparaît pas, dans le menu, choisissez Applications.

3. Choisissez Créer une application.

4. Dans Nom de l'application, saisissez MyDemoApplication.

5. Dans Compute Platform, choisissez EC2/On-premises.

6. Choisissez Créer une application.

Pour créer un groupe de déploiement dans CodeDeploy

Un groupe de déploiement est une ressource qui définit les paramètres liés au déploiement, tels que les instances sur lesquelles déployer et la vitesse du déploiement.

1. Sur la page qui affiche votre application, choisissez Créer un groupe de déploiement.

2. Dans Nom du groupe de déploiement, saisissez MyDemoDeploymentGroup.

3. Dans Rôle de service, choisissez l'ARN du rôle de service que vous avez créé précédemment (par exemple,arn:aws:iam::account_ID:role/CodeDeployRole).

4. Sous Type de déploiement, choisissez Sur place.

5. Sous Configuration de l'environnement, choisissez Amazon EC2 Instances. Dans le champ Clé, entrezName. Dans le champ Valeur, entrez le nom que vous avez utilisé pour étiqueter l'instance (par exemple,MyCodePipelineDemo).

6. Sous Configuration de l'agent avec AWS Systems Manager, choisissez Now et planifiez les mises à jour. L'agent est alors installé sur l'instance. L'instance Linux est déjà configurée avec l'agent SSM et sera désormais mise à jour avec l' CodeDeploy agent.

7. Dans Configuration de déploiement, choisissez CodeDeployDefault.OneAtaTime.

8. Sous Load Balancer, assurez-vous que l'option Activer l'équilibrage de charge n'est pas sélectionnée. Vous n'avez pas besoin de configurer un équilibreur de charge ou de choisir un groupe cible pour cet exemple.

9. Choisissez Créer un groupe de déploiement.

Pour créer un CodePipeline pipeline

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

   Ouvrez la CodePipeline console à l'adresse https://console.aws.amazon.com/codepipeline/.

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

3. Sur la page Étape 1 : Choisir une option de création, sous Options de création, choisissez l'option Créer un pipeline personnalisé. Choisissez Suivant.

4. À l'étape 2 : Choisissez les paramètres du pipeline, dans Nom du pipeline, entrezMyFirstPipeline.

5. Dans Type de pipeline, choisissez V2. Pour de plus amples informations, veuillez consulter Types de pipelines. Choisissez Suivant.

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

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

8. À l'étape 3 : Ajouter une étape source, dans Source provider, choisissez 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 main, puis Étape suivante.

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

   Sous Modifier les options de détection, ne modifiez pas les valeurs par défaut. Cela permet d' CodePipeline utiliser Amazon CloudWatch Events pour détecter les modifications apportées à votre référentiel source.

   Choisissez Suivant.

9. À l'étape 4 : Ajouter une phase de construction, choisissez Ignorer l'étape de génération, puis acceptez le message d'avertissement en choisissant à nouveau Ignorer. Choisissez Suivant.

   Note

   Dans ce didacticiel, vous déployez un code qui ne requiert aucun service de génération. Vous pouvez donc ignorer cette étape. Toutefois, si votre code source doit être généré avant d'être déployé sur des instances, vous pouvez configurer CodeBuild au cours de cette étape.

10. À l'étape 5 : Ajouter une phase de test, choisissez Ignorer l'étape de test, puis acceptez le message d'avertissement en choisissant à nouveau Ignorer.

    Choisissez Suivant.

11. À l'étape 6 : Ajouter une étape de déploiement, dans Fournisseur de déploiement, sélectionnez CodeDeploy. Dans Nom de l'application, choisissez MyDemoApplication. Dans Groupe de déploiement, choisissez MyDemoDeploymentGroup, puis Étape suivante.

12. À l'étape 7 : Passez en revue, passez en revue les informations, puis choisissez Créer un pipeline.

13. Le pipeline commence à s'exécuter une fois qu'il a été créé. Il télécharge le code depuis votre CodeCommit référentiel et crée un CodeDeploy déploiement sur votre EC2 instance. Vous pouvez consulter les messages de progression et de réussite et d'échec au fur et à mesure que l' CodePipeline exemple déploie la page Web sur l' EC2 instance Amazon lors du CodeDeploy déploiement.

    

Pour vérifier que votre pipeline a été exécuté avec succès

1. Affichez la progression initiale du pipeline. L'état de chaque étape passe de Pas encore d'exécution à En cours, puis devient soit Réussi, soit Échec. Le pipeline doit terminer la première exécution en quelques minutes.

2. Une fois que Succeded est affiché pour l'état du pipeline, dans la zone d'état de l'étape de déploiement, sélectionnez CodeDeploy. Cela ouvre la CodeDeploy console. Si Réussi n'est pas affiché, consultez Résolution des problèmes CodePipeline.

3. Dans l'onglet Déploiements, choisissez l’ID de déploiement. Sur la page du déploiement, sous Événements du cycle de vie de déploiement, choisissez l'ID de l'instance. Cela ouvre la EC2 console.

4. Dans l'onglet Description, sous DNS public, copiez l'adresse (par exemple, ec2-192-0-2-1.us-west-2.compute.amazonaws.com), puis collez-la dans la barre d'adresses de votre navigateur web.

   La page Web s'affiche pour l'exemple d'application que vous avez téléchargé et transféré CodeCommit dans votre référentiel.

1. Passez dans le répertoire de votre référentiel local :

   (For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
   (For Windows) cd c:\temp\MyDemoRepo

2. Utilisez un éditeur de texte pour modifier le fichier index.html :

   (For Linux or Unix)gedit index.html
   (For OS X)open –e index.html
   (For Windows)notepad index.html

3. Révisez le contenu du fichier index.html pour modifier la couleur d'arrière-plan et une partie du texte sur la page web, puis enregistrez le fichier.

   <!DOCTYPE html>
   <html>
   <head>
     <title>Updated Sample Deployment</title>
     <style>
       body {
         color: #000000;
         background-color: #CCFFCC;
         font-family: Arial, sans-serif;  
         font-size:14px;
       }
           
       h1 {
         font-size: 250%;
         font-weight: normal;
         margin-bottom: 0;
       }
       
       h2 {
         font-size: 175%;
         font-weight: normal;
         margin-bottom: 0;
       }
     </style>
   </head>
   <body>
     <div align="center"><h1>Updated Sample Deployment</h1></div>
     <div align="center"><h2>This application was updated using CodePipeline, CodeCommit, and CodeDeploy.</h2></div>
     <div align="center">
       <p>Learn more:</p> 
       <p><a href="https://docs.aws.amazon.com/codepipeline/latest/userguide/">CodePipeline User Guide</a></p>
       <p><a href="https://docs.aws.amazon.com/codecommit/latest/userguide/">CodeCommit User Guide</a></p>
       <p><a href="https://docs.aws.amazon.com/codedeploy/latest/userguide/">CodeDeploy User Guide</a></p>
     </div>
   </body>
   </html>

4. Validez et transférez vos modifications CodeCommit dans votre dépôt en exécutant les commandes suivantes, une par une :

   git commit -am "Updated sample application files"

   git push

Pour vérifier que votre pipeline a été exécuté avec succès

1. Affichez la progression initiale du pipeline. L'état de chaque étape passe de Pas encore d'exécution à En cours, puis devient soit Réussi, soit Échec. L'exécution du pipeline se terminer en quelques minutes.

2. Une fois que Réussi s'affiche pour l'état de l'action, actualisez la page de démonstration à laquelle vous avez accédé précédemment dans votre navigateur.

   La page Web mise à jour s'affiche.

Pour nettoyer les ressources utilisées dans ce didacticiel

1. Pour nettoyer vos CodePipeline ressources, suivez les instructions de la section Supprimer un pipeline dans AWS CodePipeline.

2. Pour nettoyer vos CodeDeploy ressources, suivez les instructions de la section Ressources de procédure pas à pas pour nettoyer le déploiement.

3. Pour supprimer le CodeCommit dépôt, suivez les instructions de la section Supprimer un CodeCommit dépôt.