Docker tutorial : Build Docker images using Jenkins

Docker as we know,is an open platform for developers and sysadmins to build, ship, and run distributed applications, whether on laptops, data center VMs, or the cloud.

Today we are going to check how to configure Jenkins to build Docker Images based on a Dockerfile. Below are the steps of how you can use Docker within a CI/CD pipeline, using Images as a build artifact that can be promoted to different environments and finally production.

Step #1 : Launch Jenkins

Currently I have Jenkins running on Docker container,if you do docker ps command it would show you the status of the container.

Image – Docker ps command to review status of the containers

Launch Jenkins’ dashboard

Build Docker images using Jenkins – Jenkins dashboard

Step #2 : Configure the plugins and start building Docker Images.

Our 1st step is to configure Docker plugin. Whenever a Jenkins build requires Docker, it will create a “Cloud Agent” via the plugin. The agent will be a Docker Container configured to talk to our Docker Daemon.The Jenkins build job will use this container to execute the build and create the image before being stopped. The Docker Image will be stored on the configured Docker Daemon. The Image can then be pushed to a Docker Registry ready for deployment.

Once you are inside the Jenkins Dashboard, select Manage Jenkins on the left.

On the Configuration page, select Manage Plugins.

Manage Plugins page will give you a tabbed interface. Click Available to view all the Jenkins plugins that can be installed.

Using the search box, search for Docker plugin. There are multiple Docker plugins, select Docker plugin using the checkbox.

Build Docker images using Jenkins – Install Docker Plugin

While on this page, install the Git plugin for obtaining the source code from a Git repository.

Build Docker images using Jenkins – Installing plugins

Click Install without Restart at the bottom.

The plugins will now be downloaded and installed. Once complete, click the link Go back to the top page.

Once the Docker & GIT plugins have been installed, now we can go ahead and configure how they launch the Docker Containers.

The configuration would be used by the plugin which Docker Image to use the agent and which Docker daemon to run the containers and builds on.The plugin treats Docker as a cloud provider, spinning up containers as and when the build requires them.

Step #3 : Configure Docker agent

On the Jenkins Dashboard, select Manage Jenkins.

Select Configure System to access the main Jenkins settings.

At the bottom, there is a dropdown called Add a new cloud. Select Docker from the list.

Build Docker images using Jenkins – Docker Add new cloud

You can now configure the container options. Set the name of the agent to docker-agent.

Build Docker images using Jenkins – Set Docker Agent options

The “Docker URL” is where Jenkins launches the agent container. In this case, we’ll use the same daemon as running Jenkins, but in real world scenario it should be separate instance so that it can scale.

Use Test Connection to verify Jenkins can talk to the Docker Daemon. You should see the Docker version number returned.

Now plugin can communicate with Docker,next step would be to configure how to launch the Docker Image for the agent.

Step #4 : Test the setup

The build will depend on having access to Docker. Using the “Restrict where this project can be run” we can define the label we set of our configured Docker agent. The set “Label Expression” to docker-agent. You should have a configuration of “Label is serviced by no nodes and 1 cloud”.

Select the Repository type as Git and set the Repository.I’m using my GIT location https://github.com/karthi4india/jenkins/.

We can now add a new Build Step using the dropdown. Select Execute Shell.

Build Docker images using Jenkins – Add Build Step

Dockerfile takes care of build, Jenkins only needs to call build and specify a friendly name.

The first command lists all the files in the directory which will be built. When calling docker build we use the Jenkins build number as the image tag. This allows us to version our Docker Images. We also tag the build with latest.

Docker File:

FROM scratch
EXPOSE 80
COPY http-server /
CMD ["/http-server"]

On the left-hand side, select Build Now. You should see a build scheduled with a message “(pending—Waiting for next available executor)”.

Build Docker images using Jenkins – Jenkins Build

Jenkins is launching the container and connecting to it via SSH. Sometimes this can take a moment or two.

You can see the progress using

docker logs --tail=10 jenkins

Once the build has completed you should see the Image and Tags using the Docker CLI

Like this:

Related

Published by Karthik

Allo! My name is Karthik,experienced IT [email protected] is
focused blog covering key technology trends, including cloud computing,blockchain,machine learning & AI,best mobile apps, best tools/open source libs etc.,I hope you would love it and you can be sure that each post is fantastic and will be worth your time.
View all posts by Karthik