// Package server runs the HTTP listener with a graceful stop behind a load // balancer. package server import ( "context" "errors" "log/slog" "net" "net/http" "time" ) // Readiness is switched off when shutdown starts. type Readiness interface { SetReady(ready bool) } // Run serves until ctx is cancelled, keeps serving for drainDelay with // readiness off, then shuts down within shutdownTimeout. The balancer learns // of the stop only from failing readiness checks, so drainDelay must exceed // its detection time. func Run(ctx context.Context, log *slog.Logger, ln net.Listener, h http.Handler, ready Readiness, drainDelay, shutdownTimeout time.Duration) error { srv := &http.Server{ Handler: h, ReadHeaderTimeout: 5 * time.Second, ReadTimeout: 10 * time.Second, WriteTimeout: 10 * time.Second, IdleTimeout: 60 * time.Second, MaxHeaderBytes: 64 * 1024, ErrorLog: slog.NewLogLogger(log.Handler(), slog.LevelWarn), } served := make(chan error, 1) go func() { err := srv.Serve(ln) if errors.Is(err, http.ErrServerClosed) { err = nil } served <- err }() log.Info("listening", "addr", ln.Addr().String()) select { case err := <-served: return err case <-ctx.Done(): } log.Info("shutdown started", "drain_delay", drainDelay.String(), "timeout", shutdownTimeout.String()) ready.SetReady(false) time.Sleep(drainDelay) drain, cancel := context.WithTimeout(context.Background(), shutdownTimeout) defer cancel() if err := srv.Shutdown(drain); err != nil { log.Error("shutdown forced", "error", err.Error()) _ = srv.Close() return err } <-served log.Info("shutdown completed") return nil } // RunDebug serves the internal metrics until ctx is cancelled; no request // depends on them, so it stops without draining. func RunDebug(ctx context.Context, log *slog.Logger, ln net.Listener, h http.Handler) error { srv := &http.Server{ Handler: h, ReadHeaderTimeout: 5 * time.Second, WriteTimeout: 10 * time.Second, ErrorLog: slog.NewLogLogger(log.Handler(), slog.LevelWarn), } go func() { <-ctx.Done() _ = srv.Close() }() log.Info("debug listening", "addr", ln.Addr().String()) if err := srv.Serve(ln); !errors.Is(err, http.ErrServerClosed) { return err } return nil }