Saltar al contenido principal
Configura Raigal para evaluar pull requests en GitHub, aplicar protección de ramas y supervisar el estado de cada cambio en el panel web de app.raigal.dev.

Arquitectura: GitHub App y Actions

Raigal combina la GitHub App oficial (raigal-cloud) con tus flujos de trabajo de GitHub Actions:
Funcionamiento de este modelo:
  • Análisis de código en local: La evaluación de reglas se ejecuta íntegramente en el runner de CI. Raigal Cloud no clona ni almacena tu código.
  • Comprobación pendiente de inmediato: Al abrir o actualizar un PR, la app registra una comprobación "Raigal Quality Gate" en estado in_progress en el commit correspondiente.
  • Actualización con resumen: Cuando el runner envía los resultados a /v1/runs, Raigal Cloud empareja el commit SHA y publica un informe markdown completo.
  • Protección de ramas: Puedes marcar "Raigal Quality Gate" como requisito obligatorio en las reglas de ramas de GitHub.
  • Actualización automática al fusionar o cerrar: GitHub envía los eventos directamente a la app, actualizando el tablero sin scripts adicionales.
  • Tiempo límite de seguridad: Si un trabajo de CI se cancela o falla antes de ejecutar raigal ci, Raigal Cloud limpia automáticamente las comprobaciones pendientes tras 20 minutos para no bloquear pull requests.

Configuración: GitHub App y Actions

1

1. Instala la GitHub App de Raigal

  1. Abre la GitHub App oficial de Raigal.
  2. Pulsa en Install.
  3. Elige tu organización o cuenta personal de GitHub.
  4. Selecciona todos los repositorios o los que quieras proteger.
  5. Confirma con Install & authorize.
2

2. Obtén el token de la organización

  1. Entra en tu panel en app.raigal.dev.
  2. Abre Settings.
  3. En API Tokens, pulsa en Create new token.
  4. Asigna un nombre al token (por ejemplo: ci-runner) y copia la clave generada (rgl_live_...).
3

3. Guarda el secreto en el repositorio

  1. En tu repositorio de GitHub, ve a Settings > Secrets and variables > Actions.
  2. Pulsa en New repository secret.
  3. Nombre: RAIGAL_TOKEN.
  4. Valor: pega la clave rgl_live_....
  5. Guarda con Add secret.
Si no deseas gestionar claves estáticas, configura permissions: id-token: write en tu flujo. Raigal Cloud autenticará al runner mediante OIDC criptográfico de GitHub.
4

4. Añade el flujo de GitHub Actions

Crea el archivo .github/workflows/raigal.yml en tu repositorio:
Como la GitHub App recibe los eventos de cierre directamente, no necesitas ningún flujo extra para notificar a Raigal cuando se cierra un PR.
5

5. Activa el estado obligatorio en la protección de ramas

  1. En tu repositorio de GitHub, entra en Settings > Branches (o Rules > Rulesets).
  2. En las reglas de tu rama principal (main), activa Require status checks to pass before merging.
  3. Busca y marca Raigal Quality Gate.
  4. Guarda los cambios.

Veredictos del control de calidad (3 estados)

Las comprobaciones en pull requests devuelven tres estados claros:

Modo CI independiente (sin GitHub App)

Si las políticas de tu empresa impiden instalar aplicaciones de GitHub de terceros, puedes usar Raigal únicamente con GitHub Actions:
1

1. Configura el secreto

En Settings > Secrets and variables > Actions, añade RAIGAL_TOKEN.
2

2. Añade el flujo de trabajo

Crea .github/workflows/raigal.yml con el archivo YAML anterior. En modo independiente, el resultado se notifica como un paso habitual de Actions.
3

3. Añade la sincronización de cierre (opcional)

Para actualizar el tablero al cerrar ramas sin la GitHub App, añade este flujo:

Seguimiento de PRs en el panel web

En Raigal Cloud, abre el panel de tu proyecto:
  1. Columna de pull requests:
    • Aprobados: muestra la nota obtenida (por ejemplo: 94/100), autor, rama origen y rama destino.
    • Bloqueados: muestra el número de problemas críticos y categorías de reglas que han fallado.
  2. Panel de inspección lateral:
    • Pulsa sobre una tarjeta para abrir su vista detallada.
    • Revisa las reglas incumplidas, archivos y líneas exactas.
    • Revisa las estadísticas del diff y la previsualización del parche unificado.
    • Copia el comando git checkout para revisar los cambios en local o pulsa Open on GitHub para ir directo al pull request.

Resolución de incidencias