Organización

​

Resumen de configuración

​

1. Crea el espacio de trabajo de tu organización

1. Entra en app.raigal.dev.
2. Inicia sesión con GitHub, Google o tu correo corporativo.
3. Abre el menú de organizaciones en la esquina superior derecha y selecciona Crear organización (o entra en una existente).
4. Escribe el nombre de tu empresa u organización (por ejemplo: Acme Corp).
5. Tu espacio de trabajo se creará al instante con 14 días de prueba activos.

​

2. Instala la GitHub App de Raigal

1. En el panel de Raigal Cloud, ve a Settings y pulsa en Sync GitHub accounts (o entra directamente en github.com/apps/raigal-cloud).
2. Pulsa en Install app.
3. Selecciona tu organización o cuenta personal de GitHub.
4. Elige All repositories o selecciona únicamente los repositorios que quieras revisar.
5. Confirma con Install & authorize.

​

3. Obtén el token de API de tu organización

1. Entra en app.raigal.dev/settings.
2. En la sección API Tokens, busca la tarjeta Active organization token y copia tu clave (rgl_live_...).
3. Para crear una clave propia para CI, pulsa Create new token, dale un nombre reconocible (por ejemplo: github-actions-ci) y copia el token generado.

​

4. Añade el flujo de GitHub Actions

name: Raigal quality gate

on:
  push:
    branches: [main, master, develop]
  pull_request:
    branches: [main, master, develop]

permissions:
  contents: read
  id-token: write        # Autenticación OIDC criptográfica sin secretos fijos
  security-events: write # Necesario si exportas informes SARIF a GitHub Code Scanning

jobs:
  quality-gate:
    name: Code quality gate
    runs-on: ubuntu-latest

    steps:
      - name: Descargar código
        uses: actions/checkout@v4
        with:
          fetch-depth: 0 # Historial completo necesario para calcular diffs con la rama base

      - name: Configurar Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 22

      - name: Ejecutar control de calidad
        env:
          RAIGAL_TOKEN: ${{ secrets.RAIGAL_TOKEN }}
          # RAIGAL_ORG_ID: ${{ vars.RAIGAL_ORG_ID }} # Necesario solo si el propietario pertenece a varias organizaciones
        run: |
          if [ "${{ github.event_name }}" = "pull_request" ]; then
            git fetch origin ${{ github.base_ref }} --depth=1
            npx --yes @methiu/raigal@latest ci --changes --base origin/${{ github.base_ref }}
          else
            npx --yes @methiu/raigal@latest ci .
          fi

      - name: Generar informe de seguridad SARIF (opcional)
        if: always()
        run: npx --yes @methiu/raigal@latest scan . --sarif > raigal-results.sarif

      - name: Subir SARIF a GitHub Code Scanning (opcional)
        if: always() && github.event.pull_request.head.repo.full_name == github.repository
        uses: github/codeql-action/upload-sarif@v3
        continue-on-error: true
        with:
          sarif_file: raigal-results.sarif
          category: raigal

​

Guarda el secreto en GitHub:

1. En tu repositorio de GitHub, entra en Settings > Secrets and variables > Actions.
2. Pulsa en New repository secret.
3. Nombre: RAIGAL_TOKEN.
4. Valor: pega tu clave rgl_live_....
5. Confirma con Add secret.

​

5. Comprueba tu primer análisis

1. Escaneo en pull request: Abre un pull request en tu repositorio.
   • La GitHub App de Raigal crea al instante una comprobación pendiente llamada Raigal quality gate.
   • El runner de GitHub Actions ejecuta raigal ci --changes --base origin/<base>.
   • La comprobación termina con un resumen con la nota (0-100), el número de incidencias y el desglose de reglas.
   • Aparece la tarjeta correspondiente en tu panel de Raigal Cloud en la pestaña Pull Requests.
2. Escaneo en la rama principal: Haz push de un commit a main (o fusiona el pull request).
   • El flujo ejecuta un escaneo completo (raigal ci .).
   • La nota base del repositorio y los problemas activos se actualizan en las pestañas Errors y Warnings de app.raigal.dev.

​

6. Invita a tu equipo

1. En Raigal Cloud, ve a Settings > Members.
2. Pulsa en Invite member y escribe el correo de tu compañero.
3. Elige el rol:
   • Admin: Control total para vincular repositorios, tokens de API, facturación y miembros.
   • Member: Acceso para ver repositorios, inspeccionar incidencias y revisar pull requests.
4. Tu compañero recibirá un correo con el enlace para unirse al espacio de trabajo.

​

Configuración local para desarrolladores

# Inicia sesión desde el terminal mediante el navegador
npx @methiu/raigal login

# Comprueba la organización activa y repositorios autorizados
npx @methiu/raigal whoami

# Verifica las herramientas locales y motores instalados
npx @methiu/raigal doctor

# Lanza un escaneo local completo
npx @methiu/raigal scan .

# Aplica correcciones automáticas seguras
npx @methiu/raigal fix .

# Instala los hooks de intercepción para asistentes
npx @methiu/raigal hook install --claude

​

Resolución de incidencias habituales