Déployer sur AWS avec CodePipeline et CodeBuild

1. Introduction

Dans ce tutoriel, nous allons mettre en place un pipeline CI/CD complet sur AWS en utilisant les services natifs AWS CodePipeline et AWS CodeBuild.

L’objectif est d’automatiser tout le cycle de vie d’une application : récupération du code depuis GitHub, build, tests et déploiement, à chaque nouveau push sur le dépôt.

À la fin de ce tutoriel, ton application sera automatiquement testée, buildée et déployée sur AWS, sans aucune intervention manuelle.

2. Prérequis et configuration

Avant de commencer, assure-toi d’avoir tous les éléments nécessaires pour suivre ce tutoriel sans blocage :

• Un compte AWS actif. Tu peux le créer gratuitement (1€)ici. Tu peux utiliser la version gratuite pendant 6 mois.
• Une application simple (par exemple un projet HTML/CSS/JS ou Node.js)
• Un compte GitHub avec un repository contenant ton application
• Connaissance basique de Git et des commandes de push

Les services AWS que nous allons utiliser

• AWS CodePipeline : service d’orchestration qui définit les étapes de ton pipeline CI/CD (source, build, tests, déploiement). Dès qu’un push est détecté dans ton dépôt GitHub, CodePipeline déclenche automatiquement le flux.
• AWS CodeBuild : service de build managé qui exécute les commandes définies dans un fichier buildspec.yml. Il permet d’installer les dépendances, lancer les tests, générer les artefacts et préparer ton application pour le déploiement.

Contrairement à Jenkins, AWS gère l’infrastructure. Tu n’as pas besoin de serveur ou d’agent à maintenir. Tu bénéficies d’une solution scalable, sécurisée et directement intégrée à l’écosystème AWS.

3. Création du projet AWS CodeBuild

Nous allons maintenant configurer AWS CodeBuild, le service qui va se charger de builder et tester automatiquement notre application. CodeBuild fonctionne comme un robot qui exécute une série de commandes à chaque fois que ton code change.

Étape 1 : Accéder à CodeBuild

Connecte-toi à la console AWS (ton compte AWS) puis dans la barre de recherche en haut, tape "CodeBuild" et clique sur le service. Une fois sur la page CodeBuild, clique sur le bouton orange Create project.

Étape 2 : Configuration du projet

Tu vas maintenant remplir plusieurs champs. Ne t'inquiète pas, je vais t'expliquer chaque section en détail.

Une fois tous les champs remplis, clique sur Create build project en bas de la page. Nous allons maintenant créer le fichier buildspec.yml.

Étape 3 : Créer le fichier buildspec.yml

Le fichier buildspec.yml est le cerveau de ton build. Il contient toutes les instructions que CodeBuild doit exécuter et doit être placé à la racine de ton projet.

Tu peux crée le fichier buildspec.yml avec le contenu suivant :

version: 0.2

phases:
  install:
    commands:
      - npm install
  build:
    commands:
      - npm run build

artifacts:
  files:
    - '**/*'
  base-directory: build

Une fois le fichier créé, commit et push-le sur GitHub.

Étape 4 : Tester ton build

Maintenant que tout est configuré, testons si ça fonctionne !

1. Retourne sur la page de ton projet CodeBuild dans la console AWS
2. Clique sur le bouton Start build en haut à droite
3. Observe le build en temps réel ! Tu verras chaque commande s'exécuter étape par étape

Si ton build est passé au vert, félicitations ! Ton projet CodeBuild est correctement configuré et prêt à être intégré dans un pipeline complet.

⚠️ Build en échec ?

Pas de panique ! Voici les erreurs les plus courantes :

• npm: command not found : vérifie que tu as bien sélectionné un runtime avec Node.js
• buildspec.yml not found : le fichier doit être à la racine de ton repo et s'appeler exactement buildspec.yml
• npm ERR! missing script: build : ton package.json n'a pas de script "build". Ajoute-le ou change la commande dans le buildspec.

Pour débugger, clique sur ton build et lis attentivement les logs. L'erreur est généralement bien indiquée !

Dans la section suivante, on va automatiser tout ça avec CodePipeline.

4. Création du pipeline avec AWS CodePipeline

Maintenant que notre projet CodeBuild est configuré et testé, nous allons créer le pipeline CI/CD avec AWS CodePipeline.

CodePipeline va automatiser l'enchaînement : détecter les changements sur GitHub → lancer CodeBuild → déployer l'application. Le tout sans intervention manuelle !

Étape 1 : Accéder à CodePipeline

Dans la console AWS, utilise la barre de recherche en haut et tape "CodePipeline", puis clique sur le service. Clique ensuite sur le bouton orange Create pipeline.

AWS te propose plusieurs types de pipelines. Dans notre cas, nous allons choisir l'option "Build custom pipeline" puis cliquer sur Next.

Étape 2 : Configuration générale (Pipeline settings)

