wx_service/docs/common/deploy_ci.md

生产部署（GitHub Actions，非 Docker）

本文档用于 wx_service 在宝塔服务器上的自动化发布：

• 触发：main 分支 push 或手动触发
• 流程：GitHub Actions SSH 触发服务器发布脚本 -> 服务器 git pull + go build -> 重启并健康检查
• 特点：不依赖 Docker

1. 服务器约定

• 代码目录：/www/wwwroot/wx_service
• 运行目录：/www/wwwroot/wx_service/dist
• 二进制：/www/wwwroot/wx_service/dist/wx_service
• 进程端口：8080
• 反向代理：宝塔 Nginx -> 127.0.0.1:8080

远程脚本：scripts/ops/deploy_from_source.sh（内部调用 scripts/ops/deploy_binary.sh）

2. GitHub Secrets

在仓库 Settings -> Secrets and variables -> Actions 新增：

• PROD_HOST：生产机 IP 或域名
• PROD_PORT：SSH 端口（默认 22）
• PROD_USER：SSH 用户（建议 root 或具备发布权限的用户）
• PROD_SSH_KEY：私钥内容（建议单独部署密钥）

3. 工作流文件

• /.github/workflows/deploy-prod.yml

已默认发布到：/www/wwwroot/wx_service/dist/wx_service。

4. 首次上线注意事项

1. 服务器必须已存在：/www/wwwroot/wx_service/.git（可正常 git fetch）
2. 服务器上配置好生产 .env（建议放两份）：
   • /www/wwwroot/wx_service/.env
   • /www/wwwroot/wx_service/dist/.env
3. 开放 8080 本地监听，并由 Nginx 反代
4. 服务器无需 Docker；第一次执行会自动安装 Go 1.23.6（若缺失）并尝试创建 systemd 服务 wx_service

5. 发布行为

每次发布会执行：

1. GitHub Actions 通过 SSH 调用服务器发布脚本
2. 服务器执行：
   • git fetch + git reset --hard <commit_sha>（同步代码）
   • 安装/校验 Go 1.23.6
   • go mod download + go build
3. 远程发布脚本继续执行：
   • 备份旧二进制到 /www/wwwroot/wx_service/backups/
   • 原子替换 dist/wx_service
   • 重启服务
   • 健康检查 http://127.0.0.1:8080/healthz
4. 若健康检查失败，自动回滚旧二进制并重启

6. 手动发布（应急）

在服务器执行（仅二进制手动发布场景）：

cd /www/wwwroot/wx_service
APP_DIR=/www/wwwroot/wx_service \
DIST_DIR=/www/wwwroot/wx_service/dist \
SOURCE_BIN=/tmp/wx_service-manual \
RELEASE_ID=manual-$(date +%Y%m%d%H%M%S) \
SERVICE_NAME=wx_service \
RUN_USER=www RUN_GROUP=www \
PORT=8080 \
SYNC_CODE=true DEPLOY_REF=main \
INSTALL_SERVICE=true \
bash scripts/ops/deploy_binary.sh

7. 回滚

ls -lt /www/wwwroot/wx_service/backups/
cp -f /www/wwwroot/wx_service/backups/wx_service.<backup_id>.bak /www/wwwroot/wx_service/dist/wx_service
chown www:www /www/wwwroot/wx_service/dist/wx_service
systemctl restart wx_service

若机器未使用 systemd，可改为：

pkill -f /www/wwwroot/wx_service/dist/wx_service
su -s /bin/bash - www -c "cd /www/wwwroot/wx_service/dist && nohup ./wx_service >> /www/wwwlogs/wx_service.stdout.log 2>&1 &"

8. 手动发布（从源码构建）

cd /www/wwwroot/wx_service
APP_DIR=/www/wwwroot/wx_service \
DIST_DIR=/www/wwwroot/wx_service/dist \
DEPLOY_REF=main \
RELEASE_ID=manual-$(date +%Y%m%d%H%M%S) \
GO_VERSION=1.23.6 \
SERVICE_NAME=wx_service \
RUN_USER=www RUN_GROUP=www \
PORT=8080 \
bash scripts/ops/deploy_from_source.sh