Construcciones Multietapa Allure 3

La funcionalidad de Construcciones Multietapa añadida en Allure Report 3 te permite crear reportes unificados desde múltiples fuentes de datos de ejecución de pruebas. En lugar de generar reportes individuales para cada etapa de un pipeline de pruebas complejo con múltiples ejecuciones de pruebas y/o múltiples entornos de prueba, puedes guardar el estado completo de cada etapa como un archivo de etapa (un archivo .zip con todos los datos de ejecución de pruebas), y luego construir un único reporte desde la colección resultante de archivos.

Casos de uso típicos

Construcción de reportes unificados desde:

• ejecuciones de pruebas en diferentes entornos y contextos
• pipelines de pruebas multietapa, donde cada etapa requiere una ejecución de prueba separada
• configuraciones de CI/CD que involucran algunos o todos los casos anteriores

Qué es un archivo de etapa

Un archivo de etapa almacena todos los resultados de pruebas generados por la integración de Allure - todo lo que encontrarías en una carpeta de resultados regular - en un formato optimizado.

Además de eso, captura el estado completo de la ejecución, que incluye datos importantes producidos por el propio Allure Report 3 - datos que normalmente no van en la carpeta de resultados.

Por esta razón, recopilar manualmente archivos de resultados de múltiples ejecuciones de pruebas y construir un único reporte a partir de ellos no te daría el mismo nivel de detalle que un reporte construido a partir de una colección de archivos de etapa.

Esto es lo que los archivos de etapa guardan y las carpetas de resultados no:

• Marcas de inestabilidad de pruebas: si un archivo de historial está disponible durante la ejecución de pruebas, Allure identificará pruebas nuevas, corregidas, regresadas, defectuosas y variables y almacenará esta información en el archivo de etapa.

• Compuertas de calidad: si la ejecución de pruebas falló alguna regla de compuerta de calidad que definiste para tu proyecto, los detalles se guardan en el archivo.

• Gestión de problemas conocidos: si un archivo de problemas conocidos está configurado durante la ejecución de pruebas, el archivo almacenará esa información.

• Gestión de entornos: si configuraste entornos, ya sea mediante el archivo de configuración o mediante el comando allure run --environment ..., esta información también se guarda.

• Errores globales y adjuntos globales: si algo salió mal a nivel del sistema durante la ejecución de pruebas, la salida del terminal y el registro de errores se guardan en el archivo.

Cualquier reporte construido a partir de dichos archivos de etapa incluye todos estos datos.

Construcción de reportes multietapa

Para crear un archivo de etapa, usa el comando envolvente allure run al ejecutar tus pruebas.

1. Guarda el estado completo de tu ejecución en el archivo stage1.zip de la siguiente manera:

allure run --stage=stage_1 -- <comando de prueba>

Por ejemplo, si npm es tu ejecutor de pruebas:

allure run --stage=stage_1 -- npm test

2. Genera un reporte unificado desde todos los archivos de etapa que coincidan con el patrón stage_*.zip:

allure generate --stage=stage_*.zip

3. Abre el reporte resultante con:

allure open

Entornos en reportes multietapa

Los entornos están completamente integrados con los archivos de etapa, y son el caso de uso principal previsto para esta funcionalidad: puedes ejecutar tus pruebas en entornos completamente diferentes, guardar estados completos de ejecución de pruebas y crear reportes unificados que utilicen todas las nuevas características avanzadas de Allure Report 3.

Por favor, consulta la documentación de Entornos para un ejemplo detallado de cómo usar estas funcionalidades juntas.