systemd daemon на Go: пример с graceful shutdown

Пошаговый туториал по созданию systemd-сервиса на Go с корректной обработкой SIGTERM и примерами unit-файлов. Выполнение примера займёт около 20–40 минут на современной машине (2025).

Как написать unit?

Unit-файл описывает поведение сервиса. В примере ниже показан оптимальный набор опций: Restart, RestartSec, RuntimeDirectory, MemoryAccounting, CPUAccounting и лимиты. Файл лежит в /etc/systemd/system/mygo.service. Ниже — консервативный пример для 2026.

[Unit]
Description=MyGoDaemon service
After=network.target
Wants=network-online.target

[Service]
Type=simple
User=www-data
Group=www-data
WorkingDirectory=/opt/mygo
ExecStart=/opt/mygo/mygo-daemon --config /etc/mygo/config.yaml
Restart=on-failure
RestartSec=5s
TimeoutStopSec=20s
KillMode=control-group
RuntimeDirectory=mygo
Environment=GOGC=100
# Ограничение ресурсов (пример 200M памяти, 50% ЦП)
MemoryMax=200M
CPUQuota=50%
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

Типовой размер скомпилированного бинаря Go 1.22 (linux/amd64) — 2–6 МБ без статической линковки. Включение отладочной информации и cgo может увеличить размер до 10–30 МБ.

Как обрабатывать SIGTERM?

systemd при остановке отправляет SIGTERM и ждёт завершения в пределах TimeoutStopSec. Go-программа должна ловить сигнал, отменять контекст и аккуратно завершать горутины и открытые ресурсы (network listeners, db connections). Приведённый ниже пример использует context, sync.WaitGroup и канал сигналов.

package main

import (
    "context"
    "log"
    "net/http"
    "os"
    "os/signal"
    "sync"
    "syscall"
    "time"
)

func main() {
    ctx, cancel := context.WithCancel(context.Background())
    wg := &sync.WaitGroup{}

    srv := &http.Server{Addr: ":8080\