Saltar a contenido

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_* y SKILLS_REPO_TOKEN) cargados como secrets de GitHub. Pedíselos al equipo de NEO.

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: NEO está 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

  1. Abrí un PR de prueba y ponele el label feature.
  2. En la pestaña Checks del PR tienen que aparecer Initial Setup, Feature E2E y Publish Report.
  3. Al terminar, el PR recibe un comentario con el resultado. Si se generaron archivos, en el log de feature-e2e aparece 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:

  1. Cargá los secrets de Jira o Azure DevOps en Settings → Secrets and variables → Actions.
  2. Agregalos al bloque env: del job feature-e2e en neo-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