36 lines
1.7 KiB
Markdown
36 lines
1.7 KiB
Markdown
# Phase 7：云端 CI/CD + 线上回调稳定 + 最小闭环验收
|
||
|
||
## CI/CD（GitHub Actions）
|
||
|
||
- **位置**：`.github/workflows/build-deploy.yml`（副本说明见 `deploy/ci/`）
|
||
- **触发**：推送到 `main` 分支
|
||
- **流程**：
|
||
1. **test-backend**：启动 PostgreSQL 16，执行迁移，运行 `pytest tests/`
|
||
2. **build-backend**：构建 backend 镜像并推送到 GitHub Container Registry（`ghcr.io/<owner>/wecom-ai-backend:latest`）
|
||
3. **build-admin**：构建 admin 镜像并推送（`ghcr.io/<owner>/wecom-ai-admin:latest`）
|
||
|
||
## 云端部署（方案 A）
|
||
|
||
1. 服务器安装 Docker + docker-compose。
|
||
2. 从 GHCR 拉取镜像（或从仓库 build）：
|
||
- 使用 `docker-compose.yml` 时，可改为使用 `image: ghcr.io/<owner>/wecom-ai-backend:latest` 等，不再本地 build。
|
||
3. 配置 `.env`（含 `WECOM_*`、`DATABASE_URL`、`JWT_SECRET` 等）。
|
||
4. 执行：`docker-compose up -d`。
|
||
5. 配置 Nginx 反代或直接暴露端口；HTTPS 证书后补。
|
||
|
||
## 无 GitHub 时（GitLab CI 替代）
|
||
|
||
在仓库根目录创建 `.gitlab-ci.yml`，阶段与上述对应：
|
||
`test`（postgres service + migrate + pytest）、`build`（docker build + push 到 GitLab Registry）。变量使用 `CI_REGISTRY`、`CI_REGISTRY_USER`、`CI_REGISTRY_PASSWORD`。
|
||
|
||
## 最小闭环验收脚本
|
||
|
||
- **路径**：`deploy/scripts/acceptance.sh`
|
||
- **用法**：`BASE_URL=http://localhost ./acceptance.sh` 或 `BASE_URL=https://你的域名 ./acceptance.sh`
|
||
- **步骤**：
|
||
1. `GET /api/health` 期望 200
|
||
2. `POST /api/auth/login`（admin/admin）期望 `code: 0`
|
||
3. `GET /api/wecom/callback?...` 期望 200 或 400（验签失败为 400）
|
||
|
||
全部通过即打印 "All checks passed"。
|