Configurar GitHub Actions
Estado: ⚠️ Funciona: se dispara solo cuando un PR tiene el label feature y comenta el resultado. Pero no abre automáticamente el PR con los resultados: sube la rama y el PR hay que abrirlo a mano.
Valor en qa-stack.yaml |
stack.pipeline_provider: github |
| Archivo de entrada | .github/workflows/qa.yml (o .github/workflows/neo-ci-jobs.yml si qa.yml ya existía) |
Archivos de NEO |
.github/workflows/neo-ci-jobs/neo-ci-manager.yml |
| Cómo se dispara | Pull Request con el label feature |
| Imagen | registry.gitlab.crowdaronline.com/lippia/products/neo/crowdar-engine-mvp:c4cd2740-playwright (registry privado) |
1. Qué genera lippia-neo-ci-bootstrap
| Archivo | Qué contiene |
|---|---|
.github/workflows/qa.yml |
La entrada: se dispara en los PR y llama al manager con uses: + secrets: inherit |
.github/workflows/neo-ci-jobs/neo-ci-manager.yml |
Un workflow reutilizable con los jobs de NEO |
La entrada generada:
name: QA — playwright
on:
pull_request:
types: [opened, labeled, reopened, synchronize]
jobs:
neo-ci:
uses: ./.github/workflows/neo-ci-jobs/neo-ci-manager.yml
secrets: inherit
Si ya tenías un .github/workflows/qa.yml propio, no se toca: la entrada de NEO se escribe como .github/workflows/neo-ci-jobs.yml. GitHub ejecuta cada workflow por separado, así que no hace falta fusionar nada.
2. Los jobs
| Job | Qué hace |
|---|---|
initial-setup |
Detecta el framework desde qa-stack.yaml e instala dependencias (y deja la caché lista) |
feature-e2e |
Clona las skills, escribe .env.tests, lee el PR (neo event), ejecuta el plan feature-new-end-to-end y sube los resultados a una rama |
publish-report |
Comenta el resultado en el PR. Ejecuta siempre, aunque feature-e2e falle |
Los tres se ejecutan solo si el PR tiene el label feature: al abrirlo, al ponerle el label, al reabrirlo y en cada push (synchronize).
3. Paso a paso
Paso 1 — Generar los archivos
Con qa-stack.yaml ya creado (pipeline_provider: github), pedile al asistente:
Generá el CI del proyecto con lippia-neo-ci-bootstrap
Revisá los archivos generados y hacé commit.
Paso 2 — Cargar los secrets
En GitHub: Settings → Secrets and variables → Actions → New repository secret.
| Secret | Para qué |
|---|---|
CROWDAR_REGISTRY_USER |
Usuario para descargar la imagen crowdar-engine-mvp del registry de GitLab de Crowdar |
CROWDAR_REGISTRY_TOKEN |
Token de ese usuario, con permiso de lectura del registry |
SKILLS_REPO_TOKEN |
Token con lectura del repositorio neo-releases, que está en GitLab |
ANTHROPIC_API_KEY |
Modelos de Claude |
OPENAI_API_KEY |
Modelos de OpenAI, si el plan los usa |
CROWDAR_CI_TOKEN |
Comentar en el PR y subir la rama de resultados |
APP_USER / APP_PASSWORD |
Usuario de prueba de la app |
APP_BASE_URL |
URL de la app bajo prueba |
Las skills y la imagen viven en el GitLab de Crowdar, no en GitHub. Por eso hacen falta tokens de GitLab (
CROWDAR_REGISTRY_*ySKILLS_REPO_TOKEN) cargados como secrets de GitHub. Pedíselos al equipo deNEO.PRs desde forks: GitHub no pasa los secrets a los workflows que se disparan desde un fork. En ese caso los jobs fallan por credenciales vacías:
NEOestá pensado para PRs del mismo repositorio.
Paso 3 — Crear el label
En GitHub: Issues → Labels → New label → nombre feature. (La condición busca exactamente feature.)
Paso 4 — Probar
- Abrí un PR de prueba y ponele el label
feature. - En la pestaña Checks del PR tienen que aparecer
Initial Setup,Feature E2EyPublish Report. - Al terminar, el PR recibe un comentario con el resultado. Si se generaron archivos, en el log de
feature-e2eaparece la rama que se subió: abrí el PR de resultados a mano desde esa rama.
4. Si las historias vienen de Jira o Azure DevOps
⚠️ Limitación actual: el job feature-e2e generado solo pasa al engine ANTHROPIC_API_KEY, OPENAI_API_KEY y CROWDAR_CI_TOKEN. No pasa las variables de Jira ni de Azure DevOps, así que con user_stories_storage.type: cloud el servidor MCP no puede autenticarse.
Para resolverlo:
- Cargá los secrets de Jira o Azure DevOps en Settings → Secrets and variables → Actions.
- Agregalos al bloque
env:del jobfeature-e2eenneo-ci-manager.yml:
env:
# ...las que ya están...
JIRA_URL: ${{ secrets.JIRA_URL }}
JIRA_USERNAME: ${{ secrets.JIRA_USERNAME }}
JIRA_API_TOKEN: ${{ secrets.JIRA_API_TOKEN }}
CONFLUENCE_URL: ${{ secrets.CONFLUENCE_URL }}
CONFLUENCE_USERNAME: ${{ secrets.CONFLUENCE_USERNAME }}
CONFLUENCE_API_TOKEN: ${{ secrets.CONFLUENCE_API_TOKEN }}
# o, para Azure DevOps:
# AZURE_DEVOPS_ORG_URL: ${{ secrets.AZURE_DEVOPS_ORG_URL }}
# AZURE_DEVOPS_AUTH_METHOD: pat
# AZURE_DEVOPS_PAT: ${{ secrets.AZURE_DEVOPS_PAT }}
Si volvés a ejecutar
lippia-neo-ci-bootstrap, revisá que este cambio no se pierda.
5. Problemas comunes (y qué hacer)
| Lo que ves | Por qué puede pasar | Qué hacer |
|---|---|---|
| Los jobs aparecen como skipped | El PR no tiene el label feature |
Poner el label |
Error response from daemon: unauthorized al iniciar el contenedor |
CROWDAR_REGISTRY_USER / CROWDAR_REGISTRY_TOKEN faltan o no tienen acceso al registry |
Revisar los secrets |
Falla Clone crowdar-qa-skills |
SKILLS_REPO_TOKEN falta o no tiene lectura del repositorio |
Revisar el secret |
| Las credenciales llegan vacías | El PR viene de un fork, o falta secrets: inherit en la entrada |
Usar ramas del mismo repositorio; revisar qa.yml |
| No se abre el PR de resultados | Limitación conocida: GitHub no tiene un equivalente a merge_request.create de GitLab |
Abrir el PR a mano desde la rama que sube el job |
| El plan no puede leer la historia de Jira / Azure | El job no recibe esas variables | Ver la sección 4 |
| No se puede comentar en el PR | CROWDAR_CI_TOKEN sin permisos sobre el repositorio |
Revisar el token |