Skip to content

Latest commit

 

History

History
86 lines (70 loc) · 6.11 KB

README.md

File metadata and controls

86 lines (70 loc) · 6.11 KB
Raw

Jenkins Build Per Git Flow Branch

This script will allow you to keep your Jenkins jobs in sync with your Git repository (following Git Flow branching model).

Genesis

This is a variation of a solution we found. Hence, the credit for the idea and initial implementation goes to Entagen, neoteric-eu and theirs Jenkins Build Per Branch and . They explained it nicely, so it's advisable to take a look to their page. As stated, Entagen's version would suit better for a GitHub flow convention. Our need is to have one templatte job for all of the Git Flow branches: features, releases, hotfixes and to sync them all in one 'scanning session' (single Jenkins sync job execution). We modified the script, but replaced the synchronization logic with what suited us better.

Installation

Requirements are the same for both script versions:

  • Jenkins Git Plugin
  • Jenkins Gradle plugin
  • Jenkins Release Plugin
  • The git command line app also must be installed (this is already a requirement of the Jenkins Git Plugin), and it must be configured with credentials (likely an SSH key) that has authorization rights to the git repository
  • The best idea is to clone / fork this repository for your own usage (to make sure that the script remain intact). However, you can still use ours if you like.

Naming convention

To make this script work properly, job names must follow few rules:

Template jobs should follow <templateJobPrefix>-<jobName>-<branchName> name, where:

  • templateJobPrefix - a prefix which distinguish particular type of template (one template type can be reused among several projects (explained further)
  • jobName - name of your Jenkins job purpose, ex. build etc.
  • branchName - one of the 3 Git Flow branch types: feature, release, hotfix

Regular jobs should follow similar pattern <jobPrefix>-<jobName>-<branchName>, where:

  • jobPrefix - is a prefix which distinguish particular project
  • jobName - name of your Jenkins job purpose, ex. build etc.
  • branchName - one of the 3 Git Flow branch types: feature, release, hotfix with the name of the branch

The slash in the branch name is replaced with underscore in the job name (feature/newFeature -> feature_newFeature)

Usage

Usage is also very similiar to the original, but let me retrace the steps:

1. Create Jenkins synchronization job

The whole idea is to have a single Jenkins job which executes periodically, checks Git repository and creates / removes Jenkins jobs for each of the Git Flow dynamic branch (other than master and development).

  • Create new "Freestyle project" kind of Jenkins job.
  • Name it accordingly, ex. ProjectName-SyncJobs.
  • For Git URL provide this script location (or your forked / cloned one): [email protected]:SoftwareBuildService/jenkins-build-per-gitflow-branch.git
  • Set appropriate branch to build (ours is origin/master)
  • Make sure it's triggered periodically (ex. every 5 minutes: H/5 * * * *)
  • Add a build step "Invoke Gradle script" and set it's Tasks field to syncWithRepo
  • Provide script parameters (explained below) in Switches box

Important note from Entagen site: This job is potentially destructive as it will delete old feature branch jobs for feature branches that no longer exist. It's strongly recommended that you back up your jenkins jobs directory before running, just in case. Another good alternative would be to put your jobs directory under git version control. Ignore workspace and builds directories and just about everything can be added. Commit periodocally and if something bad happens, revert back to the last known good version.

2. Add script parameters (provided in Switches box)
  • -DjenkinsUrl URL of the Jenkins.You should be able to append api/json to the URL to get JSON feed.
  • -DjenkinsUser Jenkins HTTP basic authorization user name. (optional)
  • -DjenkinsPasswrd Jenkins HTTP basic authorization password. (optional)
  • -DgitUrl URL of the Git repository to make the synchronization against.
  • -DdryRun Pass this flag with any value and it won't make any changes to Jenkins (preview mode). It is recommended to use dry run until everything is set up correctly. (optional)
  • -DtemplateJob Name of template job to use
  • -DjobPrefix Prefix name of project jobs to create
  • -DcreateJobInView If you want the script to create the job in a view provide the view name here. It also supports nested views, just separate them with a slash '/', ex. view/nestedview
  • -DnoDelete pass this flag with true value to avoid removing obsolete jobs (with no corresponding git branch) (optional)

Sample parameters configuration:

-DjenkinsUrl=http://myjenkinshost.com:8080/
-DjenkinsUser=username
-DjenkinsPassword=password
[email protected]/project.git
-DtemplateJob=SimpleJar-develop
-DjobPrefix=ProjectOne
-DcreateJobInView=ProjectOne
3. Template

The idea of this script is to be able to handle a template version for all Git Flow branch types. The template job is also used as jenkins job for the development branch (Git branch develop). You can name the job for sth like projectname-develop and use its name as parameter templateJob=projectname-develop.

Notes on configuring your template:

  • Git repository URL is going to be replaced by the script (with the project Git URL set in sync job parameters)
  • Branch to build is going to be determined and set by the script
  • If you want use the jgitflow plugin it is recomended to set the option Check out to specific local branch beacause jgitflow cant work with checkouts on specific revision.