root
75 lines
2.1 KiB
Markdown
75 lines
2.1 KiB
Markdown
# 生产部署（GitHub Actions，前端静态站点）
|
||
|
||
本文档用于 `admin-frontend` 的自动化构建发布：
|
||
- 触发：`main` 分支 push 或手动触发
|
||
- 流程：GitHub Actions 构建 `dist` -> 通过 SSH 上传到服务器 -> 远程脚本覆盖发布
|
||
- 特点：参考 `wx_service` 部署流程，全部参数由 GitHub Secrets 驱动
|
||
|
||
## 0. 与 wx_service 对齐
|
||
|
||
- 使用同一台服务器：`115.159.198.14`
|
||
- SSH 用户：`root`
|
||
- 可复用 `wx_service` 的 SSH 密钥体系
|
||
- 不使用脚本内默认服务器参数，统一由仓库 Secrets 注入
|
||
|
||
## 1. Nginx 路径约定（当前配置）
|
||
|
||
```nginx
|
||
location ^~ /panel/ {
|
||
root /www/wwwroot/wx_service/web/admin-frontend;
|
||
index index.html;
|
||
try_files $uri $uri/ /panel/index.html;
|
||
}
|
||
```
|
||
|
||
对应发布目录：
|
||
- `/www/wwwroot/wx_service/web/admin-frontend/panel`
|
||
|
||
## 2. 必填 GitHub Secrets
|
||
|
||
在 `admin-frontend` 仓库 `Settings -> Secrets and variables -> Actions` 配置：
|
||
|
||
- `PROD_SSH_KEY`：私钥内容（`~/.ssh/id_ed25519`）
|
||
- `PROD_HOST`：`115.159.198.14`
|
||
- `PROD_PORT`：`22`
|
||
- `PROD_USER`：`root`
|
||
- `ADMIN_WEB_ROOT`：`/www/wwwroot/wx_service/web/admin-frontend/panel`
|
||
- `ADMIN_WEB_USER`：`www`
|
||
- `ADMIN_WEB_GROUP`：`www`
|
||
- `ADMIN_KEEP_BACKUPS`：`5`
|
||
|
||
可选：
|
||
- `ADMIN_HEALTHCHECK_URL`：例如 `http://115.159.198.14/panel/`
|
||
|
||
## 3. 密钥说明
|
||
|
||
`~/.ssh/id_ed25519.pub` 是公钥，用于写入服务器 `~/.ssh/authorized_keys`。
|
||
|
||
GitHub Actions 里的 `PROD_SSH_KEY` 必须填写私钥：
|
||
- `~/.ssh/id_ed25519`
|
||
|
||
## 4. 工作流文件
|
||
|
||
- `/.github/workflows/deploy-prod.yml`
|
||
|
||
每次主分支变更会自动：
|
||
1. `npm ci`
|
||
2. `npm run build`（生产基路径 `/panel/`）
|
||
3. 上传构建包到服务器 `/tmp`
|
||
4. 调用 `scripts/ops/deploy_static.sh` 覆盖发布
|
||
|
||
## 5. 回滚
|
||
|
||
在服务器执行：
|
||
|
||
```bash
|
||
ls -lt /www/wwwroot/wx_service/web/admin-frontend/backups/admin-frontend.*.tar.gz
|
||
|
||
TARGET_DIR=/www/wwwroot/wx_service/web/admin-frontend/panel
|
||
BACKUP_FILE=/www/wwwroot/wx_service/web/admin-frontend/backups/admin-frontend.<backup_id>.tar.gz
|
||
|
||
find "$TARGET_DIR" -mindepth 1 -maxdepth 1 -exec rm -rf {} +
|
||
tar -xzf "$BACKUP_FILE" -C "$TARGET_DIR"
|
||
chown -R www:www "$TARGET_DIR"
|
||
```
|