Golang Development: How To Deploy a Golang Web Application with Docker

If you are also a Golang web developer like me, You must be probably knowing that Go code can be compiled into binary code and does not need Go environment to run. Also, we know that Golang web applications will have templates and configuration files. When we have a large number of files in our project, there is the possibility that some of the files may not be synced. This may lead to a lot of errors and issues.

Here comes the role of Docker. By using docker the files can be kept in sync with binary. So we can overcome these type of issues using Docker.

In this Blog, I’m going to discuss how to create Docker container for Golang web application and deploying Docker container.

Image Credit:docker.com


At first, you need:

Creating simple Go web application:

For your understanding and demonstration, I have created a sample web application here. This application uses HTML templates for views and exposes routes for the contact form.

Directory structure:

Our web application directory structure looks like,

 ├── Dockerfile
 └── views
 └── forms.html

Content of main.go:

// main.go
package main
import (
// contact details structure
type ContactDetails struct {
Email   string
Department string
Description string
// Execution start with main function
func main() {
// Handle http requests with home path / with the formHandler function.
http.HandleFunc("/", formHandler)
http.ListenAndServe(":8080", nil)
// formHandler is an HTTP handler, it serves form template
func formHandler(w http.ResponseWriter, r *http.Request) {
_, filename, _, ok := runtime.Caller(0)
if !ok {
fmt.Println("No caller information")
// get template from views directory
tmpl := template.Must(template.ParseFiles(path.Dir(filename)+"/views/forms.html"))
if r.Method != http.MethodPost {
// render template
tmpl.Execute(w, nil)
// read field values from form
details := ContactDetails{
Email:   r.FormValue("email"),
Department: r.FormValue("department"),
Description: r.FormValue("description"),
// do something with details
_ = details
// pass value to form
tmpl.Execute(w, struct{ Success bool }{true})

Content of forms.html:

<!-- forms.html -->
{{if .Success}}
<!-- submission response -->
<h1>Thanks for your message!</h1>
<!-- Initial render page -->
<form method="POST">
<label>Email:</label><br />
<input type="text" name="email"><br />
<label>Department:</label><br />
<input type="text" name="department"><br />
<label>Description:</label><br />
<textarea name="description"></textarea><br />
<input type="submit">

Write a Dockerfile for Docker build:

Now we need to write a Dockerfile for building our Docker image to install and run our Go HTTP server in a Docker container. This Dockerfile contains all the commands required to construct Docker image. So by reading these instructions from Dockerfile Docker builds images.

The content of Dockerfile:

From golang:latest
ADD . /go/src/github.com/agiratech/contact_registry
# Build the contact_registry command inside the container.
RUN go install github.com/agiratech/contact_registry
# Run the contact_registry command when the container starts.
ENTRYPOINT /go/bin/contact_registry
# http server listens on port 8080.

The image name golang:latest means that we are building our image from Golang image with the latest tag. Then, we install our Golang application to the bin folder of Gopath and setting up the entry point for the app.

Build the Docker image:

Run the below-given command, it creates the image from contact_registry directory that builds Docker image.

$ sudo docker build -t reddysai/contact_registry.

The build command reads our instructions from Dockerfile. In the Dockerfile,

  • FROM golang:latest fetches the golang:latest image.
  • ADD- adds the package source into Gopath of golang image.
  • RUN- builds the Go package.
  • ENTRYPOINT — set up the entry point for our container for running the reddysai/contact_registry.
  • EXPOSE — exposes port 8080 for HTTP server.

The above process creates an image with name reddysai/contact_registry. It can be used by all the people who works on this application.

The following command allows you to see all the images in the list:

$ sudo docker images

Run and test the Docker image:

Using the following command run the Docker image. We have to publish an external port to container’s port 8080.

$ sudo docker run -p 6060:8080 --rm reddysai/contact_registry
  • Executing this command runs the Docker image. This container exposes application on port 6060.The docker run -runs a container from an image.
  • –rm flag — it will clean container once the container shuts down.
  • The -p 6060:8080 flag — It makes the container get accessed at port 6060.

Visit in your browser with http://localhost:6060/ to see it running.

Check the running containers using the following command,

$ sudo docker ps -a

Run the following command to stop the docker image,

$ sudo docker stop CONTAINER ID

Push the docker image into Docker Hub

$ sudo docker push reddysai/contact_registry

Now, you can run this docker image easily like,

$ sudo docker run -p 6060:8080 --name test --rm reddysai/contact_registry

Now we have learned to create a Docker container for Golang web application and deploying Docker container. You can also deploy this application to your servers by following the same procedure. For this the server needs a Docker installed.

Have any doubts or queries? Comment below. For more on golang follow our blog. Our golang experts at Agira have written many informative blogs on Golang.

Originally published at www.agiratech.com on September 5, 2017.

Like what you read? Give Agira Technologies a round of applause.

From a quick cheer to a standing ovation, clap to show how much you enjoyed this story.