Files

3.9 KiB
Raw Permalink Blame History

部署项目整理与检查报告

本报告记录 2026-10-27 首次部署整理。2026-10-28 新增主动通知业务的变化、79 项通过的回归结果及未部署边界,见 NOTIFICATIONS.md,不包含在下面的历史“业务源码未改”结论中。

日期:2026-10-27。范围:本地 Git 仓库新增 deployable/,不修改原始导出源码及当前 ECS 服务。

已完成

项目 结果及证据
原始快照保留 316 个原文件按根目录 SOURCE_SHA256SUMS.json 逐个校验一致
业务源码 deployable/relay 与 host-code/relay 逐文件一致;协议、加密、绑定及 API 白名单未改
构建入口 Dockerfile、Dockerfile.offline、relay、requirements.lock、pyproject.toml 位于统一目录
Compose 合并为 7 个服务;无 REDACTED 占位;CA/连接器路径、数据库名和内部服务地址恢复为明确值
配置模板 .env.example 可提交;settings.env、.env、运行密钥、备份及依赖二进制被 Git 排除
自动签发 内部 enrollment-signer,无宿主端口;只有该服务挂载 CA 私钥
首次初始化 新随机密码、新 CA、新连接器密钥;拒绝覆盖已有部署;证书私钥匹配、SAN、有效期检查
Work 和 OAuth 长连接默认启动,用户授权开启;应用凭据由部署者提供;个人授权仍需用户操作
宿主机代理 本项目应用容器显式直连,保留已有业务源码的 trust_env=False 行为;宿主机代理不改
运维 构建、初始化、检查、启动、状态、日志、停止、备份、升级、镜像回滚入口
文档 新环境在线/离线部署、配置修改、备份恢复、升级限制及业务验收清单

本地执行结果

  1. 通过新增部署测试及现有源码测试:60 passed,1 skipped。跳过项为未提供真实 PostgreSQL 测试连接的用例;其他用例使用本地 HTTP/WebSocket、FakeRedis/平台桩,不冒充真实平台验收。
  2. 新增 6 项部署测试覆盖:IP SAN 证书生成、独立随机凭据、防覆盖、缺证书拒绝、证书主机名不符拒绝、模板占位拒绝、Compose 内部签发边界及构建输入检查。
  3. 在 WSL Bash 中执行 bash -n,relayctl.sh、load-offline.sh、prepare-offline.sh 语法通过。
  4. 新增 Python 文件 AST 语法检查通过。已修正 Python 3.12 不提供 ssl.match_hostname 的兼容问题,部署工具自行检查 SAN;业务 TLS 验证未关闭。
  5. 原始 316 个文件哈希校验通过,新部署业务源码没有修改。

可复核命令(在仓库根目录,测试环境需安装 pytest、pytest-asyncio、fakeredis、PyYAML 等锁定依赖):

PYTHONPATH=deployable python -m pytest deployable/tests deployment-source/tests -q
bash -n deployable/scripts/relayctl.sh
bash -n deployable/scripts/load-offline.sh
bash -n deployable/scripts/prepare-offline.sh

未验证项目

  • 本机没有 Docker Engine,未运行 docker compose config、镜像构建或容器启动;当前 YAML 检查是静态解析,不等同于 Compose 实际校验。
  • 新目录在干净 Linux ARM64 环境中的 UID 权限、容器健康、PostgreSQL/Redis 连接、网关 TLS、长连接重连尚待实机验证。
  • 真实机器人消息、PC 注册绑定、双用户隔离、OAuth 和平台业务 API 未针对本次新部署目录重新验收。
  • 数据备份和恢复、升级及镜像回滚未在真实 Docker 环境执行;镜像回滚不保证跨数据库结构变更兼容。
  • 未创建真实日程或发送邀请。

交付判断

代码已整理为有配置模板、统一构建/运维入口和部署步骤的项目;部署者仍需提供 Docker、平台凭据与权限、网络和受信任网关证书。此报告不将本地通过项等同于新环境部署验收通过。按 ACCEPTANCE.md 完成实机验收后才能作最终投产结论。

本次不包含向量检索或其他未验收功能。