From 8692dbad857b90f01a75b461fe6e278940dad4ef Mon Sep 17 00:00:00 2001 From: kdletters Date: Mon, 4 May 2026 14:33:40 +0800 Subject: [PATCH] Align build agent remoting workdir docs --- docs/technical/PRODUCTION_DEPLOYMENT_PLAN_2026-05-02.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/technical/PRODUCTION_DEPLOYMENT_PLAN_2026-05-02.md b/docs/technical/PRODUCTION_DEPLOYMENT_PLAN_2026-05-02.md index 62737677..a530af70 100644 --- a/docs/technical/PRODUCTION_DEPLOYMENT_PLAN_2026-05-02.md +++ b/docs/technical/PRODUCTION_DEPLOYMENT_PLAN_2026-05-02.md @@ -215,7 +215,7 @@ Jenkins 可运行在 Windows 或其他机器上，本机 Windows 只作为人工 - Jenkins 节点 Launch method 使用 inbound agent，优先启用 WebSocket。这样目标机只需要能访问 Jenkins Web 地址，不依赖 controller 每次 SSH 拉起 agent。 - 目标机安装 `deploy/systemd/jenkins-agent@.service`、`scripts/deploy/jenkins-inbound-agent-start.sh` 与 `scripts/deploy/install-jenkins-inbound-agent.sh`。 - systemd 服务名采用 `jenkins-agent@.service`，例如 `jenkins-agent@genarrative-build-01.service`、`jenkins-agent@genarrative-release-deploy-01.service`。 -- systemd 自身 `WorkingDirectory` 保持 `/var/lib/jenkins/agent/`；Jenkins remoting `-workDir` 可继续使用旧 SSH agent 的 `/root/jenkins-agent`，避免迁移时 workspace 和缓存路径漂移。 +- systemd 自身 `WorkingDirectory` 保持 `/var/lib/jenkins/agent/`；Jenkins remoting `-workDir` 可按节点拆分，例如构建机使用 `/root/jenkins-agent-build`、发布机继续使用旧 SSH agent 的 `/root/jenkins-agent`，避免多 agent 共用 remoting 根目录，同时减少发布机迁移时 workspace 和缓存路径漂移。 - inbound secret 只能放在目标机 `/etc/jenkins-agent/.secret` 或等价 Secret Text 注入位置，不能提交到 Git，也不能写入 Jenkinsfile 默认参数。 - systemd unit 使用 `Restart=always` 和 `RestartSec=10`；agent Java 进程退出、网络短断或机器重启后由 systemd 自动恢复，不需要人工盯着 Jenkins 页面手动重启。 - 当前 `Genarrative-Server-Provision` 仍负责 systemd、Nginx、`/opt/genarrative`、`/etc/genarrative` 等特权写入，因此 inbound agent 默认仍按现有 root 执行口径迁移。若后续改为 `jenkins` 用户运行 agent，必须先把生产流水线需要的特权命令收敛为精确 `NOPASSWD` sudoers 白名单。 @@ -234,7 +234,7 @@ sudo scripts/deploy/install-jenkins-inbound-agent.sh \ --agent-name genarrative-build-01 \ --jenkins-url http://127.0.0.1:18080/ \ --secret-file /etc/jenkins-agent/genarrative-build-01.secret \ - --workdir /root/jenkins-agent \ + --workdir /root/jenkins-agent-build \ --java-bin /usr/bin/java sudo systemctl status jenkins-agent@genarrative-build-01.service --no-pager -l