Skip to main content

Repository: govuk-jenkinslib

Groovy library for common GOV.UK Jenkins CI tasks

README

GOV.UK Jenkinslib

A library for setting up CI environments in GOV.UK.

The library will need to be loaded into a Jenkins instance before being able to use it. This will depend on Jenkins being configured to load it.

To load the library, use the library function:

library("govuk")

To specify a different branch for testing:

library("govuk@my-new-branch")

Setting up CI on GOV.UK

For most Ruby projects, the following Jenkinsfile is sufficient:

#!/usr/bin/env groovy

library("govuk")

node { govuk.buildProject() }

This will set up dependencies, run the tests and report back to GitHub.

For applications: the master branch of applications will be deployed to integration

For gems: if the version has changed, the latest version will be released to rubygems.org

Exceptions

If you need to run tests using a command other than the default rake task you can do this by specifying the overrideTestTask option:

#!/usr/bin/env groovy

library("govuk")

node { govuk.buildProject(overrideTestTask: { stage("Run custom tests") { govuk.runRakeTask("super-special-tests") } }) }

Parameter Description Default
afterTest A closure containing commands to run after the test stage, such as report publishing
beforeTest A closure containing commands to run before the test stage, such as environment variable configuration
brakeman Whether or not to run the Brakeman security scanner true if a Rails app, otherwise false
cleanWorkspace Whether to delete the workspace at the beginning of the build false
extraParameters Provide details here of any extra parameters that can be used to configure this build. See: https://jenkins.io/doc/pipeline/steps/workflow-multibranch/#code-properties-code-set-job-properties for details on the format and structure of these extra parameters.
extraRubyVersions Ruby versions to run the tests against in addition to the versions currently supported by all GOV.UK applications. Only applies to gems because they may be used in projects with different Ruby versions. []
gemName If publishing a Rubygem, you can specify the Gem name. Repository name
overrideTestTask A closure containing commands to run to test the project. This will run instead of the default bundle exec rake
skipDeployToIntegration Whether or not to skip the “Deploy to integration” stage false
yarnInstall Whether or not to install Yarn dependencies if a yarn.lock file is found true

Licence

MIT License