Pruebas tras un despliegue: CI/CD y comprobaciones deep

Un despliegue correcto confirma que terminó la publicación del código. Todavía no demuestra que la aplicación atienda correctamente al usuario. Una prueba de humo puede abrir un producto y comprobar el carrito; una comprobación deep verifica una tarea en segundo plano. Ambos son escenarios DockRay para capas diferentes de la aplicación.

Ejecutar un escenario desde CI/CD

La configuración del escenario contiene la información de activación externa. Usa la clave privada de su proyecto como token Bearer. Guárdala en los secretos protegidos de la pipeline, nunca en el repositorio ni en registros públicos. La activación externa requiere la función correspondiente del plan de la cuenta.

POST /api/v1/flows/{flow}/run
Authorization: Bearer <PROJECT_PRIVATE_KEY>

Sustituye {flow} por el identificador del escenario del panel. Una respuesta 202 con queued confirma que se aceptó la solicitud, no que la prueba pasó. Lee poll_url y requested_at de la respuesta.

Cómo evitar leer un resultado antiguo

Consulta la dirección devuelta con since igual al valor recibido de requested_at, codificado correctamente para la URL. Así no confundirás una ejecución anterior con el resultado del nuevo despliegue. Los estados de espera, incluidos queued, running y pending, requieren seguir consultando. Solo passed confirma el éxito; failed indica fallo e inconclusive no ofrece un veredicto. No valores la prueba únicamente por el código HTTP o el campo success.

El parámetro wait permite esperar el resultado hasta dos minutos. delay pospone la prueba el número indicado de minutos, normalmente de 1 a 60, por ejemplo mientras se calienta la caché. Las solicitudes diferidas responden inmediatamente; no combines el retraso con una espera en la misma conexión. Gestiona los límites de frecuencia y los cupos agotados sin reintentar indefinidamente.

Qué debe devolver un endpoint deep

Implementa un endpoint HTTPS público protegido con un token que devuelva JSON. DockRay lo consulta; el código de comprobación se ejecuta en tu aplicación. Ejemplo:

{"status":"pass","message":"Import completed","steps":[{"label":"Import","status":"pass","duration_ms":12}]}

Usa pass si se cumple la condición, fail si no se cumple y skip cuando no sea posible emitir un veredicto. Define un criterio medible, como la antigüedad de la última importación correcta. No incluyas secretos ni datos de clientes en los mensajes. El token de este endpoint y la clave privada del proyecto DockRay cumplen funciones distintas.

¿Se pueden ejecutar escenarios mediante MCP?

Sí. flows.list, flows.get y flows.run permiten consultar y activar escenarios. Requieren acceso a MCP y permisos adecuados en la clave; el permiso de lectura no autoriza la ejecución. Siguen aplicándose el plan y los límites de ejecuciones.

Elige el tipo de prueba con la guía de monitorización sintética e investiga fallos con la guía de diagnóstico.