Arresto graduale
Gestire i segnali del sistema operativo e svuotare le connessioni
Arresto graduale è una lezione Go Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Go Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Go Academy include 4 lezioni in totale.
Perché un arresto graduale?
Chiamare os.Exit o fermare semplicemente il server fa perdere tutte le richieste in corso. L'arresto graduale attende il completamento delle richieste attive prima di terminare.
http.Server.Shutdown
srv.Shutdown(ctx) smette di accettare nuove connessioni, attende il completamento delle richieste attive, quindi restituisce il controllo. Passi un contesto con una scadenza per limitare il tempo di attesa.
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
srv.Shutdown(ctx)Gestione dei segnali
Ascolti SIGINT/SIGTERM in una goroutine e chiami Shutdown quando viene ricevuto:
quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit
log.Println("shutting down...")
srv.Shutdown(ctx)Pattern completo per l'arresto graduale
Avvii il server in una goroutine, attenda sul canale dei segnali, quindi esegua l'arresto:
go func() {
if err := srv.ListenAndServe(); err != http.ErrServerClosed {
log.Fatal(err)
}
}()
quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit
srv.Shutdown(ctx)http.ErrServerClosed
Dopo la chiamata a Shutdown, ListenAndServe restituisce http.ErrServerClosed. Lo consideri una terminazione normale, non un errore.
Chiusura graduale delle connessioni
Shutdown attende tutte le connessioni sottoposte a hijacking e le connessioni WebSocket attive solo se il gestore rispetta direttamente l'annullamento del contesto. I gestori di long polling o streaming devono controllare r.Context().Done().
Timeout dell'arresto
Imposti un timeout ragionevole per l'arresto (10-30 s). Se al termine della scadenza sono ancora in esecuzione delle richieste, Shutdown restituisce context.DeadlineExceeded e le connessioni rimanenti vengono chiuse forzatamente.
Pulizia durante l'arresto
Dopo la restituzione di Shutdown, chiuda i pool di connessioni al database, svuoti i buffer dei log e rilasci le altre risorse nell'ordine corretto. Utilizzi defer o una sequenza esplicita.
srv.Shutdown(ctx)
db.Close()
logger.Sync()Server.Close e Server.Shutdown
srv.Close() chiude immediatamente tutte le connessioni senza attendere. Lo utilizzi solo quando è accettabile un arresto forzato, ad esempio nei test.
Probe di readiness di Kubernetes
Durante l'arresto, aggiorni la probe di readiness in modo che restituisca 503 prima di chiamare Shutdown. In questo modo segnala al bilanciatore del carico di smettere di instradare nuove richieste al pod.
Più server
Se esegue più server, ad esempio HTTP + gRPC + metriche, li arresti contemporaneamente con le goroutine e utilizzi un WaitGroup per attendere che tutti completino il drenaggio.
Verifica rapida
Che cosa fa http.Server.Shutdown?
Riepilogo: arresto graduale
Punti chiave:
- srv.Shutdown(ctx) interrompe le nuove connessioni e attende quelle attive
- Ascoltare SIGINT/SIGTERM con signal.Notify
- ListenAndServe restituisce http.ErrServerClosed durante l'arresto — non è un errore
- Impostare una scadenza per l'arresto per evitare attese infinite
Impara Go con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 51
- Lezioni
- 203
Domande Frequenti
La lezione «Arresto graduale» è gratuita?
Sì — il testo completo di «Arresto graduale» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Go Academy, passa a CoddyKit PRO. Il corso Go Academy include 4 lezioni in totale.
Cosa imparerò in «Arresto graduale»?
Gestire i segnali del sistema operativo e svuotare le connessioni Eserciti Go Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Go Academy?
Non è richiesta alcuna esperienza precedente. Go Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.
Quanto tempo richiede la lezione «Arresto graduale»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Go Academy?
Sì. Ogni lezione Go Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.