Skip to content

Latest commit

 

History

History
73 lines (48 loc) · 3.13 KB

README.md

File metadata and controls

73 lines (48 loc) · 3.13 KB

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:

  1. Minimum HW requirements: a dual-core CPU, 8 GB RAM, 100 GB disk space
  2. The most recent version of Docker tools (see Note 1)
    • Docker Engine (see Note 2)
    • Docker Compose
    • Docker Machine
  3. A recent Internet browser (i.e. Google Chrome)
  4. 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:

  1. A fast, multi-core server on your local network
  2. 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