wecom-ai-assistant/DEPLOYMENT_SUMMARY.md

DevOps 部署配置总结

✅ 已创建的文件

第一阶段：发布构建文件

• ✅ docker-compose.release.yml - 构建和推送配置
  • Backend: registry.667788.cool/wecom-backend:${TAG}
  • Admin: registry.667788.cool/wecom-admin:${TAG}
  • Nginx: registry.667788.cool/wecom-nginx:${TAG}

第二阶段：构建脚本

• ✅ scripts/build_and_push.sh - Linux/Mac 构建脚本
• ✅ scripts/build_and_push.ps1 - Windows PowerShell 构建脚本

第三阶段：云端部署文件

• ✅ deploy/.env.prod.example - 生产环境变量模板
• ✅ deploy/docker-compose.prod.yml - 生产部署配置
• ✅ deploy/nginx.conf - Nginx 反向代理配置
• ✅ deploy/nginx/Dockerfile - Nginx 镜像构建文件
• ✅ deploy/nginx/nginx.conf - Nginx 配置文件

第四阶段：部署文档

• ✅ README_DEPLOY.md - 完整部署指南

🚀 快速开始

本地构建并推送

Linux/Mac

# 赋予执行权限
chmod +x scripts/build_and_push.sh

# 构建并推送（使用默认标签 latest）
./scripts/build_and_push.sh

# 或指定标签
./scripts/build_and_push.sh v1.0.0

Windows PowerShell

# 构建并推送（使用默认标签 latest）
.\scripts\build_and_push.ps1

# 或指定标签
.\scripts\build_and_push.ps1 -Tag v1.0.0

云端部署

# 1. 进入部署目录
cd deploy

# 2. 配置环境变量
cp .env.prod.example .env.prod
nano .env.prod  # 填写实际配置

# 3. 登录 Registry
docker login registry.667788.cool

# 4. 拉取镜像
docker compose -f docker-compose.prod.yml --env-file .env.prod pull

# 5. 启动服务
docker compose -f docker-compose.prod.yml --env-file .env.prod up -d

# 6. 查看状态
docker compose -f docker-compose.prod.yml ps

📋 镜像命名规则

• Backend: registry.667788.cool/wecom-backend:${TAG}
• Admin: registry.667788.cool/wecom-admin:${TAG}
• Nginx: registry.667788.cool/wecom-nginx:${TAG}

默认 TAG: latest

📁 文件结构

项目根目录/
├── docker-compose.release.yml    # 构建配置
├── scripts/
│   ├── build_and_push.sh         # Linux/Mac 构建脚本
│   └── build_and_push.ps1        # Windows 构建脚本
├── deploy/
│   ├── .env.prod.example         # 环境变量模板
│   ├── docker-compose.prod.yml   # 生产部署配置
│   ├── nginx.conf                # Nginx 配置
│   └── nginx/
│       ├── Dockerfile            # Nginx 镜像 Dockerfile
│       └── nginx.conf            # Nginx 配置文件
└── README_DEPLOY.md              # 部署文档

🔍 验证

验证镜像构建

# 查看本地镜像
docker images | grep registry.667788.cool

# 应该看到：
# registry.667788.cool/wecom-backend   latest   ...
# registry.667788.cool/wecom-admin    latest   ...
# registry.667788.cool/wecom-nginx    latest   ...

验证部署

# 健康检查
curl http://your-server/api/health

# 查看服务状态
docker compose -f deploy/docker-compose.prod.yml ps

# 查看日志
docker compose -f deploy/docker-compose.prod.yml logs -f

📚 详细文档

• 部署指南
• 生产部署详细说明
• 宝塔面板部署

⚠️ 注意事项

1. 环境变量：.env.prod 包含敏感信息，已添加到 .gitignore
2. Registry 认证：推送前需要登录 docker login registry.667788.cool
3. 网络要求：确保服务器可以访问 registry.667788.cool
4. 端口占用：确保 80、443 端口未被占用

🎯 下一步

1. ✅ 构建并推送镜像到 Registry
2. ✅ 在服务器上配置环境变量
3. ✅ 部署服务
4. ✅ 配置域名和 HTTPS（可选）