Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 19 Next »

Plugin Information

View Inedo BuildMaster Plugin on the plugin site for more information.

Older versions of this plugin may not be safe to use. Please review the following warnings before using an older version:

This plugin integrates Inedo BuildMaster to Jenkins allowing Jenkins jobs to gather version information from BuildMaster and trigger builds on an application.

Usage

First, you need to ensure that an api key as been configured in BuildMaster at BuildMaster > Administration > All Settings > ApiKey.  Without this the plugin won't be able access BuildMaster.



Next, you need to go to Jenkins' system config screen to tell Jenkins where's your BuildMaster resides.  I have found that I need to configure it for NTLM authentication otherwise my account gets locked out.  Clicking the "Test Connection" button a few times will confirm whether this is required or not.



Lastly, you need to add a couple of steps to your Jenkins job.  Because the Release and Build numbers could be required by several build and post-build actions selecting the application and has been separated from the trigger build action.

The "Select BuildMaster Application" build step allows you to select the the BuildMaster application you are dealing with and the settings will be used to inject these environment variables into the job at build time:

  •     BUILDMASTER_APPLICATION_ID
  •     BUILDMASTER_RELEASE_NUMBER
  •     BUILDMASTER_BUILD_NUMBER
  •     BUILDMASTER_DEPLOYABLE_ID

Ignore the Deployable option for the moment, that will be covered in the advanced topics section later in this document.


The "Trigger Build" action can be added as either a build step or post build action.  The choice of which to use will be largely dependent on how you import the build artifacts into BuildMaster and your personal preference:

  1. You are using the BuildMaster Jenkins Build Importer Build Step which imports build artifacts from Jenkins: the post build action is required
  2. You are using a standard BuildMaster build step and importing files from a folder that you've placed the artifacts into from the Jenkins build (eg using ArtifactDeployer Plugin): either the post build or build step actions will be fine
  3. You use an external artifact repository such as Nexus or Artifactory: either the post build or build step actions will be fine

If you haven't used the "Select BuildMaster Application" action then you will need to go into the advanced section and set the application id, release and build number details.

To deploy the build to the first environment ensure that you have the post-build step action "Auto-Promote Build to the Next Environment" set in BuildMaster.



Advanced Topics

Multiple Jenkins Jobs Using A Single BuildMaster Application

It is vital that you use the "Select BuildMaster Application" build step as this this build step will queue any jobs attempting to run for the same BuildMaster application while another is already running, so that you cannot get two jobs triggering a build in BuildMaster at the same time.

If you have multiple Jenkins jobs all triggering a build for the same BuildMaster application check out the following two options as a means to ensure that the new BuildMaster build picks up artifacts from only the Jenkins jobs that have build for its release.

  1. "Enable Deployable in BuildMaster": selectively enables deployables for a release
    1. In BuildMaster you must ensure that Deployables are disabled by default for a release
    2. The "Select BuildMaster Application" Deployable option must be set to the correct deployable
  2. "Copy Previous Build's Variables": if checked will gather the variables from the previous build and add them to the list of variables being passed in for this build, overriding any that are being set for this build.
    1. This could be useful if you're only passing in pointers to a version, eg you keep your artficats in Artifactory or Nexus
      

History

Version 1.3 (May 15, 2015)
  • Expand variable values defined in “Set Build Variables in BuildMaster” property
  • Queue Jenkins builds targeting same BuildMaster application
Version 1.2 (May 14, 2015)
  • Create Build waits for previous execution on BuildMaster to finish before new one is requested
  • Improved wait for build to complete handling
  • Create Build request triggers build regardless of whether BuildMaster application has build step or not
Version 1.0 (May 1, 2015)
  • Initial Release
  • No labels