Systemd模板单元实例的有序重启方案咨询

你好，从你的描述来看，你已经基于systemd模板搭建了多端口服务的管理架构，用services.target实现批量启停，但现在遇到的核心痛点是没法通过target实现逐个重启实例——毕竟所有服务都提供相同API，同时重启会导致服务中断。目前你靠bash脚本逐个处理，但觉得不够便捷，下面给你几个更贴合systemd生态的灵活解决方案：

方案一：给模板单元加自定义ExecReload，实现单实例可控重启 #

你可以在service@.service的[Service]段添加一个自定义的ExecReload指令，把“停止-等待-启动”的逻辑封装进去，之后就能通过systemctl reload来触发单个实例的优雅重启，再配合简单脚本批量处理：

先修改你的模板单元：

[Unit]
After=network.target
PartOf=services.target

[Service]
ExecStart=app run --port %i
ExecStopPost=sleep 5
# 自定义重载逻辑，实现单实例的重启流程
ExecReload=/bin/sh -c "systemctl stop %n; sleep 5; systemctl start %n"

[Install]
WantedBy=multi-user.target

然后写一个轻量的批量重启脚本restart-services.sh：

#!/bin/bash
# 自动遍历所有已运行的service@实例
for service in $(systemctl list-units --full --all -t service --no-legend | grep 'service@' | awk '{print $1}'); do
    echo "正在重启 $service..."
    systemctl reload $service
    # 可选：等待前一个实例启动完成再处理下一个，按需调整时长
    sleep 10
done

给脚本加执行权限（chmod +x restart-services.sh）后，直接运行就能逐个重启所有实例，完全不用修改现有的target配置，新增或删除实例也不用调整脚本，灵活性拉满。

方案二：利用systemd内置参数，实现故障时的自动有序恢复 #

如果你的需求是服务故障时自动逐个重启，而非手动触发批量重启，可以在模板单元里配置以下参数，让systemd帮你控制重启节奏：

[Service]
ExecStart=app run --port %i
ExecStopPost=sleep 5
Restart=on-failure
# 限制1分钟内最多重启2次，避免雪崩式重启
StartLimitInterval=60s
StartLimitBurst=2
# 每次重启间隔10秒，确保实例逐个恢复
RestartSec=10

这样当某个实例故障时，systemd会自动重启它，且通过RestartSec错开重启时间，不会同时触发所有实例的重启，避免服务完全中断。

方案三：用systemd-run创建临时服务，灵活触发逐个重启 #

如果你不想修改现有模板，也不想维护固定脚本，可以用systemd-run创建一个临时的systemd服务，后台执行逐个重启的逻辑：

systemd-run --unit=restart-services --description="逐个重启服务实例" \
/bin/sh -c "for port in 8081 8082; do systemctl restart service@\$port.service; sleep 10; done"

这个命令会创建一个临时服务，后台处理重启流程，你可以通过systemctl status restart-services查看进度，完成后临时单元会自动被清理，非常适合临时触发的场景。

关于你提到的notify机制 #

systemd的Type=notify主要是让服务主动告知systemd自己已经完全启动就绪，它本身不能直接实现有序重启，但可以和上面的方案结合，让重启流程更可靠：比如在模板里设置Type=notify，并确保你的应用支持发送notify信号，之后脚本里的固定sleep就可以换成等待服务就绪的命令：

#!/bin/bash
for port in 8081 8082; do
    echo "正在重启 service@$port.service..."
    systemctl restart service@$port.service
    # 等待服务进入active（就绪）状态，比固定sleep更可靠
    systemctl is-active --wait service@$port.service
done

这样就不用猜sleep时长，能确保前一个实例完全启动后再处理下一个，避免重启重叠导致的服务中断。

备注：内容来源于stack exchange，提问作者thiebaut fischer