Graceful restart or stop

Do you want to graceful restart or stop your web server?
There are some ways this can be done.

We can use fvbock/endless to replace the default ListenAndServe. Refer issue #296 for more details.

  1. router := gin.Default()
  2. router.GET("/", handler)
  3. // [...]
  4. endless.ListenAndServe(":4242", router)

An alternative to endless:

  • manners: A polite Go HTTP server that shuts down gracefully.
  • graceful: Graceful is a Go package enabling graceful shutdown of an http.Handler server.
  • grace: Graceful restart & zero downtime deploy for Go servers.

If you are using Go 1.8, you may not need to use this library! Consider using http.Server’s built-in Shutdown() method for graceful shutdowns. See the full graceful-shutdown example with gin.

  1. // +build go1.8
  3. package main
  5. import (
  6.     "context"
  7.     "log"
  8.     "net/http"
  9.     "os"
  10.     "os/signal"
  11.     "time"
  13.     "github.com/gin-gonic/gin"
  14. )
  16. func main() {
  17.     router := gin.Default()
  18.     router.GET("/", func(c *gin.Context) {
  19.         time.Sleep(5 * time.Second)
  20.         c.String(http.StatusOK, "Welcome Gin Server")
  21.     })
  23.     srv := &http.Server{
  24.         Addr:    ":8080",
  25.         Handler: router,
  26.     }
  28.     go func() {
  29.         // service connections
  30.         if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
  31.             log.Fatalf("listen: %s\n", err)
  32.         }
  33.     }()
  35.     // Wait for interrupt signal to gracefully shutdown the server with
  36.     // a timeout of 5 seconds.
  37.     quit := make(chan os.Signal)
  38.     signal.Notify(quit, os.Interrupt)
  39.     <-quit
  40.     log.Println("Shutdown Server ...")
  42.     ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
  43.     defer cancel()
  44.     if err := srv.Shutdown(ctx); err != nil {
  45.         log.Fatal("Server Shutdown:", err)
  46.     }
  47.     log.Println("Server exiting")
  48. }