Files

53 lines
3.9 KiB
Markdown
Raw Permalink 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-10-27 首次部署整理。2026-10-28 新增主动通知业务的变化、79 项通过的回归结果及未部署边界,见 [NOTIFICATIONS.md](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 等锁定依赖):
```bash
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 完成实机验收后才能作最终投产结论。
本次不包含向量检索或其他未验收功能。