Linux 与服务器运维 / 系统课时

notify 怎样报告真正启动完成

notify 怎样报告真正启动完成

复杂服务常常在进程创建后还要加载配置、恢复状态、监听端口或建立外部连接。Type=notify 让 systemd 不把“进程已经启动”误当成“服务已经可用”,而是等待服务主动发送 READY=1。本课用 sd_notify() 演示从初始化到真正就绪的完整握手。

学习目标

  • 理解 Type=notify 与立即判定启动成功的区别
  • 使用 sd_notify() 发送 READY=1 和状态信息
  • 判断通知未送达或迟迟未就绪时的排查方向

notify 把就绪判定交给服务自身

对于 Type=notify,systemd 启动主进程后会让单元保持在 activating。服务完成自己的初始化后,通过通知套接字发送 READY=1,systemd 才把启动任务视为完成,并将单元推进到 active。

这解决了一个关键问题:systemd 不需要猜“睡几秒才算启动好”。真正了解初始化是否完成的是服务本身,因此由服务在完成配置加载、数据恢复、端口监听等必要步骤后报告就绪更可靠。

Type=notify 的启动握手时序

用 sd_notify 报告初始化完成

下面的 C 程序模拟一个需要两秒初始化的服务。它先设置状态文本,完成初始化后发送 READY=1,然后保持前台运行;收到 SIGTERM 时退出。

c
#include <signal.h>
#include <systemd/sd-daemon.h>
#include <unistd.h>

static volatile sig_atomic_t running = 1;

static void handle_term(int signo) {
    (void) signo;
    running = 0;
}

int main(void) {
    signal(SIGTERM, handle_term);

    sd_notify(0, "STATUS=Initializing");
    sleep(2);

    sd_notify(0, "READY=1\nSTATUS=Ready to accept requests");

    while (running) {
        pause();
    }

    sd_notify(0, "STOPPING=1\nSTATUS=Stopping");
    return 0;
}

预期结果:

text
程序不向标准输出打印内容;初始化约 2 秒后发送 READY=1,并继续以前台进程运行。

在已安装 libsystemd 开发文件和 pkg-config 的系统上,可以编译并安装程序:

bash
cc -O2 -Wall -Wextra -o notify-demo notify-demo.c $(pkg-config --cflags --libs libsystemd)   && sudo install -m 0755 notify-demo /usr/local/sbin/notify-demo   && echo build-and-install-ok

预期输出:

text
build-and-install-ok

对应的 service 单元如下。NotifyAccess=main 明确只接受主进程的通知,TimeoutStartSec=30s 则给初始化设置上限。

ini
[Unit]
Description=Notify readiness demo

[Service]
Type=notify
ExecStart=/usr/local/sbin/notify-demo
NotifyAccess=main
TimeoutStartSec=30s

这是完整的 service 配置示例。保存为 notify-demo.service 后安装并验证:

bash
sudo install -m 0644 notify-demo.service /etc/systemd/system/notify-demo.service
sudo systemctl daemon-reload
sudo systemctl start notify-demo.service
systemctl show notify-demo.service -p ActiveState -p SubState -p StatusText

预期输出:

text
ActiveState=active
SubState=running
StatusText=Ready to accept requests

systemctl start 会等到程序发送 READY=1 后才成功返回,因此这里的 active 表示服务已经越过了自己定义的就绪点,而不只是进程已经被 exec 出来。

READY=1 为什么会影响依赖启动

假设另一个单元配置了 After=notify-demo.service,它的启动顺序会等待 notify-demo.service 的启动任务完成。对于 Type=notify,这个完成点就是 systemd 收到 READY=1 的时刻。

因此,notify 特别适合初始化阶段较长、就绪条件明确的服务器。它可以避免下游服务过早连接,也比固定 sleep 更能适应机器性能、缓存冷热和恢复数据量的变化。

通知链路出问题时看三个位置

如果服务进程已经存在,但 systemctl start 一直不返回,首先确认程序是否真的执行到了 sd_notify(..., "READY=1")。如果没有,就继续排查初始化逻辑本身。

其次检查通知来源是否被允许。NotifyAccess=main 适合由主进程直接调用 sd_notify();如果设计成由其他进程发送通知,就需要重新评估通知来源和 NotifyAccess=,不要为了“先跑起来”而无条件放宽。

最后检查启动超时。服务始终不发送 READY=1 时,systemd 不会永久把它当作正在正常启动;达到 TimeoutStartSec= 后,启动会失败。这个行为能把“进程活着但永远没准备好”转换成可观察、可恢复的服务故障。

Type=notify 的价值不是增加一条状态日志,而是把真正可服务的时刻变成 systemd 能参与依赖排序、超时控制和故障处理的明确事件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

notify 怎样报告真正启动完成

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通