Arrêt progressif
Gérer les signaux du système d’exploitation et vider les connexions
Arrêt progressif est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.
Pourquoi un arrêt progressif ?
Appeler os.Exit ou simplement arrêter le serveur abandonne toutes les requêtes en cours. Un arrêt progressif attend la fin des requêtes actives avant de quitter.
http.Server.Shutdown
srv.Shutdown(ctx) cesse d’accepter de nouvelles connexions, attend la fin des requêtes actives, puis retourne. Transmettez-lui un contexte avec une échéance pour limiter la durée d’attente.
ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
srv.Shutdown(ctx)Gestion des signaux
Écoutez SIGINT/SIGTERM dans une goroutine et appelez Shutdown lorsqu’un signal est reçu :
quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit
log.Println("shutting down...")
srv.Shutdown(ctx)Modèle complet d’arrêt progressif
Démarrez le serveur dans une goroutine ; bloquez sur le canal de signaux ; puis arrêtez le serveur :
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
Après l’appel de Shutdown, ListenAndServe renvoie http.ErrServerClosed. Traitez cela comme une sortie normale, et non comme une erreur.
Épuisement des connexions
Shutdown attend toutes les connexions détournées et les connexions WebSocket actives uniquement si le gestionnaire respecte lui-même l’annulation du contexte. Les gestionnaires de requêtes longues ou de traitement en continu doivent vérifier r.Context().Done().
Délai d’arrêt
Définissez un délai d’arrêt raisonnable (10 à 30 s). Si des requêtes sont toujours en cours après l’échéance, Shutdown renvoie context.DeadlineExceeded et les connexions restantes sont fermées de force.
Nettoyage lors de l’arrêt
Après le retour de Shutdown, fermez les pools de connexions aux bases de données, videz les tampons de journaux et libérez les autres ressources dans l’ordre. Utilisez defer ou un enchaînement explicite.
srv.Shutdown(ctx)
db.Close()
logger.Sync()Server.Close ou Server.Shutdown
srv.Close() ferme immédiatement toutes les connexions sans attendre. Utilisez-le uniquement lorsqu’un arrêt forcé est acceptable (par exemple, lors des essais).
Sonde de disponibilité Kubernetes
Pendant l’arrêt, faites en sorte que la sonde de disponibilité renvoie 503 avant d’appeler Shutdown. Le répartiteur de charge cessera ainsi d’acheminer de nouvelles requêtes vers le pod.
Serveurs multiples
Si vous exécutez plusieurs serveurs (HTTP + gRPC + métriques), arrêtez-les simultanément avec des goroutines et utilisez un WaitGroup pour attendre qu’ils aient tous terminé leur traitement.
Vérification rapide
Que fait http.Server.Shutdown ?
Récapitulatif : arrêt progressif
Points clés :
- srv.Shutdown(ctx) arrête les nouvelles connexions et attend la fin des connexions actives
- Écoutez SIGINT/SIGTERM avec signal.Notify
- ListenAndServe renvoie http.ErrServerClosed lors de l’arrêt — ce n’est pas une erreur
- Définissez une échéance d’arrêt pour éviter d’attendre indéfiniment
Apprends Go avec un tuteur IA — gratuit
Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.
- Cours
- 51
- Leçons
- 203
Questions Fréquemment Posées
La leçon « Arrêt progressif » est-elle gratuite ?
Oui — le texte complet de « Arrêt progressif » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Arrêt progressif » ?
Gérer les signaux du système d’exploitation et vider les connexions Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Go Academy ?
Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.
Combien de temps prend la leçon « Arrêt progressif » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?
Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.