JENKINS LOCAL

Automated CI/CD structure with jenkins and docker to test/validate your pipeline on your own machine

Test out your local projects
Define your agents based on your project stack
Use main controller to manage everything (plugins, config etc)

Getting started

Update .env.jenkins with your data using env.template
From /jenkins-local root folder, you can run the command:

$ ./scripts/run.sh
Go to your controller at http://localhost:8787
Open admin > __jenkins-jobs and Build the job
Go to Dashboard and you can see some examples

How it works?

The communication between containers and your local host is managed by exposing docker-api
From containers you can read/fetch your local app001/.git project
From Jenkins Master you can spin up an Agent to run your CI flow based on your project needs

Features

Test your local commits before create a PR
Jenkins controller with agent communication using docker
Multiple agents running in parallel
Control everything you need on your own machine

How to

Enable ssh locally

Enable ssh in your Mac - Required to make your host accept ssh connection
- System preferences > Sharing > Remote Login

Troubleshooting

Error: Connection refused
- Error message: stderr: ssh: connect to host host.docker.internal port 22: Connection refused
- If you are trying to run __jenkins-jobs job and get error, you can solve it by enabling your remote login

Built With

Docker - Container platform
JCASC - Jenkins configuration as code
docker-plugin - docker plugin for jenkins

Author

Marcio Mendes - mmendesas

License

This project is licensed under the MIT License