wecom_it_smart_desk/docs/04-运维文档/部署运维/蓝绿部署指南.md

# 蓝绿部署指南

## 概述

蓝绿部署是一种零停机部署策略，通过维护两套完全相同的运行环境（Blue 和 Green），实现快速切换和回滚。

## 架构

```
                    ┌─────────────────┐
                    │   Nginx         │
                    │  (流量入口)     │
                    └────────┬────────┘
                             │
              ┌──────────────┴──────────────┐
              │                             │
              ▼                             ▼
     ┌────────────────┐          ┌────────────────┐
     │   Blue 环境    │          │  Green 环境    │
     │  (当前活动)    │          │  (待验证)      │
     │  backend:8000  │          │ backend_green: │
     │                │          │     5002        │
     └────────────────┘          └────────────────┘
              │                             │
              └──────────────┬──────────────┘
                             │
              ┌──────────────┴──────────────┐
              │                             │
              ▼                             ▼
     ┌────────────────┐          ┌────────────────┐
     │  PostgreSQL    │  ←──→   │    Redis      │
     │  (共享)        │          │   (共享)      │
     └────────────────┘          └────────────────┘
```

## 文件说明

| 文件 | 位置 | 说明 |
|------|------|------|
| docker-compose-green.yml | /opt/wecom-it-desk/ | Green 环境配置 |
| switch-blue-green.sh | /opt/wecom-it-desk/ | 切换脚本 |
| nginx.conf | /opt/wecom-it-desk/nginx/ | Nginx 配置（包含 upstream） |

## 部署步骤

### 1. 部署 Green 环境

```bash
cd /opt/wecom-it-desk

# 构建并启动 Green 环境
docker-compose -f docker-compose-green.yml up -d

# 验证 Green 环境健康
curl http://localhost:5002/health
```

### 2. 测试 Green 环境

通过端口 5080 访问 Green 环境进行测试：
- H5: http://服务器IP:5080/itdesk/
- 坐席: http://服务器IP:5080/itagent/
- 管理后台: http://服务器IP:5080/itadmin/

### 3. 切换流量到 Green

```bash
# 方法一：使用切换脚本
./switch-blue-green.sh to-green

# 方法二：手动修改 Nginx 配置
sed -i 's/wecom_it_backend:8000/wecom_it_backend_green:8000/' /opt/wecom-it-desk/nginx/nginx.conf
docker restart wecom_it_nginx
```

### 4. 验证切换

```bash
# 检查 Nginx upstream 配置
grep -A1 'upstream backend_api' /opt/wecom-it-desk/nginx/nginx.conf

# 测试 API
curl https://itsupport.servyou.com.cn/api/v1/system/health
```

### 5. 回滚（如有问题）

```bash
# 方法一：使用切换脚本
./switch-blue-green.sh to-blue

# 方法二：手动修改
sed -i 's/wecom_it_backend_green:8000/wecom_it_backend:8000/' /opt/wecom-it-desk/nginx/nginx.conf
docker restart wecom_it_nginx
```

## 端口说明

| 端口 | 服务 | 说明 |
|------|------|------|
| 80/443 | Nginx (Blue) | 生产入口 |
| 5002 | Backend (Green) | Green 后端 API |
| 5080 | Nginx (Green) | Green 测试入口 |
| 5443 | Nginx (Green) | Green HTTPS |

## 注意事项

1. **数据库共享**：Blue 和 Green 共用同一个 PostgreSQL 和 Redis
2. **文件上传**：上传的文件保存在挂载目录，不受切换影响
3. **会话影响**：切换后用户可能需要重新登录
4. **WebSocket**：切换后现有 WebSocket 连接会断开

## 快速命令汇总

```bash
# 查看状态
docker ps

# 查看 Green 日志
docker logs wecom_it_backend_green

# 切换到 Green
sed -i 's/wecom_it_backend:8000/wecom_it_backend_green:8000/' /opt/wecom-it-desk/nginx/nginx.conf
docker restart wecom_it_nginx

# 切换回 Blue
sed -i 's/wecom_it_backend_green:8000/wecom_it_backend:8000/' /opt/wecom-it-desk/nginx/nginx.conf
docker restart wecom_it_nginx

# 停止 Green 环境
docker-compose -f docker-compose-green.yml down
```

## 更新日志

- 2026-07-05: 初始版本