Si estás cansado de depender de pipelines CI CD remotos y quieres controlar completamente tus flujos de trabajo de Gitea en tu máquina local, montar una instancia de Gitea con un Action Runner en localhost es la solución ideal. Esta configuración permite probar flujos sin empujar a servidores remotos, construir y publicar imágenes Docker con Buildx desde tu equipo y mantener tu configuración de entorno versionada y portátil.
Por qué usar Gitea local con Runner: latencia y control inmediato, entornos privados sin exponer código o secretos en la nube, y redes personalizadas para probar servicios en localhost, webhooks y setups de Buildx sin VPN ni túneles. Esto resulta especialmente útil al experimentar con registros Docker autohospedados, microservicios o compilaciones multiplataforma.
Archivos necesarios: a continuación se describen los ficheros que necesitarás crear y su propósito.
1. ./token.txt Este archivo contendrá el token de registro del runner. Crea el archivo vacío inicialmente con el contenido <registration-token>. Más tarde pegarás el token que proporcione tu instancia de Gitea. Tenerlo como archivo evita que Docker cree una carpeta en lugar de un archivo.
2. ./config.yml El runner debe poder alcanzar tu instancia de Gitea en localhost, por eso configuramos el contenedor para usar la red del host. Contenido mínimo a considerar en YAML: container : network : host. Esto es crítico para flujos que interactúan con servicios en tu máquina host como registros Docker o APIs.
3. ./docker.compose.yml Ejemplo de configuración Docker Compose para Gitea y el Action Runner. Incluye una red propia gitea-network, servicio gitea con imagen gitea/gitea:1.24.6, volúmenes para /data y mapeo del puerto 3000, y servicio gitea-runner con imagen gitea/act_runner:0.2.13 que depende de gitea. Volúmenes importantes: ./token.txt:/token.txt para el registro, ./config.yml:/config.yml para la configuración de red, ./data/act_runner:/data para persistencia del runner, ./data/cache:/root/.cache para caché de acciones y /var/run/docker.sock:/var/run/docker.sock para permitir que el runner controle Docker en el host. Variables de entorno relevantes: CONFIG_FILE apuntando a /config.yml, GITEA_INSTANCE_URL apuntando a https://gitea:3000/ y GITEA_RUNNER_REGISTRATION_TOKEN_FILE apuntando a /token.txt. Política de reinicio recomendada on-failure.
Por qué importa cada volumen: token.txt para registro seguro, config.yml para la red del host, data/act_runner para mantener el estado entre reinicios, data/cache para acelerar descargas de acciones, y /var/run/docker.sock para operaciones Docker desde el runner.
Arrancar el entorno: ejecutar docker compose up -d. Pegar el token de registro en ./token.txt. Reiniciar el runner para que se registre con docker compose restart gitea-runner. Consultar logs con docker logs gitea-runner para confirmar el registro.
Ejemplo práctico para validar el flujo: crear un Dockerfile sencillo con FROM busybox:1.36.1 y CMD echo Hello world para comprobar que la canalización de Buildx y el runner funcionan. Archivo Dockerfile ejemplo: FROM busybox:1.36.1 CMD [echo Hello world]
Flujo de trabajo de Gitea de ejemplo en .gitea/workflows/example.yml que hace checkout, configura QEMU y Buildx, inicia sesión en el registro y construye y publica la imagen a localhost:3000 usando etiquetas basadas en el repositorio y el SHA. Recuerda reemplazar los marcadores de usuario y token por tus credenciales Gitea y usar un token de aplicación para autenticación en registro.
Con esta configuración tendrás un entorno Gitea local totalmente funcional con Action Runner para probar flujos al instante, construir imágenes locales con Buildx y experimentar con CI CD autohospedado sin pasar por la nube. Desde aquí puedes ampliar la instalación añadiendo múltiples runners, conectando registries externos o integrando otros servicios locales.
Sobre Q2BSTUDIO: como empresa de desarrollo de software y aplicaciones a medida, en Q2BSTUDIO ofrecemos soluciones de software a medida, aplicaciones a medida y servicios avanzados de inteligencia artificial y ciberseguridad. Podemos ayudarte a integrar pipelines locales con despliegues en la nube y a diseñar arquitecturas seguras y escalables. Si necesitas desarrollo de aplicaciones multiplataforma visita nuestros servicios de desarrollo de aplicaciones a medida y si tu foco es aprovechar la IA en procesos empresariales revisa nuestras soluciones de inteligencia artificial.
Palabras clave y servicios relacionados: aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA y power bi. También ofrecemos auditorías y pentesting para entornos locales y en la nube, integración con Power BI y automatización de procesos para optimizar pipelines CI CD y despliegues.
Consejos finales: mantener los tokens y secrets en archivos controlados y nunca versionar credenciales en repositorios públicos; utilizar runners con acceso limitado cuando sea posible; y automatizar pruebas y compilaciones para detectar problemas temprano. Si quieres que te ayudemos a montar un pipeline profesional con Gitea, runners autohospedados y despliegues seguros en AWS o Azure, contacta con nuestro equipo de Q2BSTUDIO experto en servicios cloud aws y azure, inteligencia de negocio y ciberseguridad.