Files
community/docs/deployment-dev-20261119.md
T
2026-11-19 18:46:56 +08:00

6.2 KiB
Raw Blame History

开发环境更新记录(2026-11-19)

范围与版本

  • 仅更新开发服务器 39.105.93.138,SSH 别名 cad_ai_dev,主机名 lingmiaodongli。
  • 发布编号:20261119T085751Z。已恢复对外访问。
  • 社区 API:vibemake-api,继续使用端口 8993。
  • 管理 API:vibemake-adminapi,继续使用端口 8994。
  • 管理前端:https://dev-vibemake-admin.robotquan.com/。
  • 接口入口:https://dev-vibemake-api.robotquan.com,分别使用 /api 和 /admin-api。
  • 本次未操作正式服务器 101.200.225.61,未更新 CAD 前端或 Python CAD 服务。

构建来自当前两个工作区的独立源码快照,包含当时未提交的修改,未使用旧的 dist.zip。社区仓库基准提交为 6b96ca1eb042bad58521543dc6f1f5c0681cd6d9,管理前端仓库基准提交为 25acae2c8b32ebd3eb0b62fe4b1713dcdb7a1052。发布目录中的两个 *-source-manifest.json 记录完整快照文件摘要;构建后已核对源文件未漂移。

本次变化

  • 管理端增加拼装动画制作状态的展示、切换和筛选,状态为 UNPROCESSED、IN_PROGRESS、COMPLETED。
  • 管理 API 增加 PUT /admin-api/projects/{projectCode}/assembly-animation-status,项目列表接受 assemblyAnimationStatus 参数。
  • 两个 Java 应用一起更新,使用相同的新项目实体。其余当前工作区的已构建修改同时纳入此次发布。
  • 保留现有容器环境变量、端口、日志挂载、网络、重启策略及其他 HostConfig;凭据未输出到部署记录。
  • 基于原服务器镜像,仅替换应用 JAR;未在线升级 JDK、Docker、MySQL 或其他服务。
  • 静态资源先上传,入口 index.html 最后原子替换,旧的带摘要资源文件保留。
  • 切换期间对两个开发 API 路径临时返回 503,恢复后代理文件与备份逐字节一致;未永久变更反向代理或 CORS。

数据库变更

开发库 community 的实体字段已逐一核对,只有下列字段缺失。在备份数据库并停止两个旧 Java 服务后执行;未修改仓库内的 .sql 文件:

ALTER TABLE project
  ADD COLUMN assembly_animation_status VARCHAR(16) NOT NULL DEFAULT 'UNPROCESSED'
    COMMENT '拼装动画制作状态 UNPROCESSED未处理 IN_PROGRESS进行中 COMPLETED已完成';

更新后原有 111 个项目均为 UNPROCESSED。切换前后仓库状态均为 IDLE=108、REVIEW=3;迁移任务仍为 SUCCEEDED/LINKED=4、FAILED/MIGRATING=3,未重试或清理既有失败、待核对记录。没有执行全量历史迁移。

验证结果

  • 使用 Homebrew JDK 21 完成 mvn -B -ntp verify,全部模块构建成功。764 项测试,750 项通过、14 项真实外部环境测试按配置跳过,无失败或错误。
  • 本地测试显式禁用真实 AI、OSS、Git 外部集成;测试类内的模拟功能测试按各自配置运行。这些参数没有覆盖服务器现有应用配置。
  • 首轮测试曾遇到一次 AI 搜索 SSE 用例事件为空;未修改代码,随后完整测试通过,最终发布基于成功的整轮构建。
  • 管理前端 npm run build:dev 成功,状态功能、环境地址、日期相关的 22 项 Playwright 测试全部通过。
  • 服务器两个新容器均正常运行、重启次数为 0,启动及验收时的应用标准输出日志未发现 ERROR。运行中 JAR 与本地产物 SHA-256 一致。
  • 公网管理首页 HTTP 200,HTML 摘要与本地新构建一致,部署的 22 个前端文件摘要全部一致。
  • 实际 Chromium 打开开发管理站,登录界面正常、新入口脚本已加载,无页面异常或本站静态资源错误。
  • 公网项目类型和项目列表均为 HTTP 200 / OK,验证了新实体在现有 MySQL 库上的读取。
  • 管理端匿名访问返回 HTTP 401 / UNAUTHORIZED。
  • 开发管理 Origin 的登录 POST、状态更新 PUT 预检均 HTTP 200,允许来源正确。
  • 运行中管理 API 的 OpenAPI 确认新状态 PUT 接口及列表筛选参数均已注册。
  • Python CAD API、worker 保持原启动时间,未重启。

未使用真实管理员密码登录,也未在现有业务项目上执行状态写入;状态保存、筛选、权限和旧元数据覆盖保护由隔离的后端及前端测试验证。

产物摘要

产物 SHA-256
vibemake-api.jar 309565f62970082e27c585f40609a796dd14f13bede689b10ed02f0dbba84940
vibemake-adminapi.jar 5e758ea3d1b711804e8971730798ca899a1e7d3613100cf6f65a8cc9e62f2b1d
管理前端 index.html d32969a62483eb3ee371ed6f08abe2c07ceefae415699c0452f253b49e62d943

备份与回退

服务器发布目录:/opt/vibemake-deploy/releases/20261119T085751Z。

服务器备份目录:/opt/vibemake-deploy/backups/20261119T085751Z,根目录权限为 700,包含:

  • 两次数据库备份:community-before.mysql.gz、community-stopped.mysql.gz,备份退出状态、压缩文件可读性、大小及摘要已验证。内容仅保存在服务器受保护目录。
  • 原容器完整配置 containers.json,包含敏感环境变量,禁止复制到 Git 或公开输出。
  • 原管理前端 admin-dist.tar.gz 及文件摘要。
  • 原开发域名配置及两个 API 代理文件。

旧容器保留为 vibemake-api-backup-20261119T085751Z 和 vibemake-adminapi-backup-20261119T085751Z。旧容器已停止,自动重启已关闭,避免主机重启时与当前版本争抢端口;当前新容器保持原来的 always 重启策略。

如确认需要回退应用,在核对没有新导入或写入任务后,执行以下命令。该命令是实际回退操作,未在本次验收中运行:

ssh cad_ai_dev 'cd /opt/vibemake-deploy/releases/20261119T085751Z && python3 rollback_release.py'

回退脚本会临时开启维护、恢复旧容器及其重启策略、恢复旧前端入口,再恢复代理。保留新增字段及其数据,不自动回滚数据库或删除对象。 如有正在运行的任务或未排空写入,先处理任务,不能强制回退。数据库备份只供必要时人工恢复,不应覆盖更新后产生的新业务数据。

服务器剩余磁盘约 6.3 GiB(使用率 91%),已保留此次回退所需镜像和容器,未执行全局清理。后续发布前需继续检查磁盘与内存余量。