Jenkins Slave Container with Docker

Deprecated: According to this article Docker-in-Docker for your CI or testing environment? Think twice.⁠ by Jérôme Petazzoni you will run into several problems when you integrate Docker into your CI-System with this image. I agree, because I ran into several performance issues using it.

Solution: Use my image that is reusing the socket of your Docker host: blacklabelops/swarm-dockerhost⁠

Check this project on how to configure a swarm slave: blacklabelops/jenkins-swarm⁠

Make It Short!

In short, you can use Docker CLI commands inside a Jenkins slave.

First start a master!

$ docker run -d -p 8090:8080 --name jenkins blacklabelops/jenkins

Then start a Docker demon container!

$ docker run -d --privileged --name docker_demon docker:1.9.1-dind

Now start the build slave!

$ docker run -d \
    --link jenkins:jenkins \
    --link docker_demon:docker \
    blacklabelops/swarm-docker

Docker Login

The slave can be started and login in a remote repository. The default is the dockerhub registry.

With the environment variables:

• DOCKER_REGISTRY_USER: Your account username for the registry. (mandatory)
• DOCKER_REGISTRY_EMAIL: Your account email for the registry. (mandatory)
• DOCKER_REGISTRY_PASSWORD: Your account password for the registry. (mandatory)

Example:

$ docker run -d \
    --link jenkins:jenkins \
    --link docker_demon:docker \
    -e "DOCKER_REGISTRY_USER=**Your_Account_Username**" \
    -e "DOCKER_REGISTRY_EMAIL=**Your_Account_Email**" \
    -e "DOCKER_REGISTRY_PASSWORD=**Your_Account_Password**" \
    blacklabelops/swarm-docker

Changing the Docker registry

The default for this container is dockerhub.io. If you want to use another remote repository, e.g. quay.io then Your_Account_Email can specify the repository with the environment variable DOCKER_REGISTRY.

Example:

$ docker run -d \
    --link jenkins:jenkins \
    --link docker_demon:docker \
    -e "DOCKER_REGISTRY=quay.io"
    -e "DOCKER_REGISTRY_USER=**Your_Account_Username**" \
    -e "DOCKER_REGISTRY_EMAIL=**Your_Account_Email**" \
    -e "DOCKER_REGISTRY_PASSWORD=**Your_Account_Password**" \
    blacklabelops/swarm-docker

References

• Docker Homepage⁠
• Docker Userguide⁠