GitHub Actions

Requisitos

• ●Un repositorio de GitHub donde puedas editar workflows y la configuración
• ●El token de tu organización (InfiniAnalytics → Organización → Tokens)
• ●El ID del automatismo que recibirá los eventos (ábrelo desde Procesos y copia su ID)

1. Guarda tus credenciales en GitHub

El workflow lee el token y el ID del automatismo de la configuración del repositorio, así nunca aparecen en tu código.

1. 1

   Abre la configuración del repositorio

   En tu repositorio de GitHub, ve a Settings → Secrets and variables → Actions.

2. 2

   Añade el token como secret

   En la pestaña "Secrets", pulsa "New repository secret". Llámalo INFINI_TOKEN y pega el token de tu organización como valor.

3. 3

   Añade el ID del automatismo como variable

   En la pestaña "Variables", pulsa "New repository variable". Llámala INFINI_AUTOMATION_ID y pega el ID del automatismo como valor.

2. Crea el workflow

1. 1

   Crea el archivo del workflow

   En tu repositorio, crea este archivo (el nombre puede ser cualquiera, la carpeta no): .github/workflows/infinianalytics.yml

2. 2

   Pega el workflow de abajo

   Copia el bloque completo de abajo en el archivo. Ya incluye los pasos START, EVENT, END y ERROR.

3. 3

   Sustituye los pasos de ejemplo por los tuyos

   Cambia los pasos "Build" y "Test" que hay entre los dos comentarios marcadores por tus pasos reales. Deja START como primer paso y END/ERROR como los dos últimos. El paso EVENT es opcional: muévelo, duplícalo o bórralo.

4. 4

   Haz commit y ejecútalo

   Haz commit del archivo. Se ejecuta en cada push a main, o a mano desde la pestaña Actions → "My pipeline" → "Run workflow". La ejecución aparece en InfiniAnalytics en unos segundos.

name: 'My pipeline'

on:
  push:
    branches: [main]
  workflow_dispatch:

permissions:
  contents: read

jobs:
  pipeline:
    runs-on: ubuntu-latest
    steps:
      # Tell InfiniAnalytics the execution has started
      - name: InfiniAnalytics - START
        uses: InfiniWorkspace/infinianalytics-github-action@main
        with:
          token: ${{ secrets.INFINI_TOKEN }}
          automation_id: ${{ vars.INFINI_AUTOMATION_ID }}
          event: START
          description: 'Pipeline started on ${{ github.ref_name }}'

      # ── Your own steps go here ──────────────────────────────
      - uses: actions/checkout@v4

      - name: Build
        run: echo "Replace with your build command"

      # Optional: checkpoint in the middle of the run
      - name: InfiniAnalytics - EVENT
        uses: InfiniWorkspace/infinianalytics-github-action@main
        with:
          token: ${{ secrets.INFINI_TOKEN }}
          automation_id: ${{ vars.INFINI_AUTOMATION_ID }}
          event: EVENT
          description: 'Build finished'

      - name: Test
        run: echo "Replace with your test command"
      # ────────────────────────────────────────────────────────

      # Every previous step succeeded
      - name: InfiniAnalytics - END
        if: success()
        uses: InfiniWorkspace/infinianalytics-github-action@main
        with:
          token: ${{ secrets.INFINI_TOKEN }}
          automation_id: ${{ vars.INFINI_AUTOMATION_ID }}
          event: END
          description: 'Pipeline finished successfully'

      # A previous step failed or the run was cancelled
      - name: InfiniAnalytics - ERROR
        if: failure() || cancelled()
        uses: InfiniWorkspace/infinianalytics-github-action@main
        with:
          token: ${{ secrets.INFINI_TOKEN }}
          automation_id: ${{ vars.INFINI_AUTOMATION_ID }}
          event: ERROR
          error_id: ${{ job.status == 'cancelled' && 'PIPELINE_CANCELLED' || 'PIPELINE_FAILED' }}
          error_description: 'Job ${{ github.job }} ended with status ${{ job.status }}. Logs: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}'

¿Ya tienes un workflow?

No necesitas un workflow nuevo: añade estos bloques al job que quieras seguir, después de guardar las credenciales del paso 1.

1. 1

   Pega START como primer paso

   Justo debajo de steps: en tu job, antes de cualquier otro paso:

   yamlCopy

         # Tell InfiniAnalytics the execution has started
         - name: InfiniAnalytics - START
           uses: InfiniWorkspace/infinianalytics-github-action@main
           with:
             token: ${{ secrets.INFINI_TOKEN }}
             automation_id: ${{ vars.INFINI_AUTOMATION_ID }}
             event: START
             description: 'Pipeline started on ${{ github.ref_name }}'

2. 2

   Opcional: pega EVENT entre tus pasos

   Donde quieras un punto de control, por ejemplo después del build. Cambia la descripción para indicar qué acaba de pasar.

   yamlCopy

         # Optional: checkpoint in the middle of the run
         - name: InfiniAnalytics - EVENT
           uses: InfiniWorkspace/infinianalytics-github-action@main
           with:
             token: ${{ secrets.INFINI_TOKEN }}
             automation_id: ${{ vars.INFINI_AUTOMATION_ID }}
             event: EVENT
             description: 'Build finished'

3. 3

   Pega END y ERROR como los dos últimos pasos

   Al final del todo del job. Solo se ejecuta uno de los dos: END si todo ha ido bien, ERROR si algo ha fallado o se ha cancelado la ejecución.

   yamlCopy

         # Every previous step succeeded
         - name: InfiniAnalytics - END
           if: success()
           uses: InfiniWorkspace/infinianalytics-github-action@main
           with:
             token: ${{ secrets.INFINI_TOKEN }}
             automation_id: ${{ vars.INFINI_AUTOMATION_ID }}
             event: END
             description: 'Pipeline finished successfully'
   
         # A previous step failed or the run was cancelled
         - name: InfiniAnalytics - ERROR
           if: failure() || cancelled()
           uses: InfiniWorkspace/infinianalytics-github-action@main
           with:
             token: ${{ secrets.INFINI_TOKEN }}
             automation_id: ${{ vars.INFINI_AUTOMATION_ID }}
             event: ERROR
             error_id: ${{ job.status == 'cancelled' && 'PIPELINE_CANCELLED' || 'PIPELINE_FAILED' }}
             error_description: 'Job ${{ github.job }} ended with status ${{ job.status }}. Logs: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}'

Cómo funciona

El patrón funciona como un try/except: el job sigue saliendo en rojo cuando un paso falla, pero antes el fallo queda registrado en InfiniAnalytics.

Parámetros de entrada

Salidas

Dale al paso un id y lee sus salidas en pasos posteriores, por ejemplo ${{ steps.<id>.outputs.success }}.

Consejos

          execution_id: ${{ github.run_id }}-${{ github.run_attempt }}-${{ matrix.os }}