Repolode
Enviar
nektos

nektos/act

Una CLI que ejecuta tus workflows de GitHub Actions localmente en Docker, para que puedas probar cambios sin hacer commit ni push.

Ver en GitHubSitio web
Estrellas
72,437
Forks
2,069
Issues abiertos
398
Último commit
hace 2 meses

¿Qué es?

act lee los archivos de workflow en .github/workflows/ y ejecuta los jobs en tu máquina con Docker. Descarga o crea las imágenes que necesita cada workflow, determina el orden de ejecución según las dependencias entre jobs e inicia un contenedor para cada paso. Configura las variables de entorno y la estructura del sistema de archivos para que se parezcan a las de los runners alojados en GitHub.

La herramienta está pensada para dos situaciones: iterar en los cambios de workflows sin tener que hacer commit y push, y usar definiciones de workflow existentes como ejecutor de tareas en lugar de un Makefile. La guía de usuario está disponible en nektosact.com, y el proyecto está escrito en Go y se distribuye bajo la licencia MIT.

Funciones clave

  • 01Ejecuta workflows de GitHub Actions localmente en contenedores Docker.
  • 02Resuelve las dependencias entre jobs para determinar el orden de ejecución.
  • 03Configura las variables de entorno y las rutas del sistema de archivos para que coincidan con las de los runners de GitHub.
  • 04Se puede usar como ejecutor local de tareas basado en archivos de workflow existentes.
  • 05Cuenta con una extensión de VS Code para ejecutar workflows desde el editor.

Casos de uso

  • Probar cambios en archivos de .github/workflows/ antes de subirlos.
  • Depurar un job de CI que falla sin esperar a los runners remotos.
  • Reemplazar un Makefile por definiciones de workflow reutilizables para tareas locales.

Inicio rápido

  1. 1

    Instala Docker y asegúrate de que esté en ejecución

  2. 2

    Clona el repo y compílalo desde el código fuente con make install (requiere Go 1.20 o posterior)

    make install
  3. 3

    Ejecuta tus workflows localmente desde un repo que tenga .github/workflows/

    act

Antes de usarlo

  • Docker debe estar instalado y en ejecución.
  • Se ejecuta en contenedores, por lo que puede que no coincida exactamente con los entornos de los runners alojados en GitHub.

Temas

#github-actions#ci#docker#devtools#golang#automation#devops

Preguntas frecuentes

¿Qué es act?
Una CLI que ejecuta tus workflows de GitHub Actions localmente en Docker, para que puedas probar cambios sin hacer commit ni push. act lee los archivos de workflow en .github/workflows/ y ejecuta los jobs en tu máquina con Docker. Descarga o crea las imágenes que necesita cada workflow, determina el orden de ejecución según las dependencias entre jobs e inicia un contenedor para cada paso. Configura las variables de entorno y la estructura del sistema de archivos para que se parezcan a las de los runners alojados en GitHub.
¿act es gratuito? ¿Qué licencia tiene?
act es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿act sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de act fue el 9 ago 2026.
¿Para qué puedo usar act?
Probar cambios en archivos de .github/workflows/ antes de subirlos. Depurar un job de CI que falla sin esperar a los runners remotos. Reemplazar un Makefile por definiciones de workflow reutilizables para tareas locales.
¿Cómo se instala act?
Instala Docker y asegúrate de que esté en ejecución Clona el repo y compílalo desde el código fuente con make install (requiere Go 1.20 o posterior): make install Ejecuta tus workflows localmente desde un repo que tenga .github/workflows/: act
¿Dónde consigo act?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/nektos/act

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados