Formations — 1 037 leçons en français

Accueil › Git & CI/CD › Les services dont les tests ont besoin

Les services dont les tests ont besoin

Tester dans la chaîneintermediaire

Un test d'intégration a besoin d'une vraie dépendance. La chaîne doit donc la fournir, puis la rendre joignable, puis la rendre propre entre les tests.

jobs:
  integration:
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:16
        env:
          POSTGRES_PASSWORD: secret
          POSTGRES_DB: appli_test
        ports: ['5432:5432']
        options: >-
          --health-cmd "pg_isready -U postgres"
          --health-interval 5s
          --health-retries 10
    env:
      DATABASE_URL: postgres://postgres:secret@localhost:5432/appli_test
    steps:
      - uses: actions/checkout@v4
      - run: npm ci
      - run: npm run migrate
      - run: npm run test:integration

Le point qui fait échouer la moitié des premières tentatives

options: --health-cmd n'est pas de la décoration. Sans contrôle de disponibilité, les étapes démarrent dès que le conteneur est créé, pas quand le service accepte des connexions. Entre les deux, il y a plusieurs secondes, et une course que l'on perd de manière intermittente.

Où joindre le service

Le travail s'exécute… Adresse du service
directement sur l'exécuteur localhost et le port publié
dans un conteneur (container:) le nom du service, port interne

C'est la deuxième cause de refus de connexion, et elle ne se devine pas depuis le message d'erreur.

Les termes à connaître

Conteneur de service

Un conteneur démarré par la chaîne à côté du travail, pour fournir une base, une file ou un cache aux tests. En GitHub Actions, le bloc services: d'un travail ; il vit et meurt avec le travail.

Contrôle de disponibilité

Une commande répétée jusqu'à ce que le service réponde. Un conteneur démarré n'est pas un service prêt : accepter des connexions arrive plus tard que démarrer.

Bouchon (mock)

Un objet qui imite une dépendance sans la joindre. Il rend les tests rapides et déterministes, et il valide exactement ce qu'on a supposé — pas ce que la dépendance fait réellement.

Isolation des données

Garantir qu'un test ne voie pas ce qu'un autre a écrit. Par transaction annulée, par schéma dédié ou par base dédiée — le choix décide de ce qu'on peut paralléliser.

Migration de schéma

Les scripts qui amènent une base vide à la structure attendue. Les rejouer dans la chaîne teste aussi les migrations elles-mêmes, ce qu'un schéma chargé d'un seul coup ne fait pas.

Testcontainers

Bibliothèque qui démarre des conteneurs depuis le code de test et attend leur disponibilité. Le même test tourne alors à l'identique sur un poste et dans la chaîne.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.