CI/CD / 系统课时

使用 systemd 管理服务

使用 systemd 管理服务

把应用交给 systemd 后,部署脚本只需要面对统一的启动、停止、重启和状态接口。本课会把 Java 应用注册为受控服务,并配置独立运行用户、环境文件与失败自动恢复,让 CI/CD 不再依赖后台 shell 进程。

学习目标

  • 编写可由 systemd 管理的应用 unit,并理解关键字段的职责
  • 使用 systemctl 完成启停、重启、开机自启与状态验证
  • 配置最小权限运行用户、环境变量和失败恢复策略

准备运行目录与配置

示例约定应用制品位于 /opt/myapp/current/app.jar,运行用户为 deploy,环境变量文件为 /etc/myapp/myapp.env。正式部署前先确认用户、制品、环境文件和 Java 都存在,避免 unit 写完后才在启动阶段发现基础条件缺失。

bash
# 部署前把缺失依赖直接变成非零退出码。
id deploy >/dev/null
getent group deploy >/dev/null
sudo -u deploy test -r /opt/myapp/current/app.jar
sudo -u deploy test -r /etc/myapp/myapp.env
sudo -u deploy test -x /usr/bin/java
echo READY

预期输出:

text
READY

环境文件只保存应用真正需要的运行参数,不要把密钥直接写进 unit。文件权限应限制为运行用户或专门的部署组可读。

bash
# 应用启动后从进程环境读取这些值。
APP_ENV=production
SERVER_PORT=8080

这个文件是配置片段,应用需要自行读取 APP_ENV 和 SERVER_PORT。修改后应通过重启服务让新进程重新加载环境。

编写 systemd unit

在项目仓库保存 myapp.service,再由部署脚本安装到 /etc/systemd/system/myapp.service。User 和 Group 决定进程权限,WorkingDirectory 固定工作目录,EnvironmentFile 注入环境变量,ExecStart 必须以前台方式启动主进程。

ini
[Unit]
Description=MyApp API
Wants=network-online.target
After=network-online.target
# 限制一分钟内的连续启动失败,避免重启风暴。
StartLimitIntervalSec=60
StartLimitBurst=3

[Service]
Type=simple
# 使用非 root 账号运行,并让 systemd 直接跟踪前台主进程。
User=deploy
Group=deploy
WorkingDirectory=/opt/myapp/current
EnvironmentFile=/etc/myapp/myapp.env
ExecStart=/usr/bin/java -jar /opt/myapp/current/app.jar
Restart=on-failure
RestartSec=5
TimeoutStopSec=30

[Install]
WantedBy=multi-user.target

Restart=on-failure 会在异常退出后重启服务,但主动执行 systemctl stop 不会触发重启。StartLimitIntervalSec 与 StartLimitBurst 用来限制短时间内的重复失败,避免错误配置导致无限重启风暴。

systemd 管理应用进程与失败恢复关系

安装并启动服务

修改 unit 后必须执行 daemon-reload,否则 systemd 仍使用旧配置。首次部署可同时启用开机自启并立即启动服务;最后用机器可判定的状态命令验证,而不是只看部署命令有没有报错。

bash
# 先验证 unit,再让 systemd 重新加载并启动。
sudo install -o root -g root -m 0644 myapp.service /etc/systemd/system/myapp.service
sudo systemd-analyze verify /etc/systemd/system/myapp.service
sudo systemctl daemon-reload
sudo systemctl enable --now --quiet myapp.service
systemctl is-enabled myapp.service
systemctl is-active myapp.service

预期输出:

text
enabled
active

systemd-analyze verify 在配置合法时通常不输出内容;上面的两行结果来自最后两个状态命令。如果 unit 引用的用户、文件或路径不存在,校验或启动阶段会给出错误,应先修正依赖再继续部署。

重启并观察恢复状态

发布新制品后使用 restart 让 systemd 先停止旧进程再启动新进程。验证时同时检查服务状态、子状态和累计重启次数,能区分“当前活着”和“刚刚经历过异常重启”这两种情况。

bash
# 发布新制品后重启,再分别读取稳定的状态值。
sudo systemctl restart myapp.service
systemctl is-active myapp.service
systemctl show myapp.service -p SubState --value
systemctl show myapp.service -p NRestarts --value

预期输出:

text
active
running
<VALUE>

<VALUE> 是 NRestarts 的运行期动态值,稳定服务通常为较小整数。若服务因连续失败进入 failed,先修复制品、环境或权限问题,再执行 sudo systemctl reset-failed myapp.service 与 sudo systemctl start myapp.service;不要用反复重启掩盖真正的启动错误。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 systemd 管理服务

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

登录哪都通