Docker and Jenkins [as code]

Docker and Jenkins
[as code]
CI/CD TrackCI/CD Track

© 2019 All Rights Reserved. 3
Today…
3

CI/CD. Why containers?
Config Management
Fast provisioning
Clean environments
Disposability
Clustering 4

Jenkins and Docker

© 2019 CloudBees, Inc. All Rights Reserved.
Jenkins & Docker. Packaging
https://hub.docker.com/r/jenkins/

Jenkins and Docker
• Build agents and steps

Official agent images
• jenkins/slave – base image with Remoting
• jenkins/jnlp-slave – JNLP agents
• jenkins/ssh-slave – SSH agents
• jenkins/remoting-kafka-agent – Remoting Kafka Plugin
https://hub.docker.com/r/jenkins/

Jenkins & Docker. Plugins
Docker Plugin
Docker Pipeline Plugin
Docker Custom Build Environment Plugin
…
Yet Another Docker Plugin
Kubernetes Plugin
Kubernetes Pipeline Plugin
…

Example: Docker Pipeline Plugin
https://plugins.jenkins.io/docker-workflow
docker.image('onenashev/gcc-riscv:6.4-rc').inside {
checkout scm
sh "make clean test"
}

Jenkins and Docker
• Build agents and steps
• Master images

Jenkins masters in Docker
• Production - jenkins/jenkins
• Experimental - jenkins4eval
• ARM, ARM 64, IBM s/390, PowerPC 64 LE

Official image: jenkins/jenkins
docker run --rm
-p 8080:8080
-p 50000:50000
-v jenkins_home:/var/jenkins_home
jenkins/jenkins:lts

Official image: jenkins/jenkins
• Weekly and LTS releases
• No bundled plugins
• Debian, Alpine, Slim, CentOS
• Java 8, Java 11
https://github.com/jenkinsci/docker

Configuration as Code in Jenkins
16
JobsSystem
configuration

Extending images
Official images are designed to be extended
Managed as code

Extending images
Image source:
http://container.farm/special-extended-container/

Extending Docker images
Dockerfile
Plugin bundling
Groovy Hooks
Environment and Java Options
Docs: https://github.com/jenkinsci/docker

Dockerfile

Plugin bundling
21

Plugin bundling
22
# Pinned version
blueocean:1.8.2
# Latest
antisamy-markup-formatter
matrix-auth:latest
# Latest from the Experimental update center
git-client:experimental
# Incrementals (JEP-305)
workflow-support:incrementals;org.jenkins-ci.plugins.workflow;2.21-rc591.43d37d4d080a
plugins.txt

Groovy Hooks [1/2]
• Standard Groovy engine
• Triggered by Jenkins
• Direct access to the runtime
• Extensible hook engine
• 2 hook types in the core: init, boot-failure
https://wiki.jenkins-ci.org/display/JENKINS/Groovy+Hook+Script

