Как остановить Go-сервис по SIGTERM и не оборвать запросы, которые он сейчас обрабатывает?
Проверила команда Сопровод · Обновлено
Короткий ответ
Подпишитесь на SIGTERM через signal.NotifyContext: сигнал отменит контекст, и процесс не завершится мгновенно. Дождавшись ctx.Done(), вызовите srv.Shutdown с таймаутом: сервер закроет слушатели и простаивающие соединения и дождется активных запросов. ListenAndServe при этом вернет http.ErrServerClosed, это штатный выход. Таймаут держите меньше срока, после которого оркестратор пришлет SIGKILL.
Почему этот вопрос задают
При каждой выкладке старые экземпляры сервиса получают SIGTERM. Если остановка обрывает запросы, пользователи видят ошибки на каждом деплое, а платежи зависают в непонятном состоянии.
Как рассуждать
- Перехватите SIGTERM через
signal.NotifyContext: сигнал отменит контекст, а процесс продолжит работу - Вызовите
srv.Shutdownс таймаутом и объясните, что он закрывает и чего ждет - Остановите свои горутины и воркеры через тот же контекст и
sync.WaitGroup - Закройте пул базы и соединение с брокером последними, когда запросы уже доработали
- Сверьте сроки: таймаут
ShutdownменьшеterminationGracePeriodSecondsпода
Ответ с примером
Водители платят за городские парковки через сервис на Go, а новую версию ставят несколько раз в день. При каждой выкладке Kubernetes шлет поду SIGTERM и через 30 секунд по умолчанию добивает его SIGKILL. В примере процесс сам отправляет себе SIGTERM: NotifyContext перехватил сигнал, программа продолжила работу, а context.Cause назвал причину. Затем Shutdown получает контекст со сроком 5 секунд из context.WithTimeout: закрывает слушатели, потом простаивающие соединения и ждет активные запросы, пока срок не истек. Первая строка вывода — причина отмены и результат Shutdown: соединений здесь нет, и он сразу вернул nil.
Любой вызов ListenAndServe после этого возвращает http.ErrServerClosed. В настоящем main сервер работает в горутине, и эту ошибку отделяют от падения через errors.Is. Оплата, которая шла в момент сигнала, успевает дойти до банка и вернуть ответ водителю.
func main() {
sig, stop := signal.NotifyContext(context.Background(), syscall.SIGTERM)
defer stop()
srv := &http.Server{Addr: ":8080"}
syscall.Kill(syscall.Getpid(), syscall.SIGTERM)
<-sig.Done()
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
fmt.Println(context.Cause(sig), srv.Shutdown(ctx))
err := srv.ListenAndServe()
fmt.Println(err, errors.Is(err, http.ErrServerClosed))
}terminated signal received <nil> http: Server closed true
Как ответить сильнее
Что добавит опытный кандидат
Что спросят следом
Доступно по подписке
Приемы опытных и готовые ответы
Частые ошибки
«
Shutdownсразу обрывает все соединения»Поправьте: соединения сразу обрывает
srv.Close.Shutdownзакрывает слушатели и простаивающие соединения и ждет, пока активные запросы закончатся или истечет контекст«Поставлю таймаут
Shutdownв минуту, чтобы все точно доработало»Сверьте его со сроком оркестратора: Kubernetes по умолчанию ждет 30 секунд и шлет SIGKILL. Таймаут длиннее срока бесполезен, процесс убьют посреди ожидания
«Запущу
Shutdownв горутине, аmainпусть завершается»Скажите, что
mainдолжен дождаться возвратаShutdown. Документацияnet/httpпрямо предупреждает: иначе программа выйдет раньше, чем доработают запросы«SIGKILL тоже можно перехватить и успеть доработать запросы»
Объясните, что SIGKILL перехватить нельзя, процесс останавливает ядро. Все, что нужно сделать при выходе, делайте по SIGTERM
Сигналы для интервьюера
Сильный ответ
Описывает остановку по шагам с конкретными таймаутами и связывает срок Shutdown со сроком, который оркестратор дает до SIGKILL
Тревожный сигнал
Правильно вызывает srv.Shutdown, но не может сказать, что при остановке будет с фоновыми горутинами и соединением с базой
Красный флаг
Считает, что хватит os.Exit(0) в обработчике сигнала, ведь «клиенты все равно повторят запрос сами»
Как еще могут спросить
- Что такое graceful shutdown в Go?
- Как корректно завершить HTTP-сервер на Go?
- Как обработать сигналы SIGINT и SIGTERM в Go-приложении?
- Зачем нужен метод
Shutdownуhttp.Server?











