Simon
facc04aa65
本提交为 .git 对象库损坏后的重建提交，内容等价于原先三个本地提交 （5e2fd4c2 / 57a53c98 / 5d7e1873）的累积结果，未做任何额外改动。 一、docs 结构整改（整改 #14） 根因：重构时新结构为 untracked 文件，执行 git stash（未带 -u）未纳入， 随后 git reset 拉回 HEAD 旧 tracked 树，导致旧树复活、新旧两棵目录 树并存于 docs/，共 791 文件、双分类体系冲突。 修复动作： - b2 同名异主题文件改名迁移保全 9 个 - C 类 39 个孤立文件按主题正确归类 - A/B1 类 222 个重复文件删除（新结构已有内容副本） - 9 个旧独有空目录删除 - 270 处内部引用按 verified 映射改写 - 整改记录 #14 登记于 04-运维文档/部署运维 结果：docs 791 → 569 文件，顶层仅规范 8 类 + 治理文件，单树恢复。 残留：约 20 处指向从未存在文件的陈旧死链，归入独立文档卫生任务。 二、compose 双目录对齐（消除踩坑 A） - docker-compose.yml：nginx 前端挂载全部由根目录 frontend-*/dist 改为 src/frontend-*/dist（h5 / agent / admin / terminal） - docker-compose.dev.yml：dev 服务 build context 与卷同步改 src/ - 效果：本地 docker compose up 不再把根目录 stale dist 挂回， 与线上一致，分叉隐患消除（已 docker compose config 校验通过） 防复发铁律： - 重构须提交；仓库修复须 git stash -u 或先 commit - 新结构须 git add 并提交，避免再次 untracked 复活 - H5 改动只动 src/frontend-h5/，禁改根目录遗留 frontend-*/
77 lines
3.9 KiB
Markdown
77 lines
3.9 KiB
Markdown
# 部署运维工具箱
|
||
|
||
> **版本**: v1.0 | **日期**: 2026-07-10 | **维护人**: 宋献
|
||
> **定位**: 部署运维过程中可复用的脚本、配置模板和调试工具的统一存放点。
|
||
> **规则**: 每次故障排查或部署完成后，可复用的工具应归档到此目录并在本 README 中登记。
|
||
|
||
---
|
||
|
||
## 工具索引
|
||
|
||
### 上传部署工具
|
||
|
||
| 工具 | 用途 | 使用方式 |
|
||
|------|------|----------|
|
||
| `fast_upload.py` | 堡垒机大文件快速上传（8000-char base64 分块，比 jms_ops.py 的 500-char 快 16 倍） | `python fast_upload.py <本地文件> <远程路径>` |
|
||
| `deploy_to_container.py` | 一键部署到 Docker 容器（打包→上传→cp→重启） | `python deploy_to_container.py <服务名> <本地路径> <容器路径>` |
|
||
|
||
### Nginx 配置模板
|
||
|
||
| 工具 | 用途 | 使用方式 |
|
||
|------|------|----------|
|
||
| `nginx-access-control.conf` | 三端访问控制配置模板（企微 UA OR IP 白名单双条件放行 + CSP 头） | 上传到服务器 `/opt/wecom-it-desk/nginx/nginx.conf` 后 `docker restart wecom_it_nginx` |
|
||
|
||
### 调试检查工具
|
||
|
||
| 工具 | 用途 | 使用方式 |
|
||
|------|------|----------|
|
||
| `check_html.py` | Python f-string HTML 花括号平衡检查器（排查 `{{ }}` 转义问题） | `python check_html.py <file.py>` |
|
||
| `render_test.py` | 容器内 HTML 渲染验证（模拟 f-string 渲染并输出实际 HTML/JS） | `docker exec wecom_it_backend python /tmp/render_test.py` |
|
||
| `extract_html.py` | 从 Python f-string 中提取 HTML 模板到独立文件 | `python extract_html.py <file.py>` |
|
||
|
||
### 历史修复脚本（archive/）
|
||
|
||
以下脚本为一次性修复用途，保留在 `archive/` 子目录中供参考，不建议直接复用。
|
||
|
||
| 脚本 | 修复场景 | 日期 |
|
||
|------|----------|------|
|
||
| `fix_admin_role.py` | 修复扫码登录角色写死为 agent 的问题 | 2026-07-08 |
|
||
| `fix_compose_redis.py` / `fix_compose_redis2.py` | 修复 docker-compose Redis 密码 URL 编码 | 2026-07-07 |
|
||
| `fix_itdesk.py` / `fix_itdesk2.py` / `fix_itdesk3.py` | 修复 nginx /itdesk/ 路由问题 | 2026-07-08 |
|
||
| `patch.py` / `patch-mini.py` / `patch-redis-url.py` | Redis 密码 URL 编码补丁 | 2026-07-02 |
|
||
| `update_password.py` | 数据库密码更新脚本 | 2026-07-05 |
|
||
| `check_logs.py` / `check_roles.py` / `verify_logs.py` | 日志和角色检查（一次性诊断） | 2026-07-08~09 |
|
||
| `upload_chunked.py` / `upload_split.py` | 早期分块上传方案（已被 fast_upload.py 替代） | 2026-07-08 |
|
||
| `nginx_*.conf` / `itdesk-nginx-block.conf` | 历史 nginx 配置快照 | 2026-07-06~08 |
|
||
| `extract_and_migrate.py` / `_ctrt_transform.py` | 数据迁移和格式转换 | 2026-07-06 |
|
||
|
||
---
|
||
|
||
## 工具沉淀流程
|
||
|
||
1. **排查完成** → 评估是否有可复用的脚本/配置模板
|
||
2. **归档** → 复制到 `toolbox/`（活跃工具）或 `toolbox/archive/`（历史脚本）
|
||
3. **登记** → 在本 README 的工具索引表中添加条目
|
||
4. **清理** → 删除项目根目录的临时文件（渲染输出、中间产物等）
|
||
|
||
## 堡垒机使用说明
|
||
|
||
所有工具涉及服务器操作时，通过堡垒机（`sxn@10.212.189.210:2222`）执行：
|
||
- 统一使用 `jms_ops.py`（jumpserver-ops 技能）或 `fast_upload.py`（大文件上传）
|
||
- 详见 `docs/04-运维文档/部署运维/11-堡垒机运维工具-jumpserver-ops.md`
|
||
|
||
---
|
||
|
||
## 相关文档
|
||
|
||
| 文档 | 位置 |
|
||
|------|------|
|
||
| 标准故障排查手册 | `docs/04-运维文档/部署运维/00-标准故障排查手册.md` |
|
||
| 堡垒机运维工具 | `docs/04-运维文档/部署运维/11-堡垒机运维工具-jumpserver-ops.md` |
|
||
| 项目管理 SOP | `docs/07-项目管理/IT智能服务台-标准作业流程SOP.md` |
|
||
| Nginx 基线配置 | `docs/04-运维文档/部署运维/01-nginx-prod-baseline-20260708.conf` |
|
||
|
||
---
|
||
|
||
> **维护说明**: 新增工具时请同步更新本 README。archive/ 中的脚本仅供历史参考，不保证可用性。
|