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.
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.