Docker tutorial – Create Docker Images using Multi-stage builds

Read Time:4 Minute, 54 Second

From the last post, we have understood what is container & why do we use containers in general. Just to recap here are some of the key points

  • Containers are an abstraction at the app layer that packages code and dependencies together. Multiple containers can run on the same machine and share the OS kernel with other containers, each running as isolated processes in userspace. Containers take up less space than VMs (container images are typically tens of MBs in size) and start almost instantly.
  • A container image is a lightweight, stand-alone, executable package of a piece of software that includes everything needed to run it: code, runtime, system tools, system libraries, settings.
  • Containers run apps natively on the host machine’s kernel. They have better performance characteristics than virtual machines that only get virtual access to host resources through a hypervisor. Containers can get native access, each one running in a discrete process, taking no more memory than any other executable.

In this post, we are going to take look at optimizing the images using multi-stage builds. Multi-stage builds are a new feature requiring Docker 17.05 or higher on the daemon and client.

This quickstart assumes basic understanding of Docker concepts, please refer to earlier posts for understanding on Docker & how to install and containerize applications.

Why Multi-stage builds?

In your project, you would have two or more Dockerfiles i.e., one for Development and another one for Production. One file would have the steps to build the binary and artifacts using a development container, the second would be optimized for production and not include any of the development tools.

With a multi-stage builds feature, you can use multiple FROM statements in your Dockerfile. Each FROM instruction can use a different base, and each of them begins a new stage of the build. You can selectively copy artifacts from one stage to another, leaving behind everything you don’t want in the final image. To show how this works, Let’s adapt the Dockerfile from the previous section to use multi-stage builds. Example below :


FROM golang:1.7.3
WORKDIR /go/src/
RUN go get -d -v  
COPY app.go .
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o app .

FROM alpine:latest  
RUN apk --no-cache add ca-certificates
WORKDIR /root/
COPY --from=0 /go/src/ .
CMD ["./app"]  

Step #1. Setup Docker

  1. From the docker site, install the latest version of the docker for your platform. Docker is available in two editions: Community Edition (CE) and Enterprise Edition (EE). Docker Community Edition (CE) is ideal for developers and small teams looking to get started with Docker and experimenting with container-based apps. Docker Enterprise Edition (EE) is designed for enterprise development and IT teams who build, ship, and run business-critical applications in production at scale.
  2. Once the installation of docker is over, check the installation by running following command docker run hello-world:

    Image- docker hello world
  3. Run docker –version to check the version of the docker you’re running.

    Image- check docker version

OK, now we have got the docker setup,next step is to define the docker container.

Step #2. Create Multi-stage build Dockerfile for our container

List images using docker images command
Image – List images using docker images command

Before we start, use docker images command to check the list of images.

Using your favorite editor, create a Multi-Stage Dockerfile. The first stage using the Golang SDK to build a binary. The second stage copies the resulting binary into an optimised Docker Image.

FROM golang:1.6-alpine

RUN mkdir /app
ADD . /app/
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o main .

# Second Stage
FROM alpine
CMD ["/app"]

# Copy from first stage
COPY --from=0 /app/main /app

Step #3. Build Docker Image

Now that we have completed Dockerfile, next step is to build Docker image by docker build command 

Build the image using the docker build command below.

docker build -f m1docker -t golang-app .

Build container image using docker build command
Image – Build container image using docker build command

The result will be two images. One untagged that was used for the first stage and the second is the target image.

Congrats! Today you’ve successfully built container image using Multi stage build.

List the images using docker images command
Image – List the images using docker images command

When using multi-stage builds, you are not limited to copying from stages you created earlier in your Dockerfile. You can also use the COPY --from instruction to copy from a separate image, either using the local image name, a tag available locally or on a Docker registry, or a tag ID. The Docker client pulls the image if necessary and copies the artifact from there. Example below

COPY --from=nginx:latest /etc/nginx/nginx.conf /nginx.conf

There is much more to the Docker platform than what was covered here, but now you would have got a good idea of the basics of building containers using multi-stage builds.

Like this post? Don’t forget to share it!

Useful Resources:

About Post Author


Allo! My name is Karthik,experienced IT professional.Upnxtblog covers key technology trends that impacts technology industry.This includes 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.
0 %
0 %
0 %
0 %
0 %
0 %
Docker tutorial - Create Docker Images using Multi-stage builds
Article Name
Docker tutorial - Create Docker Images using Multi-stage builds
In this article, we are going to take look at optimizing the images using multi-stage builds.Multi-stage builds are a new feature requiring Docker 17.05 or higher.
Publisher Name
Publisher Logo

Average Rating

5 Star
4 Star
3 Star
2 Star
1 Star

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: