nektos/act
Act
This tool is a command-line runner that executes automation workflows locally within isolated container environments. By parsing workflow definition files and translating them into executable shell scripts, it allows developers to validate pipeline logic and configuration changes directly on their machines before committing code to a remote repository.
The runner distinguishes itself by providing a simulation engine that mimics remote CI triggers and event payloads, enabling the testing of complex conditional logic without requiring cloud infrastructure. It supports granular control over the execution environment, allowing users to specify custom container images, inject secrets, and map local directory structures to ensure consistent module resolution. Furthermore, it facilitates integration with private enterprise infrastructure by supporting secure authentication and custom container engine configurations.
The project provides operational controls for troubleshooting, such as the ability to isolate and execute individual workflow tasks by name. It manages the lifecycle of ephemeral runner instances through standard socket interfaces, ensuring that local development environments remain synchronized with the requirements of production pipelines.
Features
- Containerized Workflow Runners - Runs automation workflows within isolated containers to replicate remote CI system configurations locally.
- Docker Socket Orchestrators - Interacts with container runtime socket interfaces to programmatically manage the lifecycle of ephemeral runner instances.
- Workflow Transpilers - Parses workflow definition files to generate and run equivalent shell scripts inside containerized environments.
- Job Execution Controls - Enables granular control by allowing developers to trigger individual workflow tasks selectively for isolated troubleshooting.
- CI/CD Simulation Engines - Emulates remote automation triggers and event payloads to validate complex pipeline configurations locally.
- Cross-Platform Automation Tools - Provides a portable execution layer that standardizes build and test processes across diverse operating systems.
- Infrastructure as Code - Facilitates local execution of infrastructure-defined workflows to validate automation logic against private server requirements.
- Runner Image Specifications - Supports custom container image specifications to ensure workflow tasks run within required environment configurations.
- Environment Simulation Tools - Configures containerized runtimes to mirror production environments, allowing for accurate local testing of automation logic.
- Event-Driven Testing Frameworks - Simulates event triggers and custom data payloads to validate how automation logic responds to real-world events.
- Development Environments - Run GitHub Actions locally on your machine.
- GitHub Automation Tools - Run GitHub Actions locally.
- Enterprise Security Integrations - Facilitates authentication with private enterprise infrastructure by providing necessary hostnames and access tokens during workflow execution.
- Workflow Debuggers - Isolates and executes specific workflow tasks individually to debug failures without triggering an entire automation suite.
- Local CI/CD Environments - Allows running automation workflows directly on a local machine to verify logic and configuration changes before deployment.
- Workflow Simulation Tools - Tests workflow logic using mock event data and custom JSON payloads without requiring production environment access.
- Environment Variable Configurations - Injects secrets and configuration parameters into the container runtime to replicate the security context of a remote server.
- Container Engine Configurations - Supports custom container engine configurations by defining socket paths or remote host addresses for runtime compatibility.
- Remote Container Host Configurations - Connects to remote container hosts by allowing manual definition of host addresses and certificate paths.
