最近在开发此方 BOT 的时候,越来越讨厌在单容器里同时拉起浏览器池、主程序等一大坨各种各样的东西,所以在思考能不能把此方 BOT 重新放到裸金属运行,用 systemd 管理它的死活。
Systemd 虽然一直都被诟病「小而美」[1],但是最近看了一个 systemd 教程[2],发现它其实还是挺好用的。
因此在这里简要讲解一下 Systemd 的 Unit 生命周期,并讲解如何使用 libsystemd 告诉 systemd 应用的状态。
Systemd 简概
Systemd 是目前主流 Linux 发行版中常用的 init 进程[3],也就是内核创建的第一个用户进程,它的 PID=1,并且负责拉起一大堆服务并且管理它们的启动顺序。很多时候的服务器运维,都通过它来指定各种开机自启动的应用。
Systemd 中,每一个基本结构,包括服务在内,都被称作一个 unit。每个 unit 之间可以规定它们的依赖、启动顺序之类的限制关系。
例如,我有一个需要让 Root 启动的开机自启动脚本,我写了这个:
[Unit]Description=SSH 端口转发服务# 这是我一直在用的一个服务,用来端口转发我的一个本地音乐服务,让我# 可以在我的手机随时随机收听我电脑上的音乐。After=network.target
[Service]ExecStart=/usr/bin/ssh -N -T -R xxxxx:localhost:xxxxx xxxxxx -o ExitOnForwardFailure=yesRestart=alwaysRestartSec=5StartLimitIntervalSec=60sStartLimitBurst=10
[Install]WantedBy=multi-user.target这里就声明了依赖关系:这个服务,在 multi-user.target 启动的时候被启动,但是要等 network.target 启动成功。这样就可以保证开机以后,等网络栈初始化后,开始试着启动。
Systemd 状态机
怎么知道「启动成功」和「开始被启动」的区别呢?每一个 unit 都有一个状态机:
当状态从 inactive 到 activating,则代表开始启动;从 activating 到 active,则是启动了。
常见的 Systemd 服务类型
一般写 Systemd 服务的时候,会有这几种类型:
simple: 默认的类型。只要进程fork了就进active状态(甚至不考虑能不能执行!!)exec: 只要进程开始执行了就进active状态oneshot[4]: 只要ExecStart进程结束就进active状态(通常配合RemainAfterExit=true)
这些类型很好,而且非常实用。不过,如果一个进程复杂一些(例如等到一个什么状态了才算启动完成,别的服务才能开始依赖它),这些基础类型就束手无策。Systemd 提供了若干方法可以让我们自定义获取服务状态的方法,包括 dbus 和 notify。这里较为简单的就是 notify。
Type=notify
在这个模式下,Systemd 会提供一个 socket。我们可以使用 libsystemd 中的 sd_notify 函数来向 systemd 报告自己的状态。
这里我们做个小实验:
#include <systemd/sd-daemon.h>#include <stdio.h>#include <stdlib.h>#include <unistd.h>
// 赫赫这个是用来输出用的!#define LOG(fmt, ...) fprintf(stderr, fmt "\n", ##__VA_ARGS__)
const char *env(const char *n) { const char *e = getenv(n); return e ? e : "未设置";}
int main() { LOG("main() NOTIFY_SOCKET=%s", env("NOTIFY_SOCKET"));
sleep(2);
LOG("发送 READY=1"); sd_notify(0, "READY=1");
sleep(2);
LOG("send STOPPING=1"); sd_notify(0, "STOPPING=1");
sleep(2);
LOG("main() exited");
return 0;}[Service]Type=notifyExecStart=/app/main写个测试脚本来每秒检测一次它的状态:
#!/usr/bin/env bash
for i in 1 2 3 4 5 6 7 8; do systemctl status wtf.service 2>&1 \ | grep "Active:" \ | sed -r 's/^.+(Active: \S+) .+$/\1/g' sleep 1done
journalctl --unit wtf --unit test \ | tail -n +2 \ | sed -r 's/ [0-9a-f]{12}//' > /data/result
systemctl --no-block exit 0[Unit]After=multi-user.target
Wants=wtf.service
[Service]Type=oneshotExecStart=/app/test_script.sh
[Install]WantedBy=multi-user.target在容器里跑它们吧:
FROM ubuntu:20.04 AS builder
WORKDIR /appRUN apt-get update && \ apt-get install --assume-yes gcc libsystemd-devCOPY main.c /app/RUN gcc -o main main.c -lsystemd
FROM ubuntu:20.04 AS runner
WORKDIR /appRUN apt-get update && \ apt-get install --assume-yes systemd
COPY --from=builder /app/main /app/COPY ./test_script.sh /app/COPY ./services/* /etc/systemd/system/
RUN ln -s /etc/systemd/system/test.service \ /etc/systemd/system/multi-user.target.wants/test.service
CMD ["/lib/systemd/systemd"]结果是这样的:
Nov 15 16:45:10 systemd[1]: Starting wtf.service...Nov 15 16:45:10 main[39]: main() NOTIFY_SOCKET=/run/systemd/notifyNov 15 16:45:10 systemd[1]: Starting test.service...Nov 15 16:45:10 test_script.sh[54]: Active: activatingNov 15 16:45:11 test_script.sh[58]: Active: activatingNov 15 16:45:12 main[39]: 发送 READY=1Nov 15 16:45:12 systemd[1]: Started wtf.service.Nov 15 16:45:12 test_script.sh[62]: Active: activeNov 15 16:45:13 test_script.sh[66]: Active: activeNov 15 16:45:14 main[39]: send STOPPING=1Nov 15 16:45:14 test_script.sh[70]: Active: deactivatingNov 15 16:45:15 test_script.sh[74]: Active: deactivatingNov 15 16:45:16 main[39]: main() exitedNov 15 16:45:16 systemd[1]: wtf.service: Succeeded.Nov 15 16:45:16 test_script.sh[78]: Active: inactiveNov 15 16:45:17 test_script.sh[82]: Active: inactiveBonus: 让 Systemd 控制我们应用安全关闭
那么,怎么在 systemctl stop my-service.service 的时候安全关闭应用呢?这个不需要库就可以做了:默认情况下,我们的应用捕获 SIGTERM 就行。默认情况下,我们的应用会直接被关闭,来不及反应。如果捕获 SIGTERM 信号,就可以安全退出:
#include <signal.h>#include <systemd/sd-daemon.h>#include <stdio.h>#include <stdlib.h>#include <unistd.h>
#define LOG(fmt, ...) fprintf(stderr, fmt "\n", ##__VA_ARGS__)
const char *env(const char *n) { const char *e = getenv(n); return e ? e : "未设置";}
void handle_signal(int _) { LOG("哦不程序被关了,收拾下走人吧"); sleep(2); LOG("已收拾。"); exit(0);}
int main() { signal(SIGTERM, handle_signal);
LOG("main() NOTIFY_SOCKET=%s", env("NOTIFY_SOCKET"));
sleep(2);
LOG("发送 READY=1"); sd_notify(0, "READY=1");
sleep(2);
LOG("send STOPPING=1"); sd_notify(0, "STOPPING=1");
sleep(2);
LOG("main() exited");
return 0;}引入一个新的脚本来中途关闭它:
#!/usr/bin/env bash
sleep 3.11415926echo "斩!"systemctl stop wtf.service结果:
Nov 15 17:24:53 systemd[1]: Starting daemon.service...Nov 15 17:24:53 systemd[1]: Starting wtf.service...Nov 15 17:24:53 main[40]: main() NOTIFY_SOCKET=/run/systemd/notifyNov 15 17:24:54 systemd[1]: Starting test.service...Nov 15 17:24:54 test_script.sh[56]: Active: activatingNov 15 17:24:55 test_script.sh[60]: Active: activatingNov 15 17:24:55 main[40]: 发送 READY=1Nov 15 17:24:55 systemd[1]: Started wtf.service.Nov 15 17:24:56 test_script.sh[64]: Active: active
Nov 15 17:24:57 daemon_script.sh[35]: 斩!Nov 15 17:24:57 main[40]: 哦不程序被关了,收拾下走人吧Nov 15 17:24:57 systemd[1]: Stopping wtf.service...Nov 15 17:24:57 test_script.sh[69]: Active: deactivatingNov 15 17:24:58 test_script.sh[73]: Active: deactivatingNov 15 17:24:59 main[40]: 已收拾。Nov 15 17:24:59 systemd[1]: wtf.service: Succeeded.Nov 15 17:24:59 systemd[1]: Stopped wtf.service.Nov 15 17:24:59 systemd[1]: daemon.service: Succeeded.Nov 15 17:24:59 systemd[1]: Finished daemon.service.Nov 15 17:24:59 test_script.sh[77]: Active: inactiveNov 15 17:25:00 test_script.sh[81]: Active: inactiveNov 15 17:25:01 test_script.sh[85]: Active: inactive默认的超时时间 TimeoutStopSec=90s。
