CI/CD / 系统课时
使用 systemd 管理服务
使用 systemd 管理服务
把应用交给 systemd 后,部署脚本只需要面对统一的启动、停止、重启和状态接口。本课会把 Java 应用注册为受控服务,并配置独立运行用户、环境文件与失败自动恢复,让 CI/CD 不再依赖后台 shell 进程。
学习目标
- 编写可由 systemd 管理的应用 unit,并理解关键字段的职责
- 使用
systemctl完成启停、重启、开机自启与状态验证 - 配置最小权限运行用户、环境变量和失败恢复策略
准备运行目录与配置
示例约定应用制品位于 /opt/myapp/current/app.jar,运行用户为 deploy,环境变量文件为 /etc/myapp/myapp.env。正式部署前先确认用户、制品、环境文件和 Java 都存在,避免 unit 写完后才在启动阶段发现基础条件缺失。
# 部署前把缺失依赖直接变成非零退出码。
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预期输出:
READY环境文件只保存应用真正需要的运行参数,不要把密钥直接写进 unit。文件权限应限制为运行用户或专门的部署组可读。
# 应用启动后从进程环境读取这些值。
APP_ENV=production
SERVER_PORT=8080这个文件是配置片段,应用需要自行读取 APP_ENV 和 SERVER_PORT。修改后应通过重启服务让新进程重新加载环境。
编写 systemd unit
在项目仓库保存 myapp.service,再由部署脚本安装到 /etc/systemd/system/myapp.service。User 和 Group 决定进程权限,WorkingDirectory 固定工作目录,EnvironmentFile 注入环境变量,ExecStart 必须以前台方式启动主进程。
[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.targetRestart=on-failure 会在异常退出后重启服务,但主动执行 systemctl stop 不会触发重启。StartLimitIntervalSec 与 StartLimitBurst 用来限制短时间内的重复失败,避免错误配置导致无限重启风暴。

安装并启动服务
修改 unit 后必须执行 daemon-reload,否则 systemd 仍使用旧配置。首次部署可同时启用开机自启并立即启动服务;最后用机器可判定的状态命令验证,而不是只看部署命令有没有报错。
# 先验证 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预期输出:
enabled
activesystemd-analyze verify 在配置合法时通常不输出内容;上面的两行结果来自最后两个状态命令。如果 unit 引用的用户、文件或路径不存在,校验或启动阶段会给出错误,应先修正依赖再继续部署。
重启并观察恢复状态
发布新制品后使用 restart 让 systemd 先停止旧进程再启动新进程。验证时同时检查服务状态、子状态和累计重启次数,能区分“当前活着”和“刚刚经历过异常重启”这两种情况。
# 发布新制品后重启,再分别读取稳定的状态值。
sudo systemctl restart myapp.service
systemctl is-active myapp.service
systemctl show myapp.service -p SubState --value
systemctl show myapp.service -p NRestarts --value预期输出:
active
running
<VALUE><VALUE> 是 NRestarts 的运行期动态值,稳定服务通常为较小整数。若服务因连续失败进入 failed,先修复制品、环境或权限问题,再执行 sudo systemctl reset-failed myapp.service 与 sudo systemctl start myapp.service;不要用反复重启掩盖真正的启动错误。