Files

T

cyuqei 175c0a69af feat: align deployment and approval workflow

2026-06-18 03:37:03 +08:00

6.3 KiB

Raw Blame History

AI 合同平台生产拆分部署指南

目标：按 hyburk.com 当前生产方式部署 AI 合同平台。公网入口在阿里云 47.94.178.212，业务后端和数据服务在 192.168.3.90。

回收、恢复、3.90 基础环境参考：D:\hyburk.com\backup\docs\3.90生产环境部署教程.md 与 D:\hyburk.com\backup\docs\3.90快速部署命令清单.md。

1. 拓扑

组件	地址	说明
用户访问入口	`https://contact.yuqei.com`	阿里云 Nginx，站点域名
阿里云公网主机	`47.94.178.212`	运行 Nginx + Next.js 前端 Docker 容器
前端容器	`127.0.0.1:3003 -> 3000`	`docker-compose.frontend.aliyun.yml`
公网 API	`https://contact.yuqei.com/api/v1`	Nginx 代理到 3.90 后端
3.90 后端	`http://192.168.3.90:8001`	FastAPI Docker 后端
阿里云到后端隧道	`http://10.20.0.11:8001`	WireGuard 内网地址，沿用 hyburk 代理方式
PostgreSQL	`192.168.3.90:5432`	数据库 `ai_contract_platform`
Redis	Docker service `redis:6379`	后端 Compose 内部访问
MinIO	`192.168.3.90:9000`	Bucket: `contracts`
Shared AI Platform	`http://192.168.3.90:18011`	后端调用

2. 首次部署前检查

2.1 192.168.3.90

按 hyburk 文档完成：

Docker、PostgreSQL 16、Redis/MinIO 基础服务。
WireGuard 客户端，确保阿里云可以访问 10.20.0.11。
数据库：

su - postgres -c "createdb ai_contract_platform"
PGPASSWORD=<password> pg_restore -U <user> -h localhost -d ai_contract_platform -c /tmp/db_backup/ai_contract_platform.dump

mkdir -p /opt/ai-contract-platform
cd /opt/ai-contract-platform
# 放置 docker-compose.server.yml、backend/、.env

.env 以 infra/env/backend.3.90.env.example 为模板，必须替换：
- SECRET_KEY
- DATABASE_URL
- MINIO_ACCESS_KEY / MINIO_SECRET_KEY
- SHARED_AI_PLATFORM_API_KEY

2.2 阿里云 47.94.178.212

Docker、Nginx、WireGuard 已安装并运行。
DNS：contact.yuqei.com 指向 47.94.178.212。
WireGuard 连通性：

curl http://10.20.0.11:8001/health
curl http://10.20.0.11:8001/api/v1/system/readiness

mkdir -p /opt/ai-contract-platform-frontend

Nginx 配置使用 infra/nginx/contact.yuqei.com.conf。如果已配置 HTTPS 证书，将该 server 块合并到 TLS 配置或由 certbot/现有证书工具扩展 443 server。

3. 发布命令

3.1 后端发布到 192.168.3.90

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\deploy-backend-docker.ps1 `
  -ServerHost 192.168.3.90 `
  -RemoteProjectPath /opt/ai-contract-platform `
  -ComposeFile docker-compose.server.yml `
  -FrontendBaseUrl https://contact.yuqei.com `
  -BackendBaseUrl http://192.168.3.90:8001 `
  -ApiUrl https://contact.yuqei.com/api/v1 `
  -ReadinessUrl https://contact.yuqei.com/api/v1/system/readiness

后端 Compose 默认只要求 3.90 运行 backend、legal-change-impact-worker、redis。前端服务保留在 single-host profile 中，不作为拆分生产路径必需项。

3.2 前端发布到阿里云

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\deploy-frontend-aliyun-docker.ps1 `
  -ServerHost 47.94.178.212 `
  -RemoteProjectPath /opt/ai-contract-platform-frontend `
  -BackendTunnelBaseUrl http://10.20.0.11:8001 `
  -FrontendBaseUrl https://contact.yuqei.com `
  -BackendBaseUrl http://192.168.3.90:8001 `
  -ApiUrl https://contact.yuqei.com/api/v1 `
  -ReadinessUrl https://contact.yuqei.com/api/v1/system/readiness

脚本会：

打包 frontend/、docker-compose.frontend.aliyun.yml、infra/nginx/contact.yuqei.com.conf。
上传到阿里云。
备份当前远程前端和 Nginx 配置到 /opt/ai-contract-platform-frontend/backups/frontend-aliyun-deploy/。
用 BACKEND_BASE_URL=http://10.20.0.11:8001 构建并重启前端容器。
安装 Nginx 配置、执行 nginx -t、重载 Nginx。
运行发布门禁（除非传 -SkipReleaseGate）。

4. 验证

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\run-production-release-gate.ps1 `
  -ServerHost 192.168.3.90 `
  -FrontendBaseUrl https://contact.yuqei.com `
  -BackendBaseUrl http://192.168.3.90:8001 `
  -ApiUrl https://contact.yuqei.com/api/v1 `
  -HealthUrl http://192.168.3.90:8001/health `
  -ReadinessUrl https://contact.yuqei.com/api/v1/system/readiness `
  -ExpectedRemoteServices backend,legal-change-impact-worker,redis

手工 smoke：

curl https://contact.yuqei.com/
curl https://contact.yuqei.com/api/v1/system/readiness
curl http://192.168.3.90:8001/health

5. 回滚

5.1 列出阿里云前端备份

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\rollback-frontend-aliyun-docker.ps1 -ListBackups

5.2 前端回滚预演

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\rollback-frontend-aliyun-docker.ps1 -DryRun

5.3 执行前端回滚

powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\rollback-frontend-aliyun-docker.ps1 `
  -ServerHost 47.94.178.212 `
  -RemoteProjectPath /opt/ai-contract-platform-frontend `
  -BackendTunnelBaseUrl http://10.20.0.11:8001

回滚脚本会先备份当前前端到 /opt/ai-contract-platform-frontend/backups/frontend-aliyun-rollback/，再恢复最近一次 frontend-aliyun-before-*.tgz，重建前端容器并重载 Nginx。

6. 备份与恢复

数据库和 MinIO 的基础备份策略沿用 D:\hyburk.com\backup\docs：PostgreSQL 使用 pg_dump -F c，MinIO 使用 mc mirror 或归档备份。
前端发布脚本自动生成应用级回滚包。
后端发布脚本自动生成 /opt/ai-contract-platform/backups/phase7-backend-deploy/backend-before-*.tgz。
正式变更前应确认最近一次数据库备份、MinIO 备份、前端回滚包均存在且非空。

7. 端口清单

主机	端口	用途
47.94.178.212	80/443	Nginx / `contact.yuqei.com`
47.94.178.212	3003	前端容器本机端口，建议仅本机访问
47.94.178.212	51820/udp	WireGuard
192.168.3.90	8001	AI 合同平台后端
192.168.3.90	5432	PostgreSQL
192.168.3.90	6379	Redis（如对宿主暴露）
192.168.3.90	9000/9001	MinIO API/Console

6.3 KiB Raw Blame History Unescape Escape