Cette page explique comment exécuter des tests continus dans vos pipelines d'intégration continue (CI) et de livraison continue (CD). Si vous souhaitez intégrer vos métriques et données de CI/CD dans des dashboards Datadog, consultez plutôt la section CI Visibility.
En plus d’exécuter des tests à des intervalles prédéfinis, vous avez la possibilité de réutiliser vos tests Synthetic Datadog et de les exécuter quand bon vous semble à l’aide du package @datadog/datadog-ci ou de l’API. Exécutez des tests continus Datadog dans vos pipelines d’intégration continue (CI) pour bloquer le déploiement des branches susceptibles de nuire au bon fonctionnement de votre application en production.
Cette solution vous permet également d’exécuter des tests dans le cadre de votre processus de livraison continue (CD) et d’évaluer l’état de vos applications et services en production dès la fin d’un déploiement ou dès la publication d’une nouvelle version. Vous pouvez ainsi détecter les régressions potentielles susceptibles d’avoir un impact sur vos utilisateurs et déclencher automatiquement un rollback si un test critique échoue.
Cette fonctionnalité accélère la correction des problèmes en production en vous permettant dès le départ d’identifier de manière proactive et anticipée les bugs et régressions. Au lieu de perdre leur temps à corriger ces problèmes, vos équipes d’ingénieries peuvent ainsi se concentrer sur des tâches non urgentes.
Les tests continus et le CI/CD vous permettent d'exécuter des tests dans la plateforme de CI tierce de votre choix. Consultez la documentation pour en savoir savoir plus sur les intégrations suivantes ou sur le package NPM datadog-ci :
Vous pouvez déclencher des tests en les recherchant à l’aide de tags. Exemple : "ci": "datadog-ci synthetics run-tests --config fileconfig.json -s 'tag:staging'". Cette commande fonctionne comme un argument ; ne l’utilisez pas dans vos fichiers de configuration.
Les endpoints d’API Synthetics vous permettent de lancer des tests à n’importe quelle étape de votre cycle de préproduction et de déploiement, par exemple après un déploiement Canary avec un rollback automatisé.
Grâce aux endpoints d’API, vous pouvez vérifier rapidement qu’un nouveau déploiement n’entraîne pas de nouvelle régression. Consultez la documentation relative aux endpoints Trigger tests from CI/CD pipelines et Get details of batch pour les utiliser dans vos pipelines de CI via cURL ou un client compatible.
Les objets TEST_TO_TRIGGER sont composés du public_id requis pour le test à déclencher, ainsi que des éventuels remplacements de configuration. Pour obtenir la description de chaque champ, consultez la rubrique Configurer des tests.
L’identifiant public d’un test correspond à l’identifiant du test fourni dans l’URL de la page de détails du test (par exemple, pour https://app.datadoghq.com/synthetics/details/abc-def-ghi, l’identifiant est abc-def-ghi) ou à l’URL complète de cette page (c’est-à-dire https://app.datadoghq.com/synthetics/details/abc-def-ghi).
L’endpoint Get details of batch récupère les résultats du groupe de tests déclenchés dans votre pipeline de CI/CD (également désigné par le terme « batch »). Vous devez fournir le batch_id de l’exécution CI pertinente.