adizzy71 / modern-jenkins

A repo containing code for a modern Docker + Jenkins CI / CD System

Dockerized Jenkins Build System

This repo contains an example of a fully automated Jenkins & Docker build system. It was originally developed as part of a tutorial on the following blog: The CI/CD Life

It has been adopted by a new maintainer intending to take it further :-)

Table of contents

Here are links to the originally available tutorial sections:

• Unit 1 / Part 1: Planning a Jenkins + Docker CI System
• Unit 1 / Part 2: Architecting a Jenkins + Docker CI System
• Unit 2 / Part 1: GitHub + GitHub Flow
• Unit 2 / Part 2: Building the Base Jenkins Image (and Intro to Docker)
• Unit 2 / Part 3: Building the Jenkins Master Image
• Unit 2 / Part 4: The Jenkins Plugin Image
• Unit 2 / Part 5: Starting Jenkins with Docker Compose
• Unit 3 / Part 1: Intro to the Jenkins Groovy Init System
• Unit 3 / Part 2: Configure Jenkins URL
• Unit 3 / Part 3: Managing Secrets in GitHub
• Unit 3 / Part 4: Configuring the GitHub Jenkins Plugin

Please follow along the original tutorial if you'd like to learn how to deploy a a Modern Jenkins Infrastructure on Docker!

New stuff

Beyond the original tutorial covering mostly base Jenkins and Docker topics some new topics have been added, with details in internal PRs:

• PR #1 - Adding a Vagrant box to run Docker inside
• PR #2 - Better Gradle and Groovy integration
• PR #3 - Hooking up Job DSL including samples (later enhanced further)
• PR #4 - Hobo GitOps! Expand control further to include external DSL and Manifest repos

At this stage to see the new stuff in action from a fresh clone using Vagrant do the following:

• vagrant up to get your Vagrant box
• vagrant ssh to get into your Vagrant box
• cd /vagrant/images/jenkins-base + ./build.sh to build the first Docker image (the base for the other two images)
• cd ../jenkins-master/ + ./build.sh to build the second image - this contains the Jenkins master itself
• cd ../jenkins-plugins/ + ./build.sh to build the third and final image - this contains plugins, init scripts, and DSL stuff
• cd ../../deploy/master/ + ./start.sh to then actually use Docker Compose to stand up everything involved, launching Jenkins to http://localhost:8080

A presentation PDF is included with the repo that covers "Hobo GitOps" - eventually a webinar recording of some sort should become available :-)

Future stuff

Plans and ideas

• Convert from boring properties files and JSON to Jenkins CasC compatible YAML but still be able to read it from utility jobs
• Rework the Docker image setup a bit - master war into master image, split apart plugin image from init scripts and DSL, etc
• Run several Hobo GitOps tiered masters at the same time to better showcase the promotion flow
• Prepare hooks for various GitOps operators, like WeaveWorks Flux
• Improve the workspace to also support development work on setting up and configure things beyond Jenkins, such as Nexus or Sonarqube
• Include support for local manifests / environments where you can begin, then later push those into external repos (nested Git roots yay!)