Jenkins Job DSL Configuration as Code Most developers want to write code, they don’t want to click around in GUIs or do manual work. A lot of development teams uses Jenkins for package building, testing and tons of other automated jobs. All of this, of course, to improve the overall quality and simplicity of a project, but also to remove some of the “pain” from the developers. Most teams configure everything in Jenkins manually and with limited history, versioning and rollback options. What can be done to help developers focus on developing while benefitting from their daily work in the Jenkins setup at the same time?

1. November 2016
Jenkins Job DSL
Configuration as Code

2. November 2016
• Introduction
• Jenkins
• How to create jobs/views
• Job DSL
• Questions

3. November 2016
Tomas Norre Mikkelsen
• AOE GmbH - June 2013
• DevOps/Automation
• TYPO3.org, Crawler
• Golf, #t3runners
• @tomasnorre

4. November 2016
We are the champions
- Team FourSquare

5. November 2016
I have been running marathons
- but still I consider myself being lazy!

6. November 2016
What is Jenkins?

7. November 2016
The leading open source automation server,
Jenkins provides hundreds of plugins to support
building, deploying and automating any project.
- https://jenkins.io/

8. November 2016
• Run Unit tests
• Build docker images
• Build artifacts
• Deploy website/applications
• Publish TER Extensions on Git-tag
• etc.
What can we use Jenkins for

9. November 2016
Create a Jenkins job

10. November 2016
<?xml version='1.0' encoding='UTF-8'?>
<project>
<description></description>
<keepDependencies>false</keepDependencies>
<properties>
<hudson.plugins.buildblocker.BuildBlockerProperty plugin="build-blocker-plugin@1.7.3">
<useBuildBlocker>false</useBuildBlocker>
<blockLevel>GLOBAL</blockLevel>
<scanQueueFor>DISABLED</scanQueueFor>
<blockingJobs></blockingJobs>
</hudson.plugins.buildblocker.BuildBlockerProperty>
<com.sonyericsson.rebuild.RebuildSettings plugin="rebuild@1.25">
<autoRebuild>false</autoRebuild>
<rebuildDisabled>false</rebuildDisabled>
</com.sonyericsson.rebuild.RebuildSettings>
</properties>
<scm class="hudson.scm.NullSCM"/>
<canRoam>true</canRoam>
<disabled>false</disabled>
<blockBuildWhenDownstreamBuilding>false</blockBuildWhenDownstreamBuilding>
<blockBuildWhenUpstreamBuilding>false</blockBuildWhenUpstreamBuilding>
<triggers/>
<concurrentBuild>false</concurrentBuild>
<builders>
<hudson.tasks.Shell>
<command>#!/bin/sh
echo &quot;Welcome to T3EE16 - Jenkins JobDSL&quot;</command>
</hudson.tasks.Shell>
</builders>
<publishers/>
<buildWrappers/>
</project>
Every configuration is XML

11. November 2016
Challenges
• Copying jobs
• Adjusting same setting multiple times
• UI can be slow
• Fields hidden under advanced button

12. November 2016
Job DSL
• Domain Specific Language
• Groovy
• Can be extend with configure blocks

13. November 2016
File structure

14. November 2016
job('t3ee_groovy') {
steps {
shell('''
#!/bin/sh
echo "Welcome to T3EE16 - Jenkins JobDSL"
''')
}
}
Groove Job

15. November 2016
Play ground

16. November 2016
How to setup Jenkins JobDSL
• install Job DSL plugin
• Seeder job

17. November 2016
Seeder Job

18. November 2016
Shared configuration

19. November 2016
Looping for environments

20. November 2016
Setting up views

21. November 2016
How to test your jobs

22. November 2016
Pros & Cons
• Version Control
• More readable
• Change shared configurations
• Test locally
• Review
• Not all plugins are supported
• Learning curve

23. November 2016
Best practice
• Start converting few jobs
• All jobs goes to version control
• Trigger seed job on SCM changes
• Don’t commit credentials
• Think about design, refactor, streamline etc.
it’s code treat it like code.

24. November 2016
Developers want to write code,
so let them do what they love!

25. November 2016
Questions?
@tomasnorre tomas.mikkelsen@aoe.com

26. November 2016
• https://jenkinsci.github.io/job-dsl-plugin/ - Documentation
• http://job-dsl.herokuapp.com/ - Play Ground
• http://www.groovy-lang.org/ - Groove Website
• https://github.com/tomasnorre/t3ee16_jenkins - Example Repository
Links