¿Qué es Forgejo Runner?
Forgejo Runner es el runner de CI para Forgejo Actions. Es un daemon ligero que se conecta a tu instancia de Forgejo, recoge los trabajos de workflow en cola y los ejecuta en tu propia infraestructura — usando Docker, LXC o directamente el host — dándote un pipeline de CI/CD totalmente autoalojado y compatible con GitHub Actions.
🚀 Por qué importan las últimas versiones: El runner sigue de cerca los lanzamientos de Forgejo, añadiendo soporte para nuevas funciones de workflow, mejor aislamiento y correcciones de errores. Mantenerlo actualizado garantiza compatibilidad con las últimas capacidades de Forgejo Actions.
⚡ Características clave de Forgejo Runner
🔁 Compatible con Actions
Ejecuta workflows usando la misma sintaxis y ecosistema de acciones que GitHub Actions.
🐳 Ejecución flexible
Ejecuta trabajos en contenedores Docker, LXC o directamente en la máquina host.
🔐 Autoalojado
Mantén todo tu CI/CD en tu propia infraestructura, sin dependencia de terceros.
⚖️ Escalable
Registra varios runners con etiquetas para distribuir y dirigir las cargas de trabajo.
🎯 ¿Por qué Forgejo Runner?
- Controla tu CI: Ejecuta pipelines en hardware que tú controlas
- Ecosistema de Actions: Reutiliza definiciones de workflow existentes al estilo GitHub
- Aislamiento flexible: Ejecución en Docker, LXC o host según tus necesidades
- Ligero: Un único binario de Go, sencillo de desplegar
🆕 Aspectos destacados
- Ejecución de trabajos: Ejecuta los workflows en cola de Forgejo Actions
- Etiquetas: Dirige trabajos a runners específicos
- Soporte de contenedores: Compilaciones aisladas mediante Docker
- Modo daemon: Se ejecuta continuamente como servicio
📦 Instalación desde deb-free.griffo.io
Paso 1: Agregar repositorio
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
sudo apt update
install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb-free.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb-free.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb-free.griffo.io.gpg] https://deb-free.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb-free.griffo.io.list > /dev/null
apt update
Paso 2: Instalar forgejo-runner
# Install latest forgejo-runner
sudo apt install forgejo-runner
# Verify installation
forgejo-runner --version
# Install latest forgejo-runner
apt install forgejo-runner
# Verify installation
forgejo-runner --version
🎯 Ejemplos de uso básico
# Show version
forgejo-runner --version
# Generate a default config file
forgejo-runner generate-config > config.yaml
# Register the runner with your Forgejo instance
forgejo-runner register --instance https://forgejo.example.com --token
# Start the runner daemon
forgejo-runner daemon
🚀 ¿Por qué elegir deb-free.griffo.io?
📊 Comparación de repositorios:
- Ubuntu oficial: A menudo meses por detrás, sin las últimas funciones
- deb.griffo.io (principal): Cada versión pocas horas después del upstream
- Instalación manual: Requiere descargas manuales y configuración del PATH
- Nuestro repositorio: Paquetes precompilados y listos para usar
- ✅ Actualizaciones regulares: Recibe las funciones y mejoras con como máximo 2 meses de retraso, gratis para siempre
- ✅ Sin configuración manual: Binarios precompilados, instalados y actualizados mediante apt
- ✅ Actualizaciones automáticas: Paquetes actualizados vía apt; las correcciones de seguridad se publican de inmediato
- ✅ Dependencias correctas: Correctamente empaquetado con todas las bibliotecas necesarias
- ✅ Multi-distribución: Funciona en Jammy y Noble
- ✅ Mantenimiento sencillo: Comandos apt simples para actualizar
📦 Repositorio de construcción de paquetes
Los paquetes de Ubuntu se construyen y mantienen automáticamente en este repositorio de GitHub:
- 📁 forgejo-runner-debian - Latest release builds
🔗 Paquetes relacionados
También disponible desde deb.griffo.io:
- Forgejo - Forja de software ligera y autoalojada
- Garage - Almacenamiento de objetos distribuido compatible con S3
- Headscale - Servidor de control Tailscale autoalojado
🎯 Perfecto para: Equipos y particulares que autoalojan Forgejo y quieren ejecutar sus propios pipelines de CI/CD con control total sobre el entorno de compilación y la infraestructura.
💝 Apoyar este proyecto
¡Si este repositorio te ahorra tiempo y esfuerzo, considera apoyarlo!