easy-jenkins
Easily deploy a Jenkins CI/CD infrastructure via docker-machine and docker-compose.
Please see CHANGELOG for main changes since previous release.
Here is a presentation about easy-jenkins which explains the motivations behind this project.
TL;DR
$ git clone https://github.com/gmacario/easy-jenkins
$ cd easy-jenkins
$ ./runme.sh
If the script executes successfully it will display a message like the following:
INFO: Now browse http://192.168.99.100:9080/ to access the Jenkins dashboard
The Jenkins dashboard may then be accessed by opening the displayed URL using a recent Internet browser.
The behavior of the runme.sh script may be customized through some environment variables - please refer to the comments inside the script for details.
You will also be reminded to use the following command
INFO: Run the following command to configure your shell:
INFO: eval $(docker-machine env easy-jenkins)
in order to setup the environment variables so that docker-compose and docker will interact with the correct Docker engine.
System Requirements
In order to run easy-jenkins you need a recent 64-bit x86 host with:
- Minimum HW requirements: a dual-core CPU, 8 GB RAM, 100 GB disk space
- The most recent version of Docker tools (see Note 1)
- Docker Engine (see Note 2)
- Docker Compose
- Docker Machine
- A recent Internet browser (i.e. Google Chrome)
- A fast Internet connection
Note 1: By installing Docker Toolbox (either on OS X or MS Windows) you will get all the Docker tools (i.e. docker, docker-compose, docker-machine, etc.) required by easy-jenkins.
Note 2: Thanks to docker-machine you can configure easy-jenkins to deploy and run the containers on a remote Docker engine, for instance:
- A fast, multi-core server on your local network
- An instance on a public cloud, such as Amazon EC2, DigitalOcean, etc.
I installed easy-jenkins, now what can I do?
Basically whatever you can do with Jenkins.
- A comprehensive collection of tutorials and reference manuals on Jenkins can be found at jenkins.io/doc.
- The CloudBeesTV channel on YouTube features a rich collection of tutorials and webinars.
- If you prefer a book instead, check the excellent (even though a little outdated) Jenkins: The Definitive Guide.
- Finally, under the docs/ subdirectory of this repository you can find some examples about how to use easy-jenkins.
License
easy-jenkins is licensed under the MIT License - for details please see the LICENSE file.
Copyright (C) 2016-2019, Gianpaolo Macario