firecow/gitlab-ci-local
Gitlab Ci Local
gitlab-ci-local is a local runner and pipeline emulator for GitLab CI. It provides an execution environment to test pipeline configurations and scripts on a local machine without requiring commits or pushes to a remote server.
The tool mimics the GitLab CI lifecycle by parsing YAML configurations, managing job dependencies, and resolving remote file inclusions via HTTP requests. It uses container-based isolation to run jobs and incorporates a variable manager to inject environment variables from local files.
The project includes capabilities for pipeline debugging, job inspection, and artifact handling, allowing job outputs to be captured and stored in local directories.
Features
- Local Pipeline Emulation - Emulates remote continuous integration pipelines on a local machine to verify configurations and scripts.
- YAML-Based Workflows - Processes YAML files to define the sequence, dependencies, and stages of the pipeline.
- Configuration-Driven Orchestrators - Implements an execution engine that manages pipeline jobs based on declarative YAML configuration files.
- Containerized Job Isolation - Runs each pipeline job inside a temporary Docker container to mirror the remote runner environment.
- Local CI Runners - Provides a local execution environment for testing GitLab CI configurations without pushing to a remote server.
- Local CI Testing Tools - Enables testing of GitLab CI pipeline configurations and scripts on a local machine.
- Pipeline Artifact Passing - Copies job outputs to local storage to simulate the passing of artifacts between pipeline stages.
- Local CI/CD Environments - Mimics a remote runner's environment by managing local variables and artifacts.
- Environment Variable Management - Manages the loading of environment variables from local directories and project files.
- Remote Configuration Synchronization - Synchronizes local pipeline definitions with remote configuration sources through fetching and caching.
- Pipeline Structure Inspection - Provides capabilities to list available jobs, stages, and dependencies to verify the pipeline structure.
- Local-Only Variable Storage - Manages environment variables stored locally to simulate remote execution environments.
- Local Artifact Simulation - Captures and stores job output files locally to replicate the behavior of remote artifact storage.
- Container Directory Mounting - Binds local host directories to container paths to persist job outputs and simulate remote artifacts.
- Configuration File Resolution - Downloads external YAML snippets via HTTP to build a final merged configuration for local execution.
- Scoped Environment Variable Injections - Loads environment variables from local files and injects them into the container process.
- Local Pipeline Execution - Executes pipeline jobs locally instead of pushing to remote servers.
- Pipeline Automation Tools - Executes pipeline configurations locally to test before pushing.
