Linux 与服务器运维 / 系统课时
用 Environment 设置服务变量
用 Environment 设置服务变量
端口、运行环境名称、功能开关这类少量非敏感配置,可以直接写进 systemd unit 的 Environment=。本篇通过一个可执行示例完成变量注入、重载与验证,并说明引号、重启生效和敏感信息这几个最容易踩坑的边界。
学习目标
- 使用
Environment=为服务设置简单环境变量 - 让应用在启动时读取变量并通过日志验证
- 避免把 Shell 展开规则和敏感凭据错误地塞进 unit
在 unit 中声明变量
Environment= 写在 [Service] 段中。一个指令可以包含多个赋值,也可以写多行;对于包含空格的值,使用 systemd 支持的引号语法把整个 KEY=value 项包起来更清楚。
下面先准备一个读取变量的最小脚本:
bash
sudo tee /usr/local/bin/app-env-demo.sh >/dev/null <<'EOF'
#!/bin/sh
printf 'APP_ENV=%s\n' "${APP_ENV:-<unset>}"
printf 'PORT=%s\n' "${PORT:-<unset>}"
printf 'GREETING=%s\n' "${GREETING:-<unset>}"
EOF
sudo chmod +x /usr/local/bin/app-env-demo.sh预期结果
text
脚本创建成功并具有可执行权限;此步骤本身通常没有终端输出。创建对应服务:
bash
sudo tee /etc/systemd/system/app-env-demo.service >/dev/null <<'EOF'
[Unit]
Description=Environment directive demo
[Service]
Type=oneshot
Environment="APP_ENV=production"
Environment="PORT=8080"
Environment="GREETING=hello systemd"
ExecStart=/usr/local/bin/app-env-demo.sh
EOF
sudo systemctl daemon-reload
sudo systemctl start app-env-demo.service
sudo journalctl -u app-env-demo.service -o cat --no-pager | tail -n 3预期输出
text
APP_ENV=production
PORT=8080
GREETING=hello systemd三个变量值应与 unit 中的声明一致。
修改后要重载并重新启动
修改 unit 文件后,先执行 systemctl daemon-reload 让 systemd 重新读取单元定义,再重启服务进程。仅修改文件不会改变已经运行进程的环境。
bash
sudo sed -i 's/PORT=8080/PORT=9090/' /etc/systemd/system/app-env-demo.service
sudo systemctl daemon-reload
sudo systemctl restart app-env-demo.service
sudo journalctl -u app-env-demo.service -o cat --no-pager | tail -n 3预期输出
text
APP_ENV=production
PORT=9090
GREETING=hello systemd对长期运行的服务也是同一个原则:环境变量在进程创建时确定,修改 unit 后必须让旧进程退出并创建新进程,应用才能读取新值。
注意 systemd 不是 Shell
Environment= 接收的是环境变量赋值,不会按你在 Bash 中的习惯执行命令替换、管道或 export。例如,把 $(hostname) 写进去不会先运行 hostname 再把结果注入应用。
同样不要用另一个变量的 $NAME 写法期待 Shell 式展开。需要组合配置时,更可靠的方式是在应用内组合,或提前生成明确的最终值。
验证 systemd 实际保存的环境
除了观察应用日志,还可以直接查看服务属性:
bash
systemctl show app-env-demo.service -p Environment预期输出
text
Environment=APP_ENV=production PORT=9090 "GREETING=hello systemd"不同版本对带空格值的显示引号可能略有差异,但变量名和值应一致。对于少量、稳定、非敏感的启动参数,Environment= 简单直接;当变量很多、需要独立部署配置或由自动化系统维护时,再把它们迁移到 EnvironmentFile= 会更容易管理。
按自己的节奏,确认真正理解。