Runner Forgejo Actions (OPS): Ejecución de workflows en forgejo-runner v12.13.2

Descripción técnica

Versión: forgejo-runner v12.13.2
Localización: OPS (Hetzner crearack-ops)
Tipo de instalación: Servicio systemd con usuario propio (forgejo-runner)
Concurrencia: 1 (sin sobrecargar el host; los jobs son secuenciales)

Runner que ejecuta los workflows de Forgejo Actions en paralelo con GitHub Actions durante F1 de la migración.

Configuración

Etiquetas registradas

• Modo contenedor (jobs en act/Docker):

  • ubuntu-latest
  • docker

• Modo host (jobs nativos con Docker en el host):

  • self-hosted
  • hetzner

Los jobs especifican qué etiqueta necesitan; el runner ejecuta según su capacidad.

Ejemplo de selector

jobs:
  build:
    runs-on: [ubuntu-latest, docker]  # Job en contenedor
  
  infra:
    runs-on: [self-hosted, hetzner]   # Job en host

Ciclo de vida

1. Provisión (08-08-2026): Instalación estándar de forgejo-runner, registrado contra la instancia Forgejo en OPS
2. Inicio automático: Systemd arranca el servicio al boot
3. Sincronización: Cada 5 s, poll de nuevos jobs desde Forgejo
4. Ejecución secuencial: Máximo 1 job en ejecución (concurrencia = 1)
5. Logs: Almacenados en /var/log/forgejo-runner/ (rotación estándar)

Smoke tests (08-08-2026)

✅ Ejecución en modo contenedor (ubuntu-latest)
✅ Ejecución en modo host (self-hosted)
✅ Incógnita resuelta: el espejo dispara push workflows correctamente

Decisión de versión: v12.13.2 (no v13)

La v13 de forgejo-runner salió hace ~5 días (en el momento de F1). Se mantiene v12.13.2 porque:

• Línea probada en producción
• Menos riesgo de regresiones en F1 crítica
• Upgrade a v13 es tarea posterior (si no hay regresiones)

Relación con Forgejo en OPS

El runner comunica con la instancia Forgejo de OPS (puerto 3000, localhost), no con la de GitHub.

Véase también

• [[feature—infra—forgejo-f1-automatizaciones-paralelo]]
• [[concept—infra—ops-server]]
• [[entity—public—forgejo-espejo-releases]]
• [[entity—public—forgejo-backup-cron]]