Saltar a contenido

Configurar GitLab CI

Estado: ✅ Es la integración más completa. El pipeline se dispara solo cuando un MR tiene el label feature, guarda los resultados en un MR nuevo y comenta el resultado en el MR original.

Valor en qa-stack.yaml stack.pipeline_provider: gitlab
Archivo de entrada .gitlab-ci.yml
Archivos de NEO .gitlab/neo-ci-jobs/
Cómo se dispara Merge Request con el label feature
Imagen $CI_REGISTRY/lippia/products/neo/crowdar-engine-mvp:c4cd2740-playwright

1. Qué genera lippia-neo-ci-bootstrap

Si el repositorio no tiene .gitlab-ci.yml

Archivo Qué contiene
.gitlab-ci.yml Solo el include: hacia el manager de NEO
.gitlab/neo-ci-jobs/NeoCiManager.yml Stages, variables, bloques comunes y el job publish-report. Incluye los tres archivos de abajo
.gitlab/neo-ci-jobs/FeatureNewEndToEnd.yml El job feature-e2e (plan feature-new-end-to-end)
.gitlab/neo-ci-jobs/QaReadStack.yml El job qa-read-stack (lee las rutas de qa-stack.yaml)
.gitlab/neo-ci-jobs/UiSelectorRepair.yml El job ui-selector-repair (plan ui-selector-repair)

El .gitlab-ci.yml generado queda así:

# lippia-neo: incluye los test jobs
include:
  - local: '.gitlab/neo-ci-jobs/NeoCiManager.yml'

Los cinco archivos tienen que estar en esas rutas exactas. Si falta uno, GitLab no encuentra el include: y el pipeline no arranca.

Si el repositorio ya tiene .gitlab-ci.yml

lippia-neo-ci-bootstrap no lo reemplaza. Copia la carpeta .gitlab/neo-ci-jobs/ y agrega a tu .gitlab-ci.yml solamente:

# lippia-neo: incluye los test jobs
include:
  - local: '.gitlab/neo-ci-jobs/NeoCiManager.yml'

Si tu archivo ya tenía un bloque include:, la línea se suma a esa lista: GitLab admite un solo include: por archivo.

Si ya usás un stage llamado NEO o report, o jobs con los mismos nombres (feature-e2e, publish-report…), revisá que no choquen.


2. Los jobs

Stage Job Qué hace Cuándo ejecuta
NEO feature-e2e Clona las skills, detecta el framework e instala dependencias, escribe .env.tests, ejecuta el plan feature-new-end-to-end y sube los resultados a una rama nueva con su MR En un MR con el label feature (al abrirlo y en cada push)
report publish-report Comenta el resultado en el MR. Ejecuta siempre, aunque feature-e2e falle Mismo criterio que feature-e2e
NEO qa-read-stack Lee las rutas de qa-stack.yaml y las publica para los jobs siguientes Push a la rama develop que cambie archivos de src/components/ o src/pages/
NEO ui-selector-repair Ejecuta el plan ui-selector-repair, que repara selectores de tests a partir del diff del push Mismo criterio que qa-read-stack

Ajustá los disparadores a tu proyecto. qa-read-stack y ui-selector-repair asumen que el código de la interfaz está en src/components/ y src/pages/ y que la rama de integración se llama develop. Si tu repositorio usa otra estructura u otra rama, cambiá esas rules en los archivos generados.

Qué pasa con los resultados

Si el plan termina bien y generó archivos (planes, tests o reportes en las carpetas de qa-stack.yaml), feature-e2e:

  1. Crea la rama feature-new-end-to-end/<número del MR> con esos archivos.
  2. Abre un MR nuevo hacia la rama de tu MR, titulado "Neo: Results of feature-new-end-to-end plan for <tu rama>".

Así revisás lo que generó NEO antes de sumarlo a tu rama. Si no hubo cambios, deja el mensaje Nothing to persist.


3. Paso a paso

Paso 1 — Generar los archivos

Con qa-stack.yaml ya creado (pipeline_provider: gitlab), pedile al asistente:

Generá el CI del proyecto con lippia-neo-ci-bootstrap

Revisá los archivos generados y hacé commit.

Paso 2 — Cargar las variables