Une fois rempli, clique sur Next.

Étape 3 : Configurer la source du code (Add source stage)

Cette étape définit d'où vient ton code. C'est ici que tu connectes ton repository GitHub.

Clique sur Next pour passer à l'étape suivante.

Étape 4 : Configurer le build (Add build stage)

Cette étape va lier ton projet CodeBuild au pipeline. C'est ici que le code sera compilé et testé.

Clique sur Next.

Clique sur Next pour passer au déploiement.

Étape 5 : Ajouter le déploiement (Add deploy stage )

Pour l'instant, nous allons sauter l'étape de déploiement. Nous la configurerons dans la section suivante.

Clique sur Skip deploy stage → une popup de confirmation apparaît → clique sur Skip.

Étape 6 : Vérification finale (Review)

AWS te montre un récapitulatif de toute la configuration de ton pipeline. Vérifie que :

• ✓ Le nom du pipeline est correct
• ✓ La source est bien ton repository GitHub sur la bonne branche
• ✓ Le build provider est bien AWS CodeBuild avec le bon projet
• ✓ Le deploy stage est marqué comme "Skipped"

Si tout est bon, clique sur Create pipeline.

Premier déclenchement automatique

Dès que tu cliques sur "Create pipeline", AWS va automatiquement lancer le pipeline pour la première fois ! Tu vas voir en temps réel :

1. Source : CodePipeline récupère ton code depuis GitHub
2. Build : CodeBuild exécute ton buildspec.yml

   Tu peux cliquer sur Details pour voir les logs en temps réel

Pipeline créé avec succès !

Si les deux étapes (Source et Build) sont passées au vert, félicitations ! Ton pipeline CI/CD est maintenant fonctionnel. À partir de maintenant, chaque fois que tu feras ungit push sur la branchemain, le pipeline se déclenchera automatiquement pour builder ton code.

Sur la page de ton pipeline, tu peux voir l'historique complet de toutes les exécutions : quand elles ont eu lieu, combien de temps elles ont pris, et si elles ont réussi ou échoué. C'est très utile pour comprendre quand un bug a été introduit ou pour auditer les déploiements.

Nous sommes ainsi arrivés à la fin de l'intégration continue. Nous allons maintenant passer au déploiement de l'application.

5. Déploiement automatique de l'application

Maintenant que ton pipeline récupère le code et le build automatiquement, il ne reste plus qu'à déployer l'application pour la rendre accessible sur Internet ! Pour cela nous allons utiliser le service Amazon S3.

Étape 1 : Créer un bucket S3

Dans la console AWS, utilise la barre de recherche et tape "S3", puis clique sur le service. Une fois le service sélectionné, clique sur le bouton orange Create bucket.

Clique sur Create bucket en bas de la page.

Étape 2 : Activer l'hébergement de site web statique

Maintenant que ton bucket est créé, il faut le configurer pour qu'il puisse servir des pages web.

1. Clique sur le nom de ton bucket dans la liste
2. Va dans l'onglet Properties (en haut)
3. Descends tout en bas jusqu'à la section Static website hosting
4. Clique sur Edit

Clique sur Save changes.

Étape 3 : Configurer les permissions d'accès public

Pour que les visiteurs puissent accéder à ton site, il faut ajouter une bucket policy qui autorise la lecture publique de tous les fichiers.

1. Toujours dans ton bucket, va dans l'onglet Permissions
2. Descends jusqu'à la section Bucket policy
3. Clique sur Edit

Copie-colle cette policy dans l'éditeur (en remplaçant my-app-bucket par le nom de ton bucket) :

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "PublicReadGetObject",
      "Effect": "Allow",
      "Principal": "*",
      "Action": "s3:GetObject",
      "Resource": "arn:aws:s3:::my-app-bucket/*"
    }
  ]
}

Décryptage de la bucket policy

• "Effect": "Allow" : on autorise l'action par opposition à "Deny" qui bloquerait l'action
• "Principal": "*" : l'astérisque (*) signifie "tout le monde", donc n'importe qui sur Internet
• "Action": "s3:GetObject" : on autorise uniquement la lecture des fichiers, pas la modification ou la suppression
• "Resource": "arn:aws:s3:::my-app-bucket/*" : cette règle s'applique à tous les fichiers (/*) dans le bucket spécifié.

Après avoir copié et collé la policy, clique sur Save changes.

Configurer les permissions IAM pour CodePipeline

Pour que CodePipeline puisse déployer automatiquement sur ton bucket S3, il faut lui donner les permissions nécessaires.

