Forge Home


Module for managing the openstack jenkins_job_builder tool


7,611 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 3.0.2 (latest)
  • 3.0.1
  • 3.0.0
  • 2.1.0
  • 2.0.1
  • 2.0.0
  • 1.1.1
released Oct 17th 2018
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2016.4.x
  • Puppet >= 4.10.0 < 7.0.0
  • , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'puppet-jenkins_job_builder', '3.0.2'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add puppet-jenkins_job_builder
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install puppet-jenkins_job_builder --version 3.0.2

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Tags: jenkins


puppet/jenkins_job_builder — version 3.0.2 Oct 17th 2018

Jenkins Job Builder module for Puppet

Build Status Code Coverage Puppet Forge Puppet Forge - downloads Puppet Forge - endorsement Puppet Forge - scores

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with jenkins_job_builder
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module


Install jenkins_job_builder to allow you to manage your Jenkins jobs.

Module Description

The openstack jenkins_job_builder tool manages the configuration of jobs in your Jenkins instance. This module wraps that tool and allows you to control all the configuration of your Jenkins jobs from within hiera.


What jenkins_job_builder affects

  • Install the jenkins_job_builder pip package
  • Creates temporary files for each jenkins job you want to manage

Beginning with jenkins_job_builder

Installing jenkins_job_builder to a specified version

class { 'jenkins_job_builder':
  version => 'latest'


Classes and Defined Types

Class: jenkins_job_builder

Parameters within jenkins_job_builder:


The version of the the plugin to be installed.


A hash of the configuration for all the jobs you want to configure in your Jenkins instance.


The user used to authenticate to the Jenkins instance. (optional)


The password used to authenticate to the Jenkins instance. (optional)


(Optional) The connection timeout (in seconds) to the Jenkins server. If timeout is unset it will remove any existing timeout values in the config file.


If using the jenkins hipchat plugin, this is the token that should be specified in the global config.


The full url (including port) to the jenkins instance.

Define: jenkins_job_builder::job

Parameters within jenkins_job_builder::job:


A hash of the configuration for all the job you want to configure in your Jenkins instance.


The time (in seconds) to delay the creatation of the Jenkins job. This is to avoid issues where Jenkins restarts during a puppet run.


The name of the jenkins service to restart when configuration changes are made. Defaults to 'jenkins'



Public Classes



This module is tested on the following platforms:

  • CentOS 5
  • CentOS 6
  • Ubuntu 13.10
  • Ubuntu 14.04

It is tested with the OSS version of Puppet only.



Please read for full details on contributing to this project.