En GitLab: Settings → CI/CD → Variables → Add variable.

Variable Tipo / opciones Para qué
ANTHROPIC_API_KEY Masked Modelos de Claude
OPENAI_API_KEY Masked Modelos de OpenAI, si el plan los usa (ui-selector-repair usa openai/gpt-5.4)
CROWDAR_CI_TOKEN Masked Comentar en el MR, y subir la rama y abrir el MR de resultados
APP_USER Variable Usuario de prueba de la app
APP_PASSWORD Masked Contraseña de prueba
APP_BASE_URL Variable URL de la app bajo prueba

Si las historias vienen de Jira, agregá JIRA_URL, JIRA_USERNAME, JIRA_API_TOKEN (Masked), CONFLUENCE_URL, CONFLUENCE_USERNAME y CONFLUENCE_API_TOKEN (Masked). Si vienen de Azure DevOps, agregá AZURE_DEVOPS_ORG_URL, AZURE_DEVOPS_AUTH_METHOD (= pat), AZURE_DEVOPS_PAT (Masked) y, opcionalmente, AZURE_DEVOPS_DEFAULT_PROJECT. Los valores son los mismos que en Jira y Azure DevOps.

⚠️ Cuidado con "Protect variable". Una variable protegida solo llega a los pipelines de ramas o tags protegidos. Como feature-e2e se ejecuta en el pipeline de un MR de una rama de feature, si marcás las variables como protegidas el job no las ve y falla por credenciales vacías.

CROWDAR_CI_TOKEN: tiene que poder comentar en MRs, pushear una rama y abrir un MR. Por ejemplo, un Project access token con los permisos api y write_repository. Si la rama de destino está protegida contra push, el MR de resultados no se puede crear (el job lo avisa y sigue).

No hace falta cargar credenciales para la imagen ni para clonar las skills: se usan $CI_REGISTRY y $CI_JOB_TOKEN, porque están en la misma instancia de GitLab de Crowdar. Tu proyecto tiene que tener acceso a lippia/products/neo/crowdar-qa-skills y al registry de crowdar-engine-mvp.

Paso 3 — Crear el label

En GitLab: Manage → Labels → New label → nombre feature.

La regla busca el texto feature dentro de los labels del MR, así que un label como feature-request también lo dispara.

Paso 4 — Probar

  1. Abrí un MR de prueba y ponele el label feature.
  2. En la pestaña Pipelines del MR tienen que aparecer feature-e2e y publish-report.
  3. Al terminar, el MR recibe un comentario con el resultado y, si se generaron archivos, aparece el MR de resultados.

4. Problemas comunes (y qué hacer)

Lo que ves Por qué puede pasar Qué hacer
El pipeline no se ejecuta al poner el label El pipeline no es de tipo merge request, o el label no contiene feature Revisar el label; quitarlo y volver a ponerlo, o hacer un push nuevo
Error de YAML: include no encontrado Falta alguno de los archivos de .gitlab/neo-ci-jobs/ o cambió el nombre Volver a generar con lippia-neo-ci-bootstrap y commitear los cinco archivos
Error de YAML en ui-selector-repair: referencia .setup-test-framework desconocida UiSelectorRepair.yml referencia un bloque .setup-test-framework que no está definido en NeoCiManager.yml Es un problema conocido de la plantilla. Si no usás ui-selector-repair, quitá su include de NeoCiManager.yml; si lo usás, avisá al equipo de NEO
No se puede descargar la imagen crowdar-engine-mvp El proyecto no tiene acceso al registry de Crowdar Pedir acceso al proyecto crowdar-engine-mvp
Falla el git clone de las skills El CI_JOB_TOKEN del proyecto no tiene acceso a crowdar-qa-skills Pedir que agreguen tu proyecto a la allowlist de tokens del repositorio de skills
Las credenciales llegan vacías Variables marcadas como Protected en un pipeline de MR Desmarcar Protect variable
could not push/open the report MR CROWDAR_CI_TOKEN sin permisos, o rama protegida Revisar los permisos del token
could not post the MR comment CROWDAR_CI_TOKEN sin permiso api Revisar el token
El job reinstala todo en cada ejecución La caché distribuida del runner no está disponible No es un error: es más lento, pero funciona igual