Jenkins Agent以systemd服务启动时returnStdout失效问题排查

核心原因 #

当systemd启动Jenkins Agent时，服务运行的**上下文环境（用户身份、环境变量集合）**与手动启动时存在差异，导致hostname命令的输出无法被Jenkins流水线正确捕获。

具体解决步骤 #

1. 让systemd服务以指定用户运行 #

默认情况下systemd服务以root用户运行，即便你手动用sudo启动脚本，脚本内部可能隐含切换到qatest用户运行Jenkins Agent（比如脚本包含su qatest或sudo -u qatest逻辑），但systemd直接以root运行时，Agent的执行上下文会缺失部分用户级环境变量。

修改systemd单元文件的[Service]段，添加用户和组配置：

[Service]
WorkingDirectory=/home/qatest/jenkins
User=qatest
Group=qatest
Type=simple
ExecStart=/bin/bash /home/qatest/jenkins/jenkinsAgent.sh
StandardOutput=journal+console

2. 命令使用绝对路径并清理输出 #

systemd服务的默认PATH环境变量比交互式shell更严格，直接使用命令绝对路径可避免路径解析问题；同时添加.trim()去除输出末尾换行符，避免后续处理出现空值假象：

hostName = sh(script: "/bin/hostname", returnStdout: true).trim()

3. 补充必要环境变量 #

如果上述方法无效，可在systemd单元文件中显式设置关键环境变量，确保Agent运行环境与手动启动一致：

[Service]
# 保留原有配置，新增以下内容
Environment="HOME=/home/qatest"
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/home/qatest/.local/bin"

4. 查看服务日志排查细节 #

使用以下命令实时查看systemd服务日志，确认是否存在hostname命令执行失败的报错：

journalctl -u jenkinsAgent.service -f

验证操作 #

修改完systemd单元文件后，执行以下命令重新加载配置并重启服务：

sudo systemctl daemon-reload
sudo systemctl restart jenkinsAgent.service

之后重新触发流水线，检查hostName变量是否能正常获取值。

内容的提问来源于stack exchange，提问作者Vineet Bhat