Skip to content
Learni
View all tutorials
DevOps

Comment configurer CircleCI pour vos projets en 2026

12 minBEGINNER
CI/CDCircleCI

Introduction

CircleCI est une plateforme d'intégration et de déploiement continus qui permet d'automatiser vos workflows de développement. En 2026, elle reste un outil de référence pour les équipes souhaitant gagner en fiabilité et en rapidité. Ce tutoriel vous accompagne depuis la création du fichier de configuration jusqu'à l'exécution de votre premier pipeline.

Prérequis

  • Un compte CircleCI gratuit
  • Un dépôt GitHub ou GitLab
  • Connaissances de base en ligne de commande
  • Node.js installé localement pour l'exemple

Initialiser le projet CircleCI

terminal
mkdir mon-projet
cd mon-projet
git init
npm init -y

Nous créons un nouveau projet et initialisons un dépôt Git. Cela permet ensuite de connecter le dépôt à CircleCI pour détecter automatiquement les modifications.

Créer le dossier de configuration

terminal
mkdir -p .circleci

CircleCI recherche toujours son fichier de configuration dans le dossier .circleci à la racine du projet.

Configuration de base

.circleci/config.yml
version: 2.1

jobs:
  build:
    docker:
      - image: cimg/node:20.11
    steps:
      - checkout
      - run: npm install
      - run: npm run build

workflows:
  version: 2
  build_and_test:
    jobs:
      - build

Ce fichier YAML définit un job simple qui installe les dépendances et build le projet Node.js. Il utilise une image Docker officielle maintenue par CircleCI.

Ajouter une étape de test

.circleci/config.yml
version: 2.1

jobs:
  build:
    docker:
      - image: cimg/node:20.11
    steps:
      - checkout
      - run: npm install
      - run: npm run build
  test:
    docker:
      - image: cimg/node:20.11
    steps:
      - checkout
      - run: npm install
      - run: npm test

workflows:
  version: 2
  build_and_test:
    jobs:
      - build
      - test:
          requires:
            - build

Nous ajoutons un job de test séparé qui s'exécute uniquement après le build. Cela illustre la dépendance entre jobs dans un workflow.

Configuration complète avec cache

.circleci/config.yml
version: 2.1

jobs:
  build:
    docker:
      - image: cimg/node:20.11
    steps:
      - checkout
      - restore_cache:
          keys:
            - v1-dependencies-{{ checksum "package-lock.json" }}
      - run: npm install
      - save_cache:
          paths:
            - node_modules
          key: v1-dependencies-{{ checksum "package-lock.json" }}
      - run: npm run build
  test:
    docker:
      - image: cimg/node:20.11
    steps:
      - checkout
      - restore_cache:
          keys:
            - v1-dependencies-{{ checksum "package-lock.json" }}
      - run: npm test

workflows:
  version: 2
  build_and_test:
    jobs:
      - build
      - test:
          requires:
            - build

L'ajout de restore_cache et save_cache accélère considérablement les builds en réutilisant les dépendances entre les exécutions.

Bonnes pratiques

  • Toujours versionner le fichier config.yml
  • Utiliser des images Docker officielles et épinglées
  • Mettre en cache les dépendances pour réduire le temps de build
  • Séparer les jobs build, test et deploy
  • Protéger les variables d'environnement sensibles

Erreurs courantes à éviter

  • Oublier le champ version en haut du fichier YAML
  • Ne pas activer le projet dans l'interface CircleCI après le push
  • Utiliser des commandes qui nécessitent des droits root sans sudo
  • Ignorer les caches et rallonger inutilement les temps de build

Pour aller plus loin

Découvrez nos formations complètes sur l'intégration continue et le DevOps sur Learni Group.