Deploy Server Skill

用于把 server 中的新版本更新到远程服务器。

环境

• 服务器 SSH 别名：golakers
• 构建产物：server/ptmate-server
• 测试环境目录：golakers:~/ptmate-beta
• 正式环境目录：golakers:~/ptmate
• 测试环境访问地址环境变量：PTMATE_BETA_URL
• 正式环境访问地址环境变量：PTMATE_PROD_URL

真实访问地址必须从本地环境变量读取，不要写入仓库文件，避免提交到 GitHub 后公开。

使用流程

1. 判断用户要更新的环境：
   • 用户提到“测试环境”、“beta”、“预发”时，按测试环境流程执行。
   • 用户提到“正式环境”、“生产环境”、“线上”时，按正式环境流程执行。
   • 如果用户没有说明环境，先询问目标环境。
2. 先打包 server：

cd server && ./build.sh

3. 确认 server/ptmate-server 已生成。

测试环境部署

按用户要求，测试环境不使用 systemctl，复制到 ~/ptmate-beta 后进入目录直接运行二进制。默认用 nohup 后台启动，并写入 PID 文件，确保部署命令能结束，且后续可以主动停止。

scp server/ptmate-server golakers:~/ptmate-beta/ptmate-server
ssh golakers 'cd ~/ptmate-beta && chmod +x ptmate-server && nohup ./ptmate-server > ptmate-server.log 2>&1 & echo $! > ptmate-server.pid'

如果用户明确要求前台运行，使用：

ssh golakers 'cd ~/ptmate-beta && chmod +x ptmate-server && ./ptmate-server'

停止测试环境

因为测试环境默认通过 nohup 后台运行，如果不主动停止会一直运行。停止测试环境时优先使用 PID 文件：

ssh golakers 'cd ~/ptmate-beta && if [ -f ptmate-server.pid ]; then kill "$(cat ptmate-server.pid)" && rm -f ptmate-server.pid; fi'

如果 PID 文件不存在或进程已经不是该 PID，使用工作目录筛选兜底，避免误杀正式环境：

ssh golakers 'cd ~/ptmate-beta && for pid in $(pgrep -f ptmate-server || true); do [ "$(readlink /proc/$pid/cwd 2>/dev/null)" = "$PWD" ] && kill "$pid"; done; rm -f ptmate-server.pid'

更新测试环境时，先停止旧进程，再复制和启动新版本：

ssh golakers 'cd ~/ptmate-beta && if [ -f ptmate-server.pid ]; then kill "$(cat ptmate-server.pid)" 2>/dev/null || true; rm -f ptmate-server.pid; fi; for pid in $(pgrep -f ptmate-server || true); do [ "$(readlink /proc/$pid/cwd 2>/dev/null)" = "$PWD" ] && kill "$pid"; done'
scp server/ptmate-server golakers:~/ptmate-beta/ptmate-server
ssh golakers 'cd ~/ptmate-beta && chmod +x ptmate-server && nohup ./ptmate-server > ptmate-server.log 2>&1 & echo $! > ptmate-server.pid'

完成后提示用户可以访问测试环境新版本：

echo "测试环境新版本已部署，可以访问：${PTMATE_BETA_URL}"

正式环境部署

正式环境必须先停止 ptmate 服务，再复制新产物，最后启动服务。

ssh golakers 'systemctl stop ptmate'
scp server/ptmate-server golakers:~/ptmate/ptmate-server
ssh golakers 'cd ~/ptmate && chmod +x ptmate-server && systemctl start ptmate'

完成后提示用户可以访问正式环境新版本：

echo "正式环境新版本已部署，可以访问：${PTMATE_PROD_URL}"

注意事项

• 访问地址只允许通过 PTMATE_BETA_URL 和 PTMATE_PROD_URL 获取；如果环境变量未设置，先提醒用户设置，不要猜测或补写真实地址。
• 不要在正式环境复制完成前启动服务。
• 如果 systemctl 权限不足，按终端报错处理；需要 sudo 时先说明将要执行的命令。
• 如果 scp 或 ssh 失败，保留错误输出并告知用户部署未完成，不要提示“可以访问新版本”。