グレースフルリスタートまたは停止

ウェブサーバーをスムーズに再起動または停止したいですか?いくつかの方法があります。

デフォルトのListenAndServeを置き換えるためにfvbock/endlessを使用できます。詳細は、issue #296を参照してください。

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

endlessの代替手段

  • manners:スムーズにシャットダウンするGoのHTTPサーバー。
  • graceful:gracefulは、http.Handlerサーバーのグレースフルシャットダウンを可能にするGoパッケージです。
  • grace:Goサーバーのグレースフル再起動とゼロダウンタイムデプロイ。

Go 1.8を使用している場合は、このライブラリを使用する必要がない場合があります!グレースフルシャットダウンには、http.Serverの組み込みのShutdown()メソッドの使用を検討してください。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.Handler(),
	}

	go func() {
		// service connections
		if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
			log.Fatalf("listen: %s\n", err)
		}
	}()

	// Wait for interrupt signal to gracefully shutdown the server with
	// a timeout of 5 seconds.
	quit := make(chan os.Signal, 1)
	// kill (no param) default send syscall.SIGTERM
	// kill -2 is syscall.SIGINT
	// kill -9 is syscall. SIGKILL but can"t be catch, 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)
	}
	// catching ctx.Done(). timeout of 5 seconds.
	select {
	case <-ctx.Done():
		log.Println("timeout of 5 seconds.")
	}
	log.Println("Server exiting")
}
最終更新日 2024年5月10日:Bump GitHub action workflows (#276) (4371021)