Hace tiempo existe y sigue en desarrollo activo act, una herramienta para probar GitHub Actions en local. Aunque es un gran proyecto y lo recomiendo para configuraciones complejas, a veces necesitas algo más simple, y ahora hay una solución oficial. Veamos cómo funciona.
Buscando una forma de probar GitHub Actions en local, descubrí act, una herramienta de terceros muy popular. Incluso cuenta con extensión para VS Code y soporta GitHub CLI, pero depende de Docker y resulta más compleja de lo que necesitaba.
Yo solo quería ejecutar unas líneas de JavaScript, así que seguí investigando hasta dar con una solución estable y oficial: Local Action Debugger. Es fácil de usar. Solo hay que instalarlo como dependencia de desarrollo en tu proyecto de GitHub Actions con el comando npm i -D @github/local-action.
Importante, el nombre del paquete no termina en s. También funciona sin instalarlo de forma local, y es compatible con pnpm y yarn. GitHub indica que solo incluye funcionalidades básicas, por lo que no esperes que cubra proyectos grandes. Para esos casos siempre puedes apoyarte en act.
Local Action Debugger funciona tanto con GitHub Actions en JavaScript como en TypeScript. Si quieres máxima compatibilidad, puedes partir de una plantilla oficial. La mejor manera de integrarlo es añadiendo un script en tu package.json, por ejemplo un comando llamado local-action que ejecute npx @github/local-action . src/main.ts .env.
También puedes usar el mismo comando con npx sin instalar nada. Un detalle clave es el archivo .env: aunque debes excluirlo del repositorio, es crucial para las pruebas locales. Es buena práctica añadir un .env.example para orientar a colaboradores.
Sigue las instrucciones oficiales, ya que el depurador localizará y ejecutará tus fuentes desde una estructura de carpetas concreta. En TypeScript, asegúrate de que la opción allowJs esté en false. Después, ejecuta npm run local-action.
Esto iniciará Local Action Debugger, que primero mostrará una lista de archivos y carpetas ordenados por índice, incluyendo Action Path, Entrypoint y Environment File según los argumentos que pases. Verás los metadatos y la salida que hayas definido en tu archivo action.yml.
Probé con una acción que exporta un archivo en la raíz del proyecto y se generó justo donde debía. Estoy muy satisfecho con el resultado. Es una solución rápida, sencilla y mantenida por GitHub, que usa librerías estándar para ofrecer sus funciones. Te recomiendo incorporarla a tus proyectos.
En Q2BSTUDIO ayudamos a equipos de desarrollo a crear y optimizar flujos CI CD con GitHub Actions, integrando automatización de procesos, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio y power bi, además de inteligencia artificial aplicada, ia para empresas y agentes IA. Si buscas impulsar la eficiencia de tu delivery y orquestar pipelines robustos, descubre cómo podemos ayudarte en automatización de procesos. Y si necesitas aplicaciones a medida y software a medida diseñados para tu contexto, visita nuestra oferta de desarrollo de software.
Seguiremos compartiendo novedades sobre buenas prácticas DevOps, integración con herramientas de inteligencia artificial y seguridad avanzada para reforzar la entrega continua en tus repositorios. Si te interesa incorporar pruebas locales de acciones, ciberseguridad o despliegues multicloud con AWS y Azure, cuenta con Q2BSTUDIO para llevar tus repositorios al siguiente nivel.