How to Design Microservices in Go

Design microservices in Go by defining small, single-responsibility binaries that communicate via HTTP or gRPC and share no state. Start by creating a new module, implementing a handler that accepts a context for cancellation, and running the server with graceful shutdown support.

package main

import (
	"context"
	"log"
	"net/http"
	"os"
	"os/signal"
	"syscall"
	"time"
)

func main() {
	mux := http.NewServeMux()
	mux.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
		w.WriteHeader(http.StatusOK)
	})

	server := &http.Server{
		Addr:    ":8080",
		Handler: mux,
	}

	go func() {
		log.Println("Server starting on :8080")
		if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
			log.Fatalf("ListenAndServe: %v", err)
		}
	}()

	quit := make(chan os.Signal, 1)
	signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
	<-quit

	log.Println("Shutting down server...")
	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
	defer cancel()

	if err := server.Shutdown(ctx); err != nil {
		log.Fatalf("Server forced to shutdown: %v", err)
	}
	log.Println("Server exited")
}

1. Initialize the module with go mod init example.com/microservice.
2. Create a main.go file containing the HTTP server and signal handling logic shown above.
3. Run the service locally using go run main.go.
4. Build a static binary for deployment with go build -o microservice main.go.
5. Deploy the binary to your container orchestration platform.

Designing microservices in Go means building small, independent programs that each do one specific job well. You write code that listens for requests over the network, processes them, and shuts down cleanly when told to stop. Think of it like hiring specialized workers for a factory, where each worker has their own station and only talks to others when necessary.