graceful restart と stop

graceful restart と stop をしたいですか？ いくつかの方法があります。

fvbock/endless を使って、デフォルトの ListenAndServe を置き換えることができます。詳細は Issue #296 を参照ください。

[...]

router := gin.Default()
router.GET("/", handler)
endless.ListenAndServe(":4242", router)

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.

もし Go 1.8 を使っているなら、これらのライブラリを使う必要はないかもしれません！http.Server 組み込みの Shutdown() メソッドを、graceful shutdowns に利用することを検討してみてください。詳細は Gin の graceful-shutdown サンプルコードを見てみてください。

// +build go1.8

package main

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

  "github.com/gin-gonic/gin"
)

func main() {
  router := gin.Default()
  router.GET("/", func(c *gin.Context) {
    time.Sleep(5 * time.Second)
    c.String(http.StatusOK, "Welcome Gin Server")
  })

  srv := &http.Server{
    Addr:    ":8080",
    Handler: router,
  }

  go func() {
    // サービスの接続
    if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
      log.Fatalf("listen: %s\n", err)
    }
  }()

  // シグナル割り込みを待ち、タイムアウト時間が5秒の graceful shutdown をする
  quit := make(chan os.Signal, 1)
  // kill (no param) default sends syscall.SIGTERM
  // kill -2 is syscall.SIGINT
  // kill -9 is syscall. SIGKILL but can't be caught, so don't need add it
  signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
  <-quit
  log.Println("Shutdown Server ...")

  ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
  defer cancel()
  if err := srv.Shutdown(ctx); err != nil {
    log.Fatal("Server Shutdown:", err)
  }
  // ctx.Done() をキャッチする。5秒間のタイムアウト。
  select {
  case <-ctx.Done():
    log.Println("timeout of 5 seconds.")
  }
  log.Println("Server exiting")
}