easy-jenkins

KO | EN

gitlite — search

#python #cli #ai #open-source #artificial-intelligence #llm #javascript #macos #typescript #rust #ai-agents #fastapi

★ 36 Open GitHub ↗

Easily deploy a Jenkins CI/CD infrastructure via docker-compose

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# easy-jenkins

Easily deploy a [Jenkins](https://jenkins-ci.org/) CI/CD infrastructure via [docker-machine](https://www.docker.com/docker-machine) and [docker-compose](https://www.docker.com/docker-compose).

Please see [CHANGELOG](CHANGELOG.md) for main changes since previous release.

Here is [a presentation about easy-jenkins](http://gmacario.github.io/images/easybuild-torinotech-2016-04-01.pdf) 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](https://www.docker.com/) tools (see Note 1)
   * Docker Engine (see Note 2)
   * Docker Compose
   * Docker Machine
5. A recent Internet browser (i.e. [Google Chrome](https://www.google.com/chrome/))
6. A fast Internet connection

**Note 1**: By installing [Docker Toolbox](https://docs.docker.com/toolbox/) (either on [OS X](http://www.apple.com/osx/) or [MS Windows](http://www.microsoft.com/en-us/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](https://aws.amazon.com/it/ec2/), [DigitalOcean](https://www.digitalocean.com/), 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][1].
* The [CloudBeesTV channel on YouTube][2] 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][3].
* Finally, under the [docs/][4] subdirectory of this repository you can find some examples about how to use easy-jenkins.

[1]: https://jenkins.io/doc/
[2]: https://www.youtube.com/user/CloudBeesTV
[3]: https://archive.org/details/jenkins
[4]: docs/

### License

easy-jenkins is licensed under the MIT License - for details please see the `LICENSE` file.

easy-jenkins

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README