ATTENTION: Docker 1.12 Users!

This guide uses the Docker-Plugin for jenkins (0.15 or 0.16). Which appear to have some compatibility problems with Docker 1.12. When using Docker 1.12, please only use the jenkins2 folder which has evolved from the original blog articles however /is/ compatible with Docker 1.12.

If you want to follow these guides stick to Docker 1.10 or 1.11.

Jenkins and Docker Tutorial Series

This repository is provided as a set of functional working examples that follows along with a blog series released by Maxfield Stewart at Riot Games, Each folder contains a self contained set of files that are the end result of each tutorial and are provided as is.

Blogs In Order of Appearance

1. Thinking Inside the Container
2. Putting Jenkins into a Docker Container
3. Docker Jenkins and Data that Persists
4. Jenkins, Docker, Proxies and Compose
5. Taking Control of your Docker Image
6. Building With Jenkins Inside an Ephemeral Docker Container

Instructions For Using this Repository

Ideally users should follow the blog series for specific directions. That said here's some basic setup instructions you will need before these become viable.

Step 0 - Pre-Reqs

1. You’ll need Windows 7 (or later) or Mac OSX 10.7 or later.

2. You’ll need a machine that’s able to run VirtualBox - you may need to enable virtualization in your BIOS on some PC’s.

3. If you already have Docker Toolbox installed, you can skip step 1 below. This blog was written using Docker Toolbox 1.8 and Virtualbox 5.

   Please note: when installing Docker Toolbox on a system with a pre-existing Virtualbox install you may run into some interesting challenges that are best to get around by uninstalling everything and installing from scratch.

   If installing a new version of Docker Toolbox over a very old version of Boot2docker you may run into issues, it’s best to fully wipe Boot2docker and its iso images before proceeding.

Step 1 - Install Docker Toolbox

1. Go to: http://docks.docker.com/installation/mac (or http://docks.docker.com/installation/windows)
2. Download and install Docker Toolbox for your operating system. Please keep in mind that behind the scenes this is installing VirtualBox.
3. Follow all setup instructions.
4. Verify your installation is working by opening a docker terminal window (in windows this step is done by clicking the docker quickstart desktop icon) by running the following steps:
5. Type: docker images (verify it gives you an empty list back with no errors).