Collection of executable Jenkinsfiles loaded automatically into a dockerized Jenkins. Useful for experimenting or demos.
Jenkinsfile documentation lacks in examples when it comes to more advanced features.
I needed working examples of various Jenkinsfiles which I could then modify in my local text editor and automatically convert them into Jenkins jobs. Unfortunately the best way to test a Jenkinsfile is to run it in a Jenkins instance.
This project takes away the manual process of copying and pasting a Jenkinsfile into a Jenkins job configuration. By design job has to be run manually.
How it works
jenkinsfile-loader container uses Jenkins REST API to create Jenkins jobs directly from Jenkinsfiles located in
It also monitors any change in that folder and will update, create or remove jobs accordingly.
All files must be named
<job_name> will be used for the Jenkins job name.
There is no auto-refresh, so after adding or removing files Jenkins page needs to be refreshed manually to reflect changes.
Blogs using this repository:
This will pull and start latest docker images
docker-compose pull docker-compose up
If you have problem with mounting
/var/run/docker.sock then remove it from
docker-compose.yml but you won't be able to run jobs which use docker as an agent.
In the terminal you should see:
$ docker-compose-up ... jenkinsfile-loader_1 | 21:27:33 Waiting for Jenkins at http://jenkins:8080/api/json... jenkins_1 | INFO: Jenkins is fully up and running ... jenkinsfile-loader_1 | 21:27:46 Connection to Jenkins established... jenkinsfile-loader_1 | 21:27:46 Creating job 001-stages-declarative-style... ...
Wait for Jenkins to boot up. Authentication is disabled. Open a browser and go to:
If you don't see any jobs refresh the browser and check the
To stop press
CTRL+C in terminal.
To remove all containers with all of its data run:
If you wish to update jenkins for some reason then:
- Update jenkins version in
- Rebuild docker image and start a new jenkins container.
- Manually update jenkins plugins using the
Install or update Jenkins pluginsguide.
Install or update Jenkins plugins
If you just want to test new plugins without committing them to git then stop at step 2.
Start jenkins container.
Manually install or update plugins through the UI.
Restart jenkins to verify it's still working.
Copy output of the following command to
plugins.txtfile (located in this repository):
curl -s http://localhost:8080/pluginManager/api/json?depth=1 \ | jq -r '.plugins | "\(.shortName):\(.version)"' \ | sort
Rebuild docker image and start a new containers to verify new plugins have been installed:
docker-compose build docker-compose down docker-compose up