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
NEOoreport, 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-stackyui-selector-repairasumen que el código de la interfaz está ensrc/components/ysrc/pages/y que la rama de integración se llamadevelop. Si tu repositorio usa otra estructura u otra rama, cambiá esasrulesen 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:
- Crea la rama
feature-new-end-to-end/<número del MR>con esos archivos. - 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-e2ese 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_REGISTRYy$CI_JOB_TOKEN, porque están en la misma instancia de GitLab de Crowdar. Tu proyecto tiene que tener acceso alippia/products/neo/crowdar-qa-skillsy al registry decrowdar-engine-mvp.
Paso 3 — Crear el label
En GitLab: Manage → Labels → New label → nombre feature.
La regla busca el texto
featuredentro de los labels del MR, así que un label comofeature-requesttambién lo dispara.
Paso 4 — Probar
- Abrí un MR de prueba y ponele el label
feature. - En la pestaña Pipelines del MR tienen que aparecer
feature-e2eypublish-report. - 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 |