Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Buildout recipe to manage jobs on a remote Jenkins CI server.

Project Description

Simple buildout recipe that generated three commands *push a jenkins job*, *pull a jenkins job* and *trigger build on jenkins job*.

Recipe enables developer to sync configuration on Jenkins with buildout configuration.

Workflow to be used with the recipe:

- create and configure a job through the web
- run pull jenkins job
- later, make more changes the job through the web
- run pull jenkins job and use your SCM to diff the config
- (optional) push configuration to any other server or use it as restore
- (optional) trigger build, because you are too lazy to wait n minutes for cronjob

Supported options

The recipe supports the following options:

hostname (required)
Hostname of the Jenkins instance.

jobname (required)
Name of the Jenkins job.

jobconfig (default: jenkins_config.xml)
Name for XML configuration file for the Jenkins job, relative to buildout directory.

username (required)
Jenkins username

password (required)
Jenkins password

port (default: 80)
Jenkins port

Example usage

We'll start by creating a buildout that uses the recipe::

>>> write('buildout.cfg',
... """
... [buildout]
... parts = jenkins-job
... [jenkins-job]
... recipe = collective.recipe.jenkinsjob
... hostname = %(hostname)s
... jobname = %(jobname)s
... jobconfig = %(jobconfig)s
... username = %(username)s
... password = %(password)s
... """ % {
... 'hostname' : '',
... 'jobname' : 'Plone42',
... 'jobconfig': 'plone.xml',
... 'username': 'chuck',
... 'password': 'norris'})

Running the buildout gives us::

>>> buildout_output_lower = system(buildout).lower()
>>> "installing jenkins-job" in buildout_output_lower
>>> "generated script" in buildout_output_lower
>>> "bin/jenkins-job-push" in buildout_output_lower
>>> "bin/jenkins-job-pull" in buildout_output_lower
>>> "bin/jenkins-job-trigger-build" in buildout_output_lower

Detailed Documentation


Note: place names and roles of the people who contribute to this package
in this file, one to a line, like so:

- Timo Stollenwerk
- Domen Kožar

Change history


1.0-alpha1 (2012/02/26)

- forked from collective.recipe.hudsonjob
[tisto, iElectric]

Release History

Release History

This version
History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date (24.6 kB) Copy SHA256 Checksum SHA256 Source Feb 26, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting