Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

pypm install collective.recipe.jenkinsjob

How to install collective.recipe.jenkinsjob

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install collective.recipe.jenkinsjob
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
1.0-alpha1 Available View build log
Windows (64-bit)
1.0-alpha1 Available View build log
Mac OS X (10.5+)
1.0-alpha1 Available View build log
Linux (32-bit)
1.0-alpha1 Available View build log
Linux (64-bit)
1.0-alpha1 Available View build log
Lastest release
version 1.0-alpha1 on Feb 27th, 2012

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' : 'jenkins.plone.org',
    ...     '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]


Subscribe to package updates

Last updated Feb 27th, 2012

Download Stats

Last month:1

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.