# jenkinsci/jenkinsfile-runner

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/jenkinsci-jenkinsfile-runner).**

1,202 stars · 306 forks · Java · MIT

## Links

- GitHub: https://github.com/jenkinsci/jenkinsfile-runner
- awesome-repositories: https://awesome-repositories.com/repository/jenkinsci-jenkinsfile-runner.md

## Topics

`cli` `docker-image` `faas` `hacktoberfest` `jenkins` `jenkins-pipeline` `jenkinsfile` `jenkinsfile-runner` `tool`

## Description

Jenkinsfile runner is a continuous integration engine that executes declarative workflows and pipeline scripts directly from the command line or container environments without requiring a persistent master server. It provides terminal-based execution tools for running, testing, and linting pipeline definitions locally, supporting build parameter passing, interactive shell sessions, and source control checkout configurations with authentication for private repositories.

The system supports declarative instance configuration through mounted YAML files, automatic dependency resolution, and on-demand plugin installation to set up required build steps. It packages the execution engine and plugins into container images or standalone executable distributions, allowing custom image building and portable workload execution across different host systems. 

Additional capabilities cover data persistence via mounted volumes for logs and execution history, log output customization through configuration files, and custom application package generation from project descriptor files.

## Tags

### Part of an Awesome List

- [Local Pipeline Execution](https://awesome-repositories.com/f/awesome-lists/devops/local-pipeline-execution.md) — Executes continuous integration and deployment pipelines from the command line without requiring a master server architecture. ([source](https://github.com/jenkinsci/jenkinsfile-runner/blob/main/README.adoc))

### DevOps & Infrastructure

- [Container CI/CD Pipelines](https://awesome-repositories.com/f/devops-infrastructure/container-ci-cd-pipelines.md) — Provides a container-centric execution tool for running continuous integration workflows from the terminal.
- [CI/CD Pipeline Orchestration](https://awesome-repositories.com/f/devops-infrastructure/ci-cd-pipeline-orchestration.md) — Executes continuous integration and deployment workflows defined in code files without needing a persistent orchestration server. ([source](https://github.com/jenkinsci/jenkinsfile-runner/search))
- [Containerized Task Execution](https://awesome-repositories.com/f/devops-infrastructure/container-image-packaging/containerized-task-execution.md) — Runs continuous integration tasks inside pre-built or custom container images for isolated execution. ([source](https://github.com/jenkinsci/jenkinsfile-runner/blob/main/README.adoc))
- [Containerized Build Systems](https://awesome-repositories.com/f/devops-infrastructure/containerized-build-systems.md) — Packages continuous integration engines and plugins into lightweight containers to run workloads portably across different host systems.
- [Containerized Execution Environments](https://awesome-repositories.com/f/devops-infrastructure/containerized-execution-environments.md) — Packages the runtime and execution engine into lightweight container images so workloads run portably across different host systems. ([source](https://github.com/jenkinsci/jenkinsfile-runner/search))
- [Executable Packaging](https://awesome-repositories.com/f/devops-infrastructure/cicd-pipeline-automation/core-build-engines/build-tooling/native-build-orchestrators/executable-packaging.md) — Builds a lightweight distribution archive containing the execution engine, required binaries, and dependencies for standalone usage. ([source](https://github.com/jenkinsci/jenkinsfile-runner/tree/main/packaging-slim-parent-pom))
- [CLI Job Runners](https://awesome-repositories.com/f/devops-infrastructure/cli-job-runners.md) — Provides a command-line utility for executing pipeline scripts locally in isolated processes.
- [Declarative Configuration Engines](https://awesome-repositories.com/f/devops-infrastructure/configuration-management/declarative-configuration-frameworks/declarative-configuration-engines.md) — Defines system settings and plugin configurations declaratively by mounting YAML definition files into the container at startup. ([source](https://github.com/jenkinsci/jenkinsfile-runner/blob/main/docs/using/EXTENDING_DOCKER.adoc))
- [Container Image Packaging](https://awesome-repositories.com/f/devops-infrastructure/container-image-packaging.md) — Packages the execution engine and specified plugins into a container image using packaging tools to prepare runnable environments. ([source](https://github.com/jenkinsci/jenkinsfile-runner/blob/main/demo/cwp))
- [Custom Container Images](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/image-management-tools/custom-container-images.md) — Builds tailored container images by installing extra plugins, adding required tools, and baking in pre-configured settings. ([source](https://github.com/jenkinsci/jenkinsfile-runner/blob/main/docs/using/EXTENDING_DOCKER.adoc))
- [Local CI Testing Tools](https://awesome-repositories.com/f/devops-infrastructure/local-ci-testing-tools.md) — Runs pipeline definition scripts from the local command line independently of full server infrastructure for rapid development. ([source](https://github.com/jenkinsci/jenkinsfile-runner#readme))

### Business & Productivity Software

- [Workflow Execution Engines](https://awesome-repositories.com/f/business-productivity-software/workflow-execution-engines.md) — Runs predefined build scripts inside a container or command-line environment independently of traditional master servers. ([source](https://github.com/jenkinsci/jenkinsfile-runner/blob/main/demo/cwp))

### Development Tools & Productivity

- [Command Line Interfaces](https://awesome-repositories.com/f/development-tools-productivity/command-line-interfaces.md) — Provides a terminal-based command interface to trigger execution runs directly from scripts or developer terminals. ([source](https://github.com/jenkinsci/jenkinsfile-runner/search))
- [On-Demand](https://awesome-repositories.com/f/development-tools-productivity/package-installers/on-demand.md) — Installs additional plugins into the execution environment using setup tools or package managers to support required pipeline steps. ([source](https://github.com/jenkinsci/jenkinsfile-runner#readme))
- [Distribution Package Generators](https://awesome-repositories.com/f/development-tools-productivity/project-file-generators/build-configuration-file-generators/distribution-package-generators.md) — Builds tailored container images and distributions from project descriptor files to bundle specific dependencies and versions. ([source](https://github.com/jenkinsci/jenkinsfile-runner/blob/main/docs/using/EXTENDING_DOCKER.adoc))

### Software Engineering & Architecture

- [Pipeline Definitions](https://awesome-repositories.com/f/software-engineering-architecture/declarative-task-definitions/pipeline-definitions.md) — Parses pipeline definition scripts as code to validate syntax before running builds.
- [Metadata Parameter Passings](https://awesome-repositories.com/f/software-engineering-architecture/default-configuration-values/execution-parameter-configurations/application-parameter-configurators/runtime-parameter-configurators/metadata-parameter-passings.md) — Supplies runtime values to parameterized workflows using key-value pairs via command-line switches. ([source](https://github.com/jenkinsci/jenkinsfile-runner/blob/main/README.adoc))

### Testing & Quality Assurance

- [Pipeline Syntax Linting](https://awesome-repositories.com/f/testing-quality-assurance/code-quality-review/code-quality-tools/formatting-and-linting-pipelines/multi-format-linting-pipelines/pipeline-syntax-linting.md) — Analyzes declarative pipeline syntax for errors without triggering a full execution run. ([source](https://github.com/jenkinsci/jenkinsfile-runner#readme))