1. Dans la console AWS, va dans le service IAM
2. Dans le menu de gauche, clique sur Roles
3. Cherche et clique sur le rôlecorrespondant à ton pipeline. Il sera sous la forme : AWSCodePipelineServiceRole-[région]-[nom-pipeline]
4. Dans l'onglet Permissions, clique sur Add permissions → Create inline policy
5. Passe en mode JSON
6. Colle cette politique en remplaçant my-app-bucket par le nom de ton bucket :

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:PutObjectAcl",
                "s3:PutObjectVersionAcl",
                "s3:GetObject",
                "s3:GetObjectVersion"
            ],
            "Resource": [
                "arn:aws:s3:::my-app-bucket/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::my-app-bucket"
            ]
        }
    ]
}

7. Clique sur Review policy
8. Donne un nom : S3DeploymentPolicy
9. Clique sur Create policy

Décryptage de la policy IAM

• "s3:PutObject" : permet d'uploader des fichiers dans le bucket
• "s3:GetObject" : permet de lire les fichiers existants
• "s3:ListBucket" : permet de lister le contenu du bucket
• "Resource" avec /* : les actions s'appliquent aux objets dans le bucket
• "Resource" sans /* : l'action s'applique au bucket lui-même

Étape 4 : Ajouter l'étape de déploiement dans CodePipeline

Retourne maintenant sur CodePipeline pour ajouter l'étape de déploiement qui manquait.

1. Va sur la console CodePipeline et clique sur le nom de ton pipeline
2. Clique sur le bouton Edit
3. En bas du pipeline (après l'étape "Build"), clique sur + Add stage
4. Donne un nom à cette étape : Deploy
5. Dans cette nouvelle étape, clique sur + Add action group

Clique ensuite sur Done, puis sur Save en haut de la page. Une popup de confirmation apparaît. Clique sur Save pour confirmer les modifications du pipeline.

6. Tester le pipeline CI/CD complet

Maintenant que tout est en place, il est temps de tester le pipeline complet de bout en boutpour vérifier que chaque modification de code se déploie automatiquement en production !

Étape 1 : Faire une modification dans ton code

Pour tester le pipeline, tu peux faire une modification visible dans l'application. Une fois ta modification faite, fais un commit et push sur Github.

Étape 2 : Observer le pipeline en action

Dès que tu as push ton code, le pipeline se déclenche automatiquement ! Voici comment le suivre en temps réel :

1. Va sur la console AWS et ouvre CodePipeline
2. Clique sur ton pipeline
3. Tu devrais voir une nouvelle exécution qui vient de démarrer : en haut de la page, un bandeau indique "Execution in progress"
4. Observe les 3 étapes s'exécuter l'une après l'autre :
   • Source : CodePipeline détecte le nouveau commit et récupère le code depuis GitHub
   • Build : CodeBuild compile ton application et lance les tests
   • Deploy : Les fichiers sont uploadés sur S3

Étape 3 : Vérifier le déploiement

Une fois que toutes les étapes sont passées au vert, ton application est déployée ! Vérifions que tout fonctionne :

1. Récupère l'URL de ton site S3
   • • Va dans S3 et ouvre ton bucket
   • • Onglet "Properties" puis section "Static website hosting"
   • • Copie l'URL "Bucket website endpoint"
2. Ouvre l'URL dans ton navigateur
   • • Force le rafraîchissement avec Ctrl+F5 (Windows) ou Cmd+Shift+R (Mac) pour bypasser le cache si tu l'avais mis plus haut
3. Vérifie que ta modification est visible
   • • Le nouveau titre doit apparaître
   • • Si tu ne vois pas la modification, attends 30 secondes et rafraîchis à nouveau

Si tu vois ta modification en ligne, c'est que le pipeline complet fonctionne de bout en bout. À partir de maintenant, chaque commit sur la branche main sera automatiquement déployé en productionsans que tu aies à faire quoi que ce soit manuellement !

7. Bonnes pratiques CI/CD sur AWS

Maintenant que ton pipeline fonctionne, voici les bonnes pratiques essentielles pour sécuriser, optimiser et professionnaliser ton CI/CD en production.

version: 0.2

env:
  secrets-manager:
    DATABASE_PASSWORD: prod/myapp/db:password
    API_KEY: prod/myapp/api:key

phases:
  build:
    commands:
      - echo "Building with secure credentials..."
      - npm run build

version: 0.2

phases:
  install:
    commands:
      - npm install
  
  pre_build:
    commands:
      - echo "Running linter..."
      - npm run lint
      - echo "Running unit tests..."
      - npm test -- --coverage
  
  build:
    commands:
      - echo "Building application..."
      - npm run build
  
  post_build:
    commands:
      - echo "Running integration tests..."
      - npm run test:integration

artifacts:
  files:
    - '**/*'
  base-directory: build

8. Conclusion

Tu as maintenant mis en place un pipeline CI/CD complet sur AWS avec CodePipeline et CodeBuild. À chaque push de ton code, ton application est automatiquement buildée et déployée.

Ce workflow est une base solide utilisée en entreprise. Tu peux maintenant l’enrichir avec des tests avancés, des environnements de déploiement différents ou des déploiements de backend sur ECS ou EC2.