Información general

La mayor parte del ciclo de desarrollo ocurre dentro de redes privadas, que son usualmente inaccesibles a los tests de Synthetic. Con la ayuda de datadog-ci, puedes establecer un túnel de Continuous Testing que permite a los workers de Synthetics alcanzar los entornos en los que tu aplicación se despliega en el ciclo de desarrollo, tales como tu computadora portátil de desarrollo, un trabajo de CI, o un entorno de preproducción privado.

Datadog recomienda utilizar el túnel de tests si necesitas lanzar tests de Continuous Testing contra versiones locales de tu aplicación sin desplegar un sistema de sondeo dedicado y de larga duración como una localización privada. También puedes utilizar el túnel de tests para lanzar tests en entornos en la nube de corta duración.

¿Qué es el túnel de tests?

El túnel de tests es una funcionalidad que viene con el paquete NPM @datadog/datadog-ci, que es uno de los métodos que Datadog proporciona para incluir tus tests de Synthetic como parte de tus pipelines de CI/CD.

El túnel de tests crea conexiones seguras de corta duración entre tus entornos internos y la infraestructura de Datadog, lo que te permite activar rápidamente tests HTTP de Synthetic y tests de navegador en tus aplicaciones privadas. Esto permite a Datadog acceder a tus aplicaciones internas y probarlas.

En primer lugar, datadog-ci obtiene una URL prefirmada de Datadog para su autenticación. A continuación, abre una conexión WebSocket segura (WSS) con las localizaciones administradas de Datadog utilizando la URL prefirmada. Mediante el uso de conexiones SSH a través de la conexión WebSocket, datadog-ci activa los tests y los ejecuta a través de localizaciones administradas de Datadog.

Dado que la resolución DNS se realiza a través del túnel de tests, puedes probar aplicaciones con dominios internos o incluso en el localhost de la máquina que ejecuta datadog-ci.

Cuando se utiliza el túnel de tests, las localizaciones de tus tests quedan anuladas por una localización que depende de la región de tu cuenta de Datadog.

Cómo utilizar el túnel de tests

Como se mencionó anteriormente, el túnel de tests viene con el paquete NPM @datadog/datadog-ci y está disponible en las versiones >=v0.11.0 del paquete. Para empezar, consulta Continuous Testing y CI/CD.

Una vez que hayas configurado tu cliente en tu máquina local o en tu servidor CI, puedes lanzar tus tests HTTP y tests de navegador con el túnel de tests añadiendo --tunnel al comando utilizado para lanzar los tests.

Por ejemplo, si utilizas un archivo de configuración global, puedes utilizar lo siguiente:

datadog-ci synthetics run-tests --config <GLOBAL_CONFIG_FILE>.json --tunnel

Requisitos del firewall

Permite Outbound connections (Conexiones de salida) para los siguientes endpoints de Datadog:

Utilización del túnel de tests con múltiples entornos

El túnel de tests puede configurarse para trabajar con varios entornos, incluido localhost, utilizando los campos startUrl, startUrlSubstitutionRegex y resourceUrlSubstitutionRegexes. Estos campos permiten sustituir partes de la URL de inicio y de las URL de recursos en función de las expresiones regulares proporcionadas, lo que permite redirigir las solicitudes a diferentes entornos durante la ejecución del test.

Por ejemplo, puedes reutilizar el test programado en producción para ejecutarlo en tu entorno de desarrollo con startUrl y startUrlSubstitutionRegex. También puedes redirigir las solicitudes de activos del frontend a un entorno de desarrollo local mientras mantienes la página principal y las llamadas a la API que ofrece el entorno de producción. Esto es útil para probar cambios de forma aislada sin necesidad de desplegar toda la aplicación.

Para utilizar estas opciones, especifica los valores adecuados en los campos startUrl, startUrlSubstitutionRegex y resourceUrlSubstitutionRegexes. Los campos startUrl y startUrlSubstitutionRegex permiten modificar la URL inicial, mientras que el campo resourceUrlSubstitutionRegexes permite modificar las URL de todas las solicitudes de recursos posteriores.

Para resourceUrlSubstitutionRegexes, especifica una matriz de cadenas, cada una de las cuales contendrá dos partes separadas por un carácter de pipe |: <regex>|<rewriting rule>. La primera parte es la expresión regular que se aplicará a la URL del recurso, y la segunda es la expresión que reescribirá la URL.

Por ejemplo:

https://prod.my-app.com/assets/(.*)|http://localhost:3000/assets/$1

Esta expresión regular captura la ruta de la URL del recurso y la reescribe para que apunte al entorno de desarrollo local. Dada la URL https://prod.my-app.com/assets/js/chunk-123.js, la reescribiría en http://localhost:3000/assets/js/chunk-123.js.

Esta función te permite probar partes específicas de tu aplicación en diferentes entornos, incluyendo localhost, asegurándote de que los cambios se validan correctamente antes de ser desplegados en producción.

Puedes obtener más información sobre estas opciones en Probar múltiples entornos.

Referencias adicionales

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

Incorporar los tests de Datadog Continuous Testing a tu pipeline CI/CDBLOG Prueba las aplicaciones internas con el túnel de tests y las localizaciones privadas de DatodagBLOG Más información sobre Continuous Testing y CI/CDDOCUMENTACIÓN