Groovy Hooks [2/2]
Script locations:
• WEB-INF/HOOK.groovy in jenkins.war
• WEB-INF/HOOK.groovy.d/*.groovy in jenkins.war
• $JENKINS_HOME/HOOK.groovy
• $JENKINS_HOME/HOOK.groovy.d/*.groovy
Execution in alphabetical order
https://wiki.jenkins-ci.org/display/JENKINS/Groovy+Hook+Script

Jenkins Startup Flow
JOBS_LOADED
EXTENSIONS_AUGMENTED
COMPLETED
Groovy Hooks: init()
PLUGINS_STARTED
. . .

Example
https://github.com/oleg-nenashev/demo-jenkins-config-as-code

Adding Groovy hooks to the standard image
Just put Groovy scripts in the right place!
https://github.com/oleg-nenashev/demo-jenkins-config-as-code

More examples
oleg-nenashev/demo-jenkins-config-as-code
Praqma/JenkinsAsCodeReference
librecores/librecores-ci

Add JCasC Plugin!
Configuration-as-Code Plugin
https://plugins.jenkins.io/configuration-as-code

JCasC Plugin
● Sub-project in Jenkins
● Feb 2018 - first alpha
● Sep 2018 - 1.0
● Now - 1.27
● Configuration via YAML
jenkinsci/configuration-as-code-plugin
gitter.im/jenkinsci/configuration-as-code-plugin

jenkins:
systemMessage: "JCasC Demo"
numExecutors: 1
scmCheckoutRetryCount: 4
mode: NORMAL
securityRealm:
local:
allowsSignup: false
users:
- id: demoAdmin
password: ${adminpw}
jenkins.yaml

• YAML specification
• Configuration export from Jenkins
• CLI and REST API for configuration management
• Pre-flight validations and dry-run
• Support of many plugins out-of-the-box
Features

Adding JCasC to the Docker image
YAML auto-discovery in 1.0+
Needs JCasC Plugin
…
configuration-as-code:1.27
…

Comparison
JCasC Plugin Groovy Hooks
YAML – standard declarative
definition
Low barrier to entry
Limited integrations
Forward compatibility risks
External rollback
Apply changes w/o restart
No debugging, YAGNI?
Dry run mode + validation
Export from UI
CLI and REST API for CM
Plugin management
Groovy – general-purpose OOP
language
High barrier to entry
Can manage everything
Compatible if API is stable
External rollback
Restart is required
Debugging support
Plugin Management

What about CloudBees?

Products
● All products are available as Docker images
○ https://hub.docker.com/u/cloudbees
● Helm charts for CloudBees Jenkins Distribution
● CloudBees Core runs on-premise or in the cloud
○ Kubernetes
○ Docker
○ Virtual machines
○ Bare metal

Plugins
● All Jenkins Docker plugins are available to customers
● Extended SLA for several plugins
https://go.cloudbees.com/plugins/

Plugin Management
● Added value features for Docker
● CloudBees Assurance Program and
Beekeper in all products
○ https://go.cloudbees.com/docs/cloudbees-
documentation/assurance-program/
● Plugin catalog for CloudBees Core
○ https://go.cloudbees.com/docs/plugins/configur
ing-plugin-catalogs/

CloudBees Assurance
Program
● Verified plugin sets
● Upgrade assistant
● Administrative monitors
● Opt-in automatic upgrade

Lists the set of plugins, plugin versions and
plugin dependencies that CloudBees has
tested for compatibility and security.
Administrative dashboard provides a
centralized view of the monitored
Jenkins plugins, recommended actions,
and configuration options available.

JCasC in CloudBees products
● We are working on it! (c)
● Technical Preview for…
○ CloudBees Jenkins Support
○ CloudBees Jenkins Distribution
● Other products - http://bit.ly/cjd-jcasc
http://bit.ly/jcasc-cloudbees

JCasC in CloudBees Jenkins Distribution
● Combines with CloudBees Assurance Program
● Documentation and Quick Start
○ http://bit.ly/cjd-jcasc
● Demo
○ https://github.com/cloudbees-oss/cjd-jcasc-demo

https://github.com/cloudbees-oss/cjd-jcasc-demo

Takeaways
1. Dockerize Jenkins
2. Use & extend official images
3. Use static configurations
4. Use Configuration-as-Code
5. Use Custom WAR/Docker Packager
6. Try CloudBees Jenkins Distribution

DevOptics
Software Delivery
Visibility & Insights
Core
Unified Software
Delivery &
Governance
CodeShip
CI/CD as a
Service
Flow
Adaptive
Release
Orchestration
DevOps ExcellenceJenkins
CloudBees Jenkins
Distribution
CloudBees Jenkins X
Distribution
24x7 Technical Support
Assisted Updates
Support
Accelerator
Training
Customer Success Managers
DevOps Consultants
Rollout
Feature
Flag
Management
Continuous Delivery Products and Services

Docker and Jenkins [as code]

More Related Content

What's hot

Similar to Docker and Jenkins [as code]

More from Mark Waite

Recently uploaded

Docker and Jenkins [as code]