jenkins-controller

Jenkins controller container image based on configuration as code

Configuration file

The Jenkins configuration is stored in casc.yaml

Running the Jenkins Controller

Example of how to run in docker:

docker run -d --name jenkins -e JENKINS_HOST_URL="http://localhost:8080" -e JENKINS_ADMIN_USER=admin -e JENKINS_ADMIN_PASSWORD="password" -e GITHUB_USER="rene@zubcevic.com" -e GITHUB_PK="..." -p 8080:8080 -p 50000:50000 renezubcevic/jenkins-controller

Building local

You can build a local custom version in two steps.

build the base image with adjusted plugins

docker build -t renezubcevic/jenkins-casc -f Dockerfile-casc .
build the controller with a custom casc.yaml file and custom footer

docker build --build-arg JENKINS_FOOTER_URL="https://www.zubcevic.com" -t renezubcevic/jenkins-controller -f Dockerfile .

Get the Jenkins plugins installed from Groovy script console

def pluginList = new ArrayList(Jenkins.instance.pluginManager.plugins)
    pluginList.sort {it.getShortName() }.each{
        plugin ->
            println("${plugin.getShortName()}:${plugin.getVersion()}")
    }

Get the Jenkins plugins installed from CLI client

curl 'localhost:8080/jnlpJars/jenkins-cli.jar' > jenkins-cli.jar
java -jar jenkins-cli.jar -s http://admin:password@localhost:8080 groovy = < pluginEnumerator.groovy | sort > plugins-installed.txt

Required plugins

configuration-as-code

The most essential plugin for configuration as code to work.

templating-engine

Used in order to test my Jenkins templating engine pipeline. Added here to see how to configure the global settings as code.

adoptopenjdk

Used to auto install Java SDK from AdoptOpenJDK. Just required for my own sample job. Referred to in casc.yaml as:

tool:
  jdk:
    installations:
    - name: "JDK11"
      properties:
      - installSource:
          installers:
          - adoptOpenJdkInstaller:
              id: "jdk-11.0.9.1+1"

Jenkins job export

curl -X GET http://admin:password@127.0.0.1:8080/job/TestMB/credentials/store/folder/domain/_/credential/jenkins-id/config.xml -o jenkinssecret.xml
curl -X GET http://admin:password@127.0.0.1:8080/job/TestMB/credentials/store/folder/domain/_/credential/github-id/config.xml -o githubsecret.xml
curl -X GET http://admin:password@127.0.0.1:8080/job/TestMB/config.xml -o jobconfig.xml

Jenkins job import

JENKINS_CRUMB=$(curl --cookie-jar tmpCookie 'http://admin:password@127.0.0.1:8080/crumbIssuer/api/xml?xpath=concat(//crumbRequestField,":",//crumb)')
curl --cookie tmpCookie -X POST 'http://admin:password@127.0.0.1:8080/createItem?name=TestMB' -d @jobconfig.xml -H "$JENKINS_CRUMB" -H "Content-Type: text/xml"

Jenkins start job

curl --cookie tmpCookie -X POST 'http://admin:password@127.0.0.1:8080/job/TestMB/build?delay=0' -H "$JENKINS_CRUMB"
curl --cookie tmpCookie -X POST 'http://admin:password@127.0.0.1:8080/job/TestMB/job/develop/build?delay=0' -H "$JENKINS_CRUMB"

More info

how-to-automate-jenkins-setup-with-docker-and-jenkins-configuration-as-code

TODO

Use external secrets provider:

zubcevic/jenkins-controller