Microservices have become a popular architectural style for developing scalable and maintainable applications. In this blog post, we will explore how to build a simple microservice using the Go programming language and Docker. With Go\u2019s efficiency and Docker\u2019s containerization capabilities, we can create robust microservices that can be deployed easily and run reliably. Let\u2019s dive into the process step by step!<\/p>\n
Microservices are an architectural style that structures an application as a collection of small, independent services that communicate over well-defined APIs. Each service is responsible for a specific piece of functionality and can be developed, deployed, and scaled independently. This approach offers several advantages:<\/p>\n
Before we can start coding, we need to set up our development environment. This involves installing Go and Docker, which are essential for building and running our microservice.<\/p>\n
To install Go, you can follow the instructions on the official Go installation page<\/a>. After installation, verify it by running:<\/p>\n Docker can be installed by following the instructions on the official Docker installation page<\/a>. After installation, verify it with:<\/p>\n Now that we have our environment set up, let\u2019s create a simple Go microservice that exposes a RESTful API. The API will allow users to manage a list of books.<\/p>\n First, let\u2019s create a directory for our project:<\/p>\n Your project structure should look like this:<\/p>\n In the root of your project directory, initialize Go modules:<\/p>\n Now, let\u2019s create our main Go file to handle HTTP requests:<\/p>\n In the above code:<\/p>\n Run the microservice by executing the command:<\/p>\n Your microservice should now be up and running at To add a book, you can use the following curl command:<\/p>\n To retrieve the list of books:<\/p>\n Now that we\u2019ve built our Go microservice, the next step is to containerize it using Docker. This enables us to run our application in a consistent environment, regardless of where it is deployed.<\/p>\n In the root of your project directory, create a file named This Dockerfile does the following:<\/p>\n In your terminal, navigate to your project directory and build your Docker image with the following command:<\/p>\n After the build completes, you can run your container using:<\/p>\n Your microservice running inside a Docker container should still be accessible at While this example provides a basic understanding of microservices, consider these best practices when developing your own:<\/p>\n In this tutorial, we built a simple microservice using Go and Docker. We explored how to structure the Go application, set up a RESTful API, and containerize the application using Docker. By leveraging Go’s high performance and Docker’s powerful capabilities, you can scale and deploy your microservices with ease.<\/p>\n As you advance in your microservices journey, remember to adhere to best practices and continuously look for opportunities to enhance your architecture for better scalability, maintainability, and resilience. Happy coding!<\/p>\n Building a Simple Microservice with Go and Docker Microservices have become a popular architectural style for developing scalable and maintainable applications. In this blog post, we will explore how to build a simple microservice using the Go programming language and Docker. With Go\u2019s efficiency and Docker\u2019s containerization capabilities, we can create robust microservices that can<\/p>\n","protected":false},"author":83,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[181,196],"tags":[1039,1211,387,384,1306],"class_list":["post-11154","post","type-post","status-publish","format-standard","category-go","category-microservices","tag-backend","tag-development","tag-docker","tag-go","tag-microservices"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/posts\/11154","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/users\/83"}],"replies":[{"embeddable":true,"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/comments?post=11154"}],"version-history":[{"count":1,"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/posts\/11154\/revisions"}],"predecessor-version":[{"id":11155,"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/posts\/11154\/revisions\/11155"}],"wp:attachment":[{"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/media?parent=11154"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/categories?post=11154"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/namastedev.com\/blog\/wp-json\/wp\/v2\/tags?post=11154"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}go version<\/code><\/pre>\nInstalling Docker<\/h3>\n
docker --version<\/code><\/pre>\nCreating a Simple Go Microservice<\/h2>\n
Step 1: Project Structure<\/h3>\n
mkdir go-microservice\ncd go-microservice<\/code><\/pre>\ngo-microservice\/\n\u251c\u2500\u2500 main.go\n\u2514\u2500\u2500 go.mod<\/code><\/pre>\nStep 2: Initialize Go Modules<\/h3>\n
go mod init go-microservice<\/code><\/pre>\nStep 3: Writing the Go Microservice<\/h3>\n
package main\n\nimport (\n \"encoding\/json\"\n \"log\"\n \"net\/http\"\n \"sync\"\n)\n\ntype Book struct {\n ID string `json:\"id\"`\n Title string `json:\"title\"`\n Author string `json:\"author\"`\n}\n\nvar (\n books = make(map[string]Book)\n mu sync.Mutex\n)\n\nfunc getBooks(w http.ResponseWriter, r *http.Request) {\n mu.Lock()\n defer mu.Unlock()\n\n w.Header().Set(\"Content-Type\", \"application\/json\")\n json.NewEncoder(w).Encode(books)\n}\n\nfunc addBook(w http.ResponseWriter, r *http.Request) {\n var book Book\n if err := json.NewDecoder(r.Body).Decode(&book); err != nil {\n http.Error(w, err.Error(), http.StatusBadRequest)\n return\n }\n\n mu.Lock()\n books[book.ID] = book\n mu.Unlock()\n\n w.WriteHeader(http.StatusCreated)\n json.NewEncoder(w).Encode(book)\n}\n\nfunc main() {\n http.HandleFunc(\"\/books\", getBooks)\n http.HandleFunc(\"\/books\/add\", addBook)\n\n log.Println(\"Server is running on port 8080...\")\n log.Fatal(http.ListenAndServe(\":8080\", nil))\n}\n<\/code><\/pre>\n\n
Book<\/code> struct.<\/li>\ngetBooks<\/code> and addBook<\/code> manage the list of books.<\/li>\nTesting Our Microservice<\/h2>\n
go run main.go<\/code><\/pre>\nhttp:\/\/localhost:8080<\/code>. You can test it using tools like Postman<\/strong> or curl<\/strong>.<\/p>\ncurl -X POST http:\/\/localhost:8080\/books\/add -d '{\"id\":\"1\",\"title\":\"The Go Programming Language\",\"author\":\"Alan A. A. Donovan\"}' -H \"Content-Type: application\/json\"<\/code><\/pre>\ncurl http:\/\/localhost:8080\/books<\/code><\/pre>\nContainerizing Our Microservice with Docker<\/h2>\n
Step 1: Creating a Dockerfile<\/h3>\n
Dockerfile<\/code>:<\/p>\nFROM golang:1.18 AS builder\nWORKDIR \/go\/src\/app\nCOPY . .\n\nRUN go mod tidy\nRUN go build -o microservice\n\nFROM gcr.io\/distroless\/base\nWORKDIR \/app\nCOPY --from=builder \/go\/src\/app\/microservice .\n\nCMD [\"\/app\/microservice\"]<\/code><\/pre>\n\n
Step 2: Building the Docker Image<\/h3>\n
docker build -t go-microservice .<\/code><\/pre>\ndocker run -p 8080:8080 go-microservice<\/code><\/pre>\nStep 3: Testing the Dockerized Microservice<\/h3>\n
http:\/\/localhost:8080<\/code>. You can test it the same way you did earlier. This not only confirms that the microservice works but also showcases the power of Docker in creating portable applications.<\/p>\nBest Practices for Building Microservices<\/h2>\n
\n
Conclusion<\/h2>\n
Resources<\/h2>\n
\n