This project provides an opinionated Jenkins build pipeline described in my blog.

Jenkins setup

This pipline has hard-coded references to Jenkins configuration which must exist prior to the first build:

• Credentials
  • dockerhub-jenkins-account: permission to pull from private repos
  • github-jenkins-account: permission to pull from private repos during build
  • nexus-jenkins-account: permission to push/pull from our private Nexus
• Environment variables:
  • TARGET_ENV: identifies what part of the pipeline to execute, target environment. One of dev, pre-prod, or prod.

Since the Docker and GitHub repos we'll be using are public, you can use your own creds for Docker/GitHub.

To set up credentials in Jenkins, from the Jenkins landing page:

1. Click on "Credentials" in the left sidebar
2. Click on "System" that pops up below "Credentials"
3. Click on "Global credentials"
4. Click on "Add Credentials" and add items for each "*-account" item in the list above. If you are not providing a Nexus server, you can use any credentials - the credentialId just needs to be present.
   • Kind: Username with password
   • Scope: Global
   • Username:
   • Password:
   • ID: {an id from the credential list above}
   • Description: {the same id from the credential list above}

To set environment variables in Jenkins, form the Jenkins landing page:

1. Click on "Manage Jenkins" in the left sidebar
2. Click on "Configure System"
3. Under "Global Properties", check "Environment variables"
4. Click the "Add" button to add the following:
   • Name: TARGET_ENV
   • Value: dev
   • Name: K8S_CLUSTER_TYPE
   • Value: minikube
5. Click the "Save" button at the bottom of the page

Next, we need to register our Jenkins shared library with Jenkins so it is trusted and available to pipelines:

1. Click on "Manage Jenkins" in the left sidebar
2. Click on "Configure System"
3. Under "Global Pipeline Libraries", click "Add"
   • Name: jenkins-pipe
   • Default version: master
   • All options checked
   • Click "Retrieval method" -> "Modern SCM"
   • Select "GitHub"
   • Credentials: github-jenkins-account
   • Owner: stevetarver
   • Repository: jenkins-pipe
4. Click the "Save" button

Your Jenkinsfile

Each client Jenkinsfile points to a jenkins-pipe versioned release branch:

@Library('[email protected]') _

This versioning strategy reflects interface changes, not functionality. New functionality is developed in the master branch and merged into the latest release-* branch in a non-breaking way. If the interface must change, a new release-* branch is created and projects can upgrade on their timeline.

See the release branch README.md for instructions on using that version.

See:

• the project Releases tab for release history
• the release branch README.md for instructions on using that version
• the CHANGELOG.md for changes and migration notes

Each project Jenkinsfile provides configuration to adjust pipeline behavior to suit that project. This is a standard release-1.0.0 Jenkinsfile for a maven project:

@Library('[email protected]') _

containerPipeline([
    environment: [
        CANARY_LOCATION: 'us-east',
        PROD_LOCATIONS: 'us-west'
    ],
    pipeline: [
        dockerGroup: 'stevetarver',
        slackChannel: 'tarver-build',
        slackCredentialId: 'tarver-build-slack-token',
    ],
    stageCommands: [
        build: "./jenkins/scripts/build.sh",
        test: "./jenkins/scripts/test.sh",
        package: "./jenkins/scripts/package.sh",
        deploy: "./jenkins/scripts/deploy.sh",
        integrationTest: "./integration-test/run.sh -q -b -t integration -e lb1",
        canaryDeploy: "./jenkins/scripts/canary_deploy.sh",
        canaryTest: "./integration-test/run.sh -q -b -t smoke -e ${CANARY_LOCATION}",
        canaryRollback: "./jenkins/scripts/canary_rollback.sh",
        prodDeploy: "./jenkins/scripts/prod_deploy.sh",
        prodTest: "./integration-test/run.sh -q -b -t smoke -e ${PROD_LOCATIONS}",
    ],
    stages: [
        test: [
            unitTestResults: 'target/junit.xml',
            codeCoverageHtmlDir: 'target/htmlcov',
        ]
    ],
])

environment

This config block defines variables exposed in your build environment as shell environment variables.

• CANARY_LOCATION: the datacenter you deploy a canary in for testing the release during a prod deploy
• PROD_LOCATIONS: all datacenter targets for a prod deploy

The pipeline exposes exposes these environment variables as well:

#    BUILD_TIMESTAMP=20170823232923
#
#    DOCKER_BUILD_IMAGE_NAME=stevetarver/ms-ref-python-falcon-master
#    DOCKER_BUILD_IMAGE_NAMETAG=stevetarver/ms-ref-python-falcon-master:20171107231806845
#    DOCKER_BUILD_IMAGE_NAMETAG_LATEST=stevetarver/ms-ref-python-falcon-master:latest
#    DOCKER_DEPLOY_IMAGE_NAMETAG=stevetarver/ms-ref-python-falcon-master:20171107231806845
#    DOCKER_GROUP=stevetarver
#    DOCKER_IMAGE_BASENAME=stevetarver/ms-ref-python-falcon
#    DOCKER_PROJECT=ms-ref-python-falcon
#
#    GIT_BRANCH=master
#    GIT_COMMIT=9ee5cdf4a78e9f67b34172c5a136e44e9db8a769
#    GIT_ORG_REPO_NAME=stevetarver/ms-ref-python-falcon
#    GIT_REPO_NAME=pl-cloud-build
#    GIT_REPO_URL=https://github.com/stevetarver/ms-ref-python-falcon.git

pipeline

This config block configures pipeline operation to suit your project:

• dockerGroup: the docker registry group your docker image lives in
• slackChannel: the slack channel that build/deploy notifications are posted in
• slackCredentialId: the Jenkins credentialsId holding slack creds allowing us to post to Slack

stageCommands

This config block defines your project's implementation of each stage. For robust project management tools like maven and gradle, you can simply list the commands to run. When you need finer grained control, you can implement that in a bash script. Scripts reside in jenkins/scripts by convention.

stages

This config block allows configuration for each stage.

• test
  • unitTestResults: a file glob capturing all xml junit4 test results produced
  • codeCoverageHtmlDir: a path to unit test results html report

TODO

• Currently, pulling this repo by tag is broken in Jenkins. E.g. @Library('[email protected]') _ does not work. As a work around, we pull by branch name like release-1.0.0. Watch this bug and change our strategy when fixed.