dy-dashboard/vault/知识库/工作指南/训练记录/2026-09-21-云端部署文档编制.md
2026-10-28 11:14:17 +08:00

38 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 2026-09-21 dy-dashboard 云端部署文档编制
### 1. 生成云端服务器部署文档
**旭东 → OpenClaw:**
> 我现在要把这这些代码部署到云端服务器里面,帮我生成一个部署文档
**OpenClaw 响应:**
已生成 `云端部署指南.md`(项目根目录,13.5KB),并先做实测核对再把本次待部署差异写进文档。**未执行任何部署动作。**
**目标环境实测(2026-09-21)**
- SSH `ubuntu@82.156.135.91`,域名 `gyl.dieya.net.cn`,项目 `/opt/dy-dashboard`(非 Git 仓库)
- 磁盘 40G,23G 已用 / 16G 可用(60%);服务 `dy-dashboard.service` active;Python 3.12.3;Gunicorn 18888
- 数据库 `dy_data` / `dy_app`;52 张表,本地 985 列 vs 云端 986 列
**文档包含的十四个章节**
授权与边界、部署前检查、备份与恢复、代码同步(定向 rsync 推荐 + 打包文件谨慎)、数据库结构增量迁移、代码自检与缓存、服务重载、验证探针、回滚、本次待部署内容、记录同步、常见故障速查、SSH 多行脚本写法约束。
**写进文档的关键红线**
- 不覆盖云端 `config.py`(内含云端专属 VAULT_PATH)、不删除云端独有列或表、不覆盖 `static/uploads`、不动备份目录、不在云端执行 git
- 磁盘满会表现为「页面能开、点登录没反应」,要求先看 `df -h /`
- 改了 `static/js/app.js` 必须重新生成 `app.js.gz`,否则前端改动看不到效果
- 手工 SQL 导入后必须 `refresh_all_caches()`,否则数据显示旧值
- 改单元文件本身时必须 `daemon-reload + restart`,`kill -HUP` 不会应用新 ExecStart
**本次实测待部署内容**
- 代码差异 15 项:`run.py`、`update_data.py`、`backup.sh`、`routes/`(ai、inventory、planning、products、purchase 共 5 个)、`services/`(ai_datasources、db、field_perms 共 3 个)、`static/js/app.js` 与 `app.js.gz`
- 数据库结构**无需迁移**:云端多出 1 列 `finished_products.待提数量`(int),按规则保留不删
- 另发现 `bom_packaging.updated_at`、`packaging_orders.计划下单时间` 仅列顺序有差异、定义相同,文档中已提醒不要用不带 `ordinal_position` 的裸 diff 判断
**明确未做**:未部署、未改云端任何文件、未操作 11.79 生产环境。