Repolode
Enviar
nektos

nektos/act

Uma CLI que executa localmente seus workflows do GitHub Actions no Docker, para testar alterações sem precisar fazer commit e push.

Ver no GitHubSite
Estrelas
72,422
Forks
2,070
Issues abertas
398
Último commit
há 2 meses

O que é?

act lê os arquivos de workflow em .github/workflows/ e executa os jobs na sua máquina usando Docker. A ferramenta baixa ou cria as imagens necessárias para cada workflow, determina a ordem de execução com base nas dependências entre os jobs e inicia um container para cada etapa. As variáveis de ambiente e a estrutura do sistema de arquivos são configuradas para se aproximar do que os runners hospedados pelo GitHub oferecem.

A ferramenta atende a duas situações: iterar nas alterações de workflows sem passar pelo ciclo de commit e push e usar definições de workflow existentes como executor de tarefas no lugar de um Makefile. O guia do usuário está disponível em nektosact.com, e o projeto é escrito em Go e distribuído sob a licença MIT.

Recursos principais

  • 01Executa workflows do GitHub Actions localmente usando containers Docker.
  • 02Resolve as dependências entre jobs para determinar a ordem de execução.
  • 03Configura variáveis de ambiente e caminhos do sistema de arquivos para corresponder aos runners do GitHub.
  • 04Pode ser usado como executor local de tarefas com base em arquivos de workflow existentes.
  • 05Conta com uma extensão para VS Code que permite executar workflows pelo editor.

Casos de uso

  • Testar alterações em arquivos .github/workflows/ antes de enviá-las ao repositório.
  • Depurar um job de CI com falha sem esperar pelos runners remotos.
  • Substituir um Makefile por definições de workflow reutilizáveis para tarefas locais.

Início rápido

  1. 1

    Instale o Docker e confirme que ele está em execução

  2. 2

    Clone o repo e compile a partir do código-fonte com make install (requer Go 1.20 ou superior)

    make install
  3. 3

    Execute seus workflows localmente a partir de um repo que tenha .github/workflows/

    act

Antes de usar

  • É necessário ter o Docker instalado e em execução.
  • A execução ocorre em contêineres, então o ambiente pode não corresponder perfeitamente aos runners hospedados pelo GitHub.

Tópicos

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

Perguntas frequentes

O que é act?
Uma CLI que executa localmente seus workflows do GitHub Actions no Docker, para testar alterações sem precisar fazer commit e push. act lê os arquivos de workflow em .github/workflows/ e executa os jobs na sua máquina usando Docker. A ferramenta baixa ou cria as imagens necessárias para cada workflow, determina a ordem de execução com base nas dependências entre os jobs e inicia um container para cada etapa. As variáveis de ambiente e a estrutura do sistema de arquivos são configuradas para se aproximar do que os runners hospedados pelo GitHub oferecem.
act é gratuito? Qual é a licença?
act é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
act ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de act foi em 9 de ago. de 2026.
Para que posso usar act?
Testar alterações em arquivos .github/workflows/ antes de enviá-las ao repositório. Depurar um job de CI com falha sem esperar pelos runners remotos. Substituir um Makefile por definições de workflow reutilizáveis para tarefas locais.
Como instalar act?
Instale o Docker e confirme que ele está em execução Clone o repo e compile a partir do código-fonte com make install (requer Go 1.20 ou superior): make install Execute seus workflows localmente a partir de um repo que tenha .github/workflows/: act
Onde consigo act?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/nektos/act

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados