Would you like to share Jenkinsfile
without copy-pasting in git (or other SCMs) but would also like to be able to have some variance in your Jenkinsfile
(e.g. configuration values such as email address, different unit test scripts, etc...)?
If so, this is the main driver of this plugin. We desired a central git-driven repository of trusted Jenkinsfile
templates which are inherently visible, can be contributed to, but also allow us the ability to centrally roll out updates and improvements to hundreds of pipelines at a time.
This plugin will select a Jenkinsfile based on config in the repository. What this means is that you can configure a whole GitHub Organization to use a Jenkinsfile repository and different repos can run different Jenkinsfiles in the central Jenkinsfile repo based on versioned configuration in the repo (no messing around with job configuration and it's all under version control). You simply point your pipeline_template to the path in the repo. This means you can switch between templates for different branches and test out new templates in PRs without having to muck around with job config.
This plugin provides you with a new Project Recognizer that you can use with any Multibranch Pipeline type such as a GitHub Organization or Multibranch Pipeline.
You'll simply set the Config File Path
to a location where you expect the config file to reside in the repositories (traditionally at the root of the repo).
The pipeline_template
configuration key is reserved for finding the Jenkinsfile
template you'd like to use out of the centralized Jenkinsfile
repo.
The plugin itself is only going to search for a pipeline_template
key/value in your Yaml, JSON, Java property file (and likely some others). This logic is in the ConfigurationValueFinder
and we'd be happy to entertain additions to expand compatibility. We recommend using the Pipeline Utility Steps Plugin to parse your config but you're free to implement and validate this however you'd like in your Jenkinsfile
templates.
The plugin places the contents of the config file in the PIPELINE_CONFIG
environment variable so that you don't have to read the file again.
Shared libraries are fantastic and are a great way to be able to make your pipeline code testable. However, it was nice to compose overall stages declaratively in Jenkinsfile and simply let each repo pass in configurable values such as the unit test command, Docker container to run under, etc...
Buildpacks are also awesome! However, sometimes there aren't quite the right buildpacks for your needs (and you could also use them within this 😄).
- Example project configured via Job DSL Plugin
- More configuration information
- Other shinies
- FAQs?