chore(docs): docs/ 目录全面重新编号 + 重组
**重构前**(旧编号 02-11): - docs/02-产品需求/ → 00 产品规划/PRD - docs/03-技术架构/ → 01-05 子目录散落 - docs/04-原型设计/ → 01-02 产品设计(HTML 原型) - docs/05-原型设计/ → screens/ - docs/06-测试素材/ → 02-E2E / 03-功能 / 04-版本测试 - docs/07-项目管理/ → 任务说明书/日报/计划 - docs/08-安全审计/ → 审计报告 - docs/09-堡垒运维/ → toolbox / deploy - docs/10-项目管理/ → 任务说明书(重复) - docs/11-历史归档/ → deploy-nas-archived **重构后**(新编号 00-07,语义化): - docs/00-产品开发流程与文档管理规范.md - docs/00-版本迭代总览.md - docs/01-产品文档/ (PRD/原型/认证/会话/AI 服务/坐席/集成) - docs/02-技术文档/ (技术方案/架构图/重构记录/前端改造/实现配置) - docs/03-测试文档/ (E2E/功能用例/版本报告/缺陷单) - docs/04-运维文档/ (部署运维/运维指南) - docs/05-运营文档/ (品牌推广/用户手册) - docs/06-安全审计/ (审计报告) - docs/07-项目管理/ (任务说明书/日报/计划/看板) **净收益**: - 目录编号与产品文档管理规范对齐(按文档阶段 01-07 编号) - 消除 02-产品需求 与 10-项目管理 的编号重叠 - 子目录按文档类型分组(如 01-产品文档/00-产品规划、01-产品文档/01-认证与登录) - 把运维/安全/项目管理从 0X 散落改为 04/06/07 合计 494 文件 + 78495 行 / - 14076 行
This commit is contained in:
@@ -0,0 +1,182 @@
|
||||
# 智能IT服务台 - 部署指南
|
||||
|
||||
> **最后更新**:2026-07-05
|
||||
> **目标服务器**:`10.90.5.110`
|
||||
> **域名**:`itsupport.servyou.com.cn`
|
||||
|
||||
---
|
||||
|
||||
## 目录
|
||||
|
||||
1. [部署流程](#一部署流程)
|
||||
2. [蓝绿部署](#二蓝绿部署)
|
||||
3. [故障排查](#三故障排查)
|
||||
4. [回滚方案](#四回滚方案)
|
||||
|
||||
---
|
||||
|
||||
## 一、部署流程
|
||||
|
||||
### 1.1 前置条件
|
||||
|
||||
| 条件 | 状态 | 验证命令 |
|
||||
|------|------|---------|
|
||||
| Linux 服务器 10.90.5.110 | ✅ 已确认 | - |
|
||||
| Docker 已安装 | ✅ 已确认 | `docker --version` |
|
||||
| 域名解析 | ✅ 已配置 | `nslookup itsupport.servyou.com.cn` |
|
||||
| 堡垒机可访问 | ✅ 已配置 | `ssh -p 2222 user@10.212.189.210` |
|
||||
|
||||
### 1.2 快速部署命令
|
||||
|
||||
```bash
|
||||
# 1. 进入部署目录
|
||||
cd /opt/wecom-it-desk
|
||||
|
||||
# 2. 拉取最新代码(可选)
|
||||
git pull origin main
|
||||
|
||||
# 3. 构建并启动
|
||||
docker compose up -d --build
|
||||
|
||||
# 4. 检查状态
|
||||
docker ps
|
||||
```
|
||||
|
||||
### 1.3 一键部署(生产环境)
|
||||
|
||||
详见 [10-一键部署操作包-v0.7.0.md](./10-一键部署操作包-v0.7.0.md)
|
||||
|
||||
### 1.4 部署后验证
|
||||
|
||||
```bash
|
||||
# 检查容器状态
|
||||
docker ps
|
||||
|
||||
# 检查 API 健康
|
||||
curl https://itsupport.servyou.com.cn/api/health
|
||||
|
||||
# 检查日志
|
||||
docker logs wecom_it_backend --tail 50
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 二、蓝绿部署
|
||||
|
||||
### 2.1 什么是蓝绿部署
|
||||
|
||||
蓝绿部署通过维护两套环境(Blue/Green)实现零停机部署和快速回滚。
|
||||
|
||||
### 2.2 部署 Green 环境
|
||||
|
||||
```bash
|
||||
cd /opt/wecom-it-desk
|
||||
|
||||
# 构建并启动 Green 环境
|
||||
docker-compose -f docker-compose-green.yml up -d
|
||||
|
||||
# 验证 Green 环境
|
||||
curl http://localhost:5002/health
|
||||
```
|
||||
|
||||
### 2.3 切换流量
|
||||
|
||||
```bash
|
||||
# 切换到 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
|
||||
```
|
||||
|
||||
### 2.4 端口说明
|
||||
|
||||
| 端口 | 服务 |
|
||||
|------|------|
|
||||
| 80/443 | Nginx (生产入口) |
|
||||
| 5002 | Backend (Green) |
|
||||
| 5080 | Nginx (Green 测试) |
|
||||
|
||||
---
|
||||
|
||||
## 三、故障排查
|
||||
|
||||
### 3.1 常见问题
|
||||
|
||||
#### 502 Bad Gateway
|
||||
|
||||
1. 检查后端容器是否运行
|
||||
```bash
|
||||
docker ps | grep backend
|
||||
```
|
||||
|
||||
2. 检查后端日志
|
||||
```bash
|
||||
docker logs wecom_it_backend --tail 100
|
||||
```
|
||||
|
||||
3. 重启后端
|
||||
```bash
|
||||
docker restart wecom_it_backend
|
||||
```
|
||||
|
||||
#### 500 错误
|
||||
|
||||
详见 [标准故障排查手册](../00-标准故障排查手册.md)
|
||||
|
||||
#### 通讯链路问题
|
||||
|
||||
详见 [标准故障排查手册](../00-标准故障排查手册.md)
|
||||
|
||||
### 3.2 健康检查
|
||||
|
||||
```bash
|
||||
# 后端
|
||||
curl http://localhost:8000/health
|
||||
|
||||
# Nginx
|
||||
curl http://localhost/api/health
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、回滚方案
|
||||
|
||||
### 4.1 紧急回滚
|
||||
|
||||
如果部署后出现严重问题,立即执行:
|
||||
|
||||
```bash
|
||||
# 1. 停止新版本容器
|
||||
docker stop wecom_it_backend_green
|
||||
|
||||
# 2. 切换回原环境
|
||||
sed -i 's/wecom_it_backend_green:8000/wecom_it_backend:8000/' /opt/wecom-it-desk/nginx/nginx.conf
|
||||
docker restart wecom_it_nginx
|
||||
```
|
||||
|
||||
### 4.2 版本回滚
|
||||
|
||||
如需回滚到之前版本:
|
||||
|
||||
```bash
|
||||
# 1. 停止当前版本
|
||||
docker stop wecom_it_backend
|
||||
|
||||
# 2. 重新构建指定版本
|
||||
git checkout <版本标签>
|
||||
docker build -t wecom-it-desk-backend:<版本> ./backend
|
||||
|
||||
# 3. 启动
|
||||
docker run -d --name wecom_it_backend wecom-it-desk-backend:<版本>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 相关文档
|
||||
|
||||
- [10-一键部署操作包-v0.7.0.md](./10-一键部署操作包-v0.7.0.md)
|
||||
- [蓝绿部署指南.md](./蓝绿部署指南.md)
|
||||
- [标准故障排查手册](../00-标准故障排查手册.md)
|
||||
Reference in New Issue
Block a user