Información general

Ejecuta tests de Continuous Testing en tus pipelines de GitLab, bloquea despliegues y desencadena retrocesos para garantizar que tu código se agrega en producción cuando tus flujos de trabajo empresariales esenciales funcionan como se espera.

Para integrar los tests de Continuous Testing con un pipeline de GitLab, puedes utilizar el paquete datadog-ci npm.

Ajustes

Para empezar:

1. Añade tu API de Datadog y las claves de la aplicación como variables en tu proyecto de GitLab.
2. Asegúrate de que tu ejecutor de GitLab tiene instalada una versión de Node.js >= 10.24.1.

Para más información, consulta la configuración de integraciones de CI/CD.

Configuración simple

Ejecutar tests utilizando IDs de test

stages: 
  - test
synthetic-tests:
  stage: test
  script: 
    - npm install -g @datadog/datadog-ci
    - datadog-ci synthetics run-tests --apiKey "$DATADOG_API_KEY" --appKey "$DATADOG_APP_KEY" --public-id xtf-w5p-z5n --public-id eif-van-tu7

Ejecutar tests con etiquetas

stages: 
  - test
synthetic-tests:
  stage: test
  script: 
    - npm install -g @datadog/datadog-ci
    - datadog-ci synthetics run-tests --apiKey "$DATADOG_API_KEY" --appKey "$DATADOG_APP_KEY" -s 'tag:e2e-tests'

Ejecutar tests utilizando anulaciones de variables

Si tienes diferentes usuarios de test o datos específicos para tu entorno de CI/CD, puedes anular estas variables con el comando -v. Para obtener más información, consulta el comando de Synthetics en el paquete datadog-ci NPM.

stages: 
  - test
synthetic-tests:
  stage: test
  script: 
    - npm install -g @datadog/datadog-ci
    - datadog-ci synthetics run-tests --apiKey "$DATADOG_API_KEY" --appKey "$DATADOG_APP_KEY" -s 'tag:e2e-tests' -v PASSWORD="$PASSWORD"

Configuración avanzada

Ejecutar tests utilizando un archivo de configuración personalizado

Añade un archivo config.json personalizado a tu repositorio de pipelines y accede a él en tu configuración de pipeline.

stages: 
  - test
synthetic-tests:
  stage: test
  script: 
    - npm install -g @datadog/datadog-ci
    - datadog-ci synthetics run-tests --apiKey "$DATADOG_API_KEY" --appKey "$DATADOG_APP_KEY" --config synthetics_global.json -f synthetic_test.json

Resultado del test

Este ejemplo demuestra que el pipeline ha identificado el archivo de configuración y está ejecutando el test:

Una salida de test correcta devuelve lo siguiente en GitLab:

Lectura adicional

Más enlaces, artículos y documentación útiles:

Ejecutar los tests de Datadog Synthetic en tus pipelines de GitLabBLOG Configurar el rastreo en un pipeline de GitLabDOCUMENTACIÓN