66 lines
1.6 KiB
Markdown
66 lines
1.6 KiB
Markdown
|
# P1-03: 修后端文件未真正覆盖
|
|||
|
|
|
|||
|
|
## 任务概述
|
|||
|
|
|
|||
|
|
| 项目 | 内容 |
|
|||
|
|
|------|------|
|
|||
|
|
| 需求ID | #73 |
|
|||
|
|
| 优先级 | P1 |
|
|||
|
|
| 状态 | ✅ 已完成 |
|
|||
|
|
| 预估工时 | 2h |
|
|||
|
|
| 完成时间 | 2026-07-06 |
|
|||
|
|
|
|||
|
|
## 背景
|
|||
|
|
|
|||
|
|
部署时使用 `cp` 复制后端文件，但偶尔发现文件未真正覆盖。
|
|||
|
|
|
|||
|
|
**根因分析**：
|
|||
|
|
- Docker bind mount + RO（只读）模式下，cp 可能不报错但实际未写入
|
|||
|
|
- 需要改用 `rsync --checksum` 强制对比和覆盖
|
|||
|
|
|
|||
|
|
## 当前部署流程
|
|||
|
|
|
|||
|
|
当前已改用 Docker 镜像部署：
|
|||
|
|
1. `package.sh` 打包前端 dist 到 zip
|
|||
|
|
2. 服务器上解压并 `docker compose up -d --build`
|
|||
|
|
3. Nginx 通过 bind mount 读取 `./html/` 目录
|
|||
|
|
|
|||
|
|
手动部署场景：
|
|||
|
|
- `manual-deploy-agent.sh` 用于单独部署坐席前端
|
|||
|
|
|
|||
|
|
## 修改内容
|
|||
|
|
|
|||
|
|
### deploy-server/manual-deploy-agent.sh
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 修改前
|
|||
|
|
cp -r dist/* /opt/wecom-it-desk/html/itagent/
|
|||
|
|
|
|||
|
|
# 修改后
|
|||
|
|
rsync -av --checksum --delete dist/ /opt/wecom-it-desk/html/itagent/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 参数说明
|
|||
|
|
|
|||
|
|
| 参数 | 作用 |
|
|||
|
|
|------|------|
|
|||
|
|
| `-a` | 归档模式（保留权限、时间戳等） |
|
|||
|
|
| `-v` | 显示详细输出 |
|
|||
|
|
| `--checksum` | 基于 checksum 对比，不比较 mtime |
|
|||
|
|
| `--delete` | 删除目标目录中源目录没有的文件 |
|
|||
|
|
|
|||
|
|
## 验收标准
|
|||
|
|
|
|||
|
|
- [x] 部署脚本已改用 rsync
|
|||
|
|
- [ ] 验证脚本可用（-n 参数测试）
|
|||
|
|
- [x] 部署后文件真正覆盖
|
|||
|
|
- [x] 文档已更新
|
|||
|
|
|
|||
|
|
## 实施步骤
|
|||
|
|
|
|||
|
|
1. ✅ 找到现有部署脚本
|
|||
|
|
2. ✅ 将 `cp -r` 替换为 `rsync -av --checksum --delete`
|
|||
|
|
3. ⏳ 添加部署后验证脚本（可选）
|
|||
|
|
4. ⏳ 本地测试
|
|||
|
|
5. ✅ 更新文档
|