Créez un pipeline et déployez des mises à jour d'artefacts sur des instances locales à l'aide de EC2 CodePipeline

Créée par Akash Kumar (AWS) et Sandeep Reddy Jogammagari (AWS)

Récapitulatif

Ce modèle fournit des exemples de code et des étapes pour créer un pipeline dans le cloud Amazon Web Services (AWS) et déployer des artefacts mis à jour sur des instances Amazon Elastic Compute Cloud (Amazon EC2) sur site dans AWS CodePipeline. Le modèle est basé sur la pratique de l'intégration continue. Cette pratique automatise la création et le test du code à l'aide d'un système de contrôle de version basé sur Git. Dans ce modèle, vous créez et clonez un référentiel de code à l'aide d'AWS CodeCommit. Ensuite, vous créez un projet et configurez votre code source à l'aide d'AWS CodeBuild. Enfin, vous créez votre application et configurez son environnement cible pour les EC2 instances sur site à l'aide d'AWS CodeDeploy.

Conditions préalables et limitations

Prérequis

• Un compte AWS actif

• Balises définies par l'utilisateur pour identifier les EC2 instances lors du déploiement

• CodeDeploy agent, installé sur les EC2 instances

• Le logiciel d'exécution requis, installé sur les EC2 instances

• Amazon Corretto 8 pour le kit de développement Java

• Serveur Web Apache Tomcat, installé

• Amazon CloudWatch Events (facultatif)

• Une paire de clés pour se connecter au serveur Web (facultatif)

• Un projet d'application Apache Maven pour une application Web

Architecture

Le schéma suivant montre un exemple d'application Web Java déployée sur des EC2 instances locales à l'aide de l'architecture de ce modèle.

Le schéma suivant illustre le flux de travail suivant :

1. Le développeur valide les modifications de code dans un dépôt CodeCommit Git privé.

2. CodePipeline utilise CodeBuild pour lancer la construction et ajouter de nouveaux artefacts prêts à être déployés dans le compartiment Amazon Simple Storage Service (Amazon S3).

3. CodePipeline utilise l' CodeDeploy agent pour préinstaller toutes les dépendances requises pour les modifications des artefacts de déploiement.

4. CodePipeline utilise l' CodeDeploy agent pour déployer les artefacts du compartiment S3 vers les EC2 instances cibles. Si cette option est activée, CloudWatch Events peut démarrer automatiquement le pipeline lorsqu'une modification se produit dans le code source.

Pile technologique

• CodeBuild

• CodeCommit

• CodeDeploy

• CodePipeline

• CloudWatch Événements (facultatif)

Outils

• AWS CodeBuild est un service de génération entièrement géré qui vous aide à compiler le code source, à exécuter des tests unitaires et à produire des artefacts prêts à être déployés. CodeBuild compile votre code source, exécute des tests unitaires et produit des artefacts prêts à être déployés.

• AWS CodeCommit est un service de contrôle de version qui vous permet de stocker et de gérer de manière privée des référentiels Git, sans avoir à gérer votre propre système de contrôle de source.

• AWS CodeDeploy automatise les déploiements vers Amazon Elastic Compute Cloud EC2 (Amazon) ou des instances sur site, les fonctions AWS Lambda ou les services Amazon Elastic Container Service (Amazon ECS).

• AWS vous CodePipeline aide à modéliser et à configurer rapidement les différentes étapes d'une version logicielle et à automatiser les étapes nécessaires à la publication continue des modifications logicielles.

Code

Ce modèle inclut les pièces jointes suivantes :

• buildspec.yml— Ce fichier spécifie les actions nécessaires CodeBuild pour créer et créer un artefact à déployer.

• appspec.yml— Ce fichier spécifie les actions CodeDeploy requises pour créer une application et configurer un environnement cible pour les EC2 instances locales.

• install_dependencies.sh— Ce fichier installe les dépendances du serveur Web Apache Tomcat.

• start_server.sh— Ce fichier démarre le serveur Web Apache Tomcat.

• stop_server.sh— Ce fichier arrête le serveur Web Apache Tomcat.

Épopées

Configuration du référentiel de code

Tâche	Description	Compétences requises
Créez le référentiel.	Créez un CodeCommit référentiel.	Administrateur système AWS
Pour cloner le référentiel.	Connectez-vous au CodeCommit référentiel en le clonant.	Développeur d’applications
Transférez le code source vers le dépôt distant.	Créez un commit pour ajouter les appspec.yml fichiers buildspec.yml et à votre dépôt local. Transférez le commit de votre dépôt local vers le CodeCommit référentiel distant.	Développeur d’applications

Création d'un CodeBuild projet pour l'application

Tâche	Description	Compétences requises
Créez un projet de génération.	Connectez-vous à l'AWS Management Console, ouvrez la CodeBuild console AWS, puis choisissez Create build project. Dans Nom du projet, entrez le nom de votre projet. Dans le champ Source provider, choisissez AWS CodeCommit. Pour Repository, choisissez le référentiel dans lequel vous souhaitez créer le pipeline de code. Pour Image d'environnement, choisissez Image gérée ou Image personnalisée. Pour Operating system (Système d'exploitation), choisissez Amazon Linux 2. Note Le support d'Amazon Linux 2 touche à sa fin. Pour plus d'informations, consultez Amazon Linux 2 FAQs. Pour RunTime(s), choisissez Standard. Pour Image, choisissez aws/codebuild/amazonlinux2-aarch64-standard:2.0. Pour la version image, choisissez Toujours utiliser la dernière image pour cette version d'exécution. Pour Rôle de service, choisissez Nouveau rôle de service ou Rôle de service existant. Pour les spécifications de construction, choisissez Utiliser un fichier de spécification de construction ou Insérer des commandes de construction. (Facultatif) Choisissez Ajouter un artefact pour configurer les artefacts. (Facultatif) Pour télécharger les journaux de sortie de build sur Amazon CloudWatch, sélectionnez CloudWatch logs. Choisissez Créer un projet de génération.	Administrateur AWS, développeur d'applications

Configuration du déploiement d'artefacts pour les instances sur site EC2

Tâche	Description	Compétences requises
Créez l'application.	Connectez-vous à l'AWS Management Console, ouvrez la CodeDeploy console AWS, puis choisissez Create application. Dans Nom de l'application, entrez le nom de votre application. Pour la plateforme de calcul, choisissez EC2/On-premises. Choisissez Créer une application, puis Créer un groupe de déploiement. Pour Nom du groupe de déploiement, entrez un nom. Note Créez un rôle de service pour CodeDeploy. : le rôle de service doit disposer des autorisations nécessaires pour autoriser CodeDeploy l'accès à votre environnement cible. Pour Rôle de service, choisissez le rôle de service que vous avez créé à l'étape 6. Pour le type de déploiement, choisissez sur place ou bleu/vert en fonction des besoins de votre entreprise. Pour la configuration de l'environnement, choisissez les options qui répondent aux exigences de votre entreprise. (Facultatif) Créez un groupe cible pour votre équilibreur de charge séparément dans la EC2 console Amazon, puis revenez à la page Créer un groupe de déploiement de la CodeDeploy console AWS pour choisir votre équilibreur de charge et votre groupe cible. Choisissez Créer un groupe de déploiement.	Administrateur système AWS, développeur d'applications

Configuration du pipeline

Tâche	Description	Compétences requises
Créez le pipeline.	Connectez-vous à l'AWS Management Console, ouvrez la CodePipeline console AWS, puis choisissez Create pipeline. Dans Nom du pipeline, entrez un nom pour le pipeline. Pour Rôle de service, choisissez Nouveau rôle de service ou Rôle de service existant. Dans le champ Role name (Nom de rôle), saisissez un nom pour votre rôle. Dans la section Paramètres avancés, pour Artifact store, choisissez Default location si vous souhaitez qu'Amazon S3 crée un bucket et stocke les artefacts dans le bucket. Pour utiliser un compartiment S3 existant, choisissez Emplacement personnalisé. Choisissez Suivant. Dans le champ Source provider, choisissez AWS CodeCommit. Dans Nom du référentiel, choisissez le référentiel que vous avez cloné précédemment. Dans Nom de la branche, choisissez votre branche de code source. Pour les options de détection des modifications, choisissez Amazon CloudWatch Events (recommandé) ou AWS CodePipeline. Choisissez Suivant. Dans le champ Build provider, choisissez AWS CodeBuild. Pour Nom du projet, choisissez le projet de construction que vous avez créé dans la section Créer un CodeBuild projet pour l'application de ce modèle. Choisissez vos options de compilation, puis cliquez sur Suivant. Dans le champ Deploy provider, choisissez AWS CodeDeploy. Choisissez un nom d'application et un groupe de déploiement, puis choisissez Next. Choisissez Créer un pipeline.	Administrateur système AWS, développeur d'applications

Ressources connexes

• Utilisation de référentiels dans AWS CodeCommit

• Utilisation des projets de génération

• Utilisation d'applications dans CodeDeploy

• Travailler avec des pipelines dans CodePipeline

Pièces jointes

Pour accéder au contenu supplémentaire associé à ce document, décompressez le fichier suivant : attachment.zip