Revert688aad3,39ac03a,c84dc36, andff6a828in reverse chronological order. Restore the exact tracked tree from99aff42while preserving history. Validation: 29 authentication and base-path tests passed offline. All 23 prior UI browser tests ran in system Edge: 22 passed initially; the fake-login test passed on an unchanged isolated retry. Live game HTTP was blocked throughout browser validation.
6.0 KiB
6.0 KiB
Deploy owner 交接与冻结记录
分支 develop/v2.0.0,基线 main v1.2.0 (7fe4c0f),Web 源码版本 2.0.0.dev1。本 owner 完成部署与更新范围,未 commit、push、合并、发布镜像或触发线上部署;未读取或修改桌面私有账户,未调用真实游戏 API 或真实 GitHub Releases。
文件
- 根目录:
Dockerfile、compose.yaml、.dockerignore、Start_Ranch_Web.cmd、start-web.sh;.gitignore仅追加 Web 虚拟环境、设计缓存与部署运行产物排除;根README.md仅增加 Web 开发/部署入口。 ranch_web/updates.py:标准库发布检查、严格稳定 2.x 比较、只读宿主机心跳授权、原子 pending 请求与脱敏公共状态;包含 CI 的固定仓库/源码版本发布校验函数。ranch_web/tests/test_updates.py与test_web_updater.py:本 owner 独立测试文件。ranch_web/README.md:Windows/Linux Python 开发启动、数据隔离、环境设置与更新限制。.github/workflows/web-image.yml:PR/手动只测试与构建,官方严格v2.x.ytag 且源码版本完全一致时才推固定 GHCR 镜像。仓库名称比较忽略大小写,覆盖AttilaNet/myrzx_bot。deploy/web/:更新器、Compose 包装脚本、systemd service/timer、环境及 TOML 示例、部署文档与 精确更新协议。
已执行验证(部署专项)
Windows Python 3.13.15:
python -B -m unittest ranch_web.tests.test_updates ranch_web.tests.test_web_updater -q
41 项通过,无跳过。 GitHub 和 Docker 为 mock,数据全部在独立 TemporaryDirectory。覆盖:
- 仅稳定
v2.x.y,过滤 1.x、3.x、草稿、预发布、前导零、命令/换行注入;数字版本排序;2.0.0.dev1 → v2.0.0可升级,同版正式版本/降级拒绝。 - 未配置、过期、禁用、错误实例、未来时间的能力证明;Web 数据目录不能自行开启执行器;pending 去重;公共错误不泄露原始异常或私有数据。
- 宿主机独立从 fake 官方 Releases 复验,不信 Web 标签;operator opt-in;过期/额外命令字段/跨实例请求拒绝;自动安装默认关闭。
- 旧服务运行时 pull、停服后才快照;拉取失败不停止;备份失败恢复旧镜像;健康失败恢复 SQLite、密钥和准确旧镜像,保留失败版本数据;回滚失败保存事务,恢复可重试。
- 实际
WebManager在全网络 connect 禁止条件下,以内置离线 demo 开启策略,然后关闭、快照、重启及还原:保留勾选偏好与相同加密密钥,但running=false,不会自动恢复执行。 - 正式镜像 label 仍是 dev 或健康失败时不能宣告更新成功;官方仓库名称大小写、fork 拒绝、源码版本/tag 不一致拒绝。
--dry-run对 Windows 与随附 Linux 路径示例均有效,不联网、不执行 Docker、不创建文件。
另外已执行:
Start_Ranch_Web.cmd --version返回2.0.0.dev1。- 实际 Windows
python -m ranch_web --demo --no-browserHTTP 启动烟测:临时数据、动态本地端口;导入钩子禁止 PySide6/桌面 GUI,禁止外部 DNS/connect;健康、离线账号与更新禁用状态正常,触发 SIGINT 后正常 lifespan 退出,exit 0。该测试不含页面浏览器验收。 start-web.sh与deploy/web/compose.sh通过 Git Bashbash -n;两个 YAML 解析通过;静态核对单服务、UID/GID 10001、/data、独立只读心跳挂载、无 Docker socket、120 秒停止宽限;git diff --check通过。- 官方 Docker/GitHub 文档已核对并在 部署说明 链接。必要的
ranch_assistant/data/progression_battles.zip在.dockerignore中显式保留。
Main/API/前端集成注意与未执行范围
- 所有文档、容器与当前 API config 统一
RANCH_WEB_DATA_DIR、RANCH_WEB_HOST、RANCH_WEB_PORT;DockerWEB_CONCURRENCY=1,CLI 不打开浏览器。 - API 已使用更新 DTO 专用序列化保留合法
request/request_id,游戏凭据脱敏保持有效;HTTP 与 meta 的 pending/applying 信息已对接。前端从latest_version原样传完整v2.x.y。 request_update()在无执行器时返回unavailable,成功提交仅是pending;不能把 HTTP 202 文案写成“已更新”。心跳目录只读,协议 1,timer 每五分钟;accept_web_requests=false与auto_apply=false均为默认值。- 本机无 Docker 可执行程序;没有验证 Linux/Docker 构建、Compose 真实解析/拉取、UID bind mount 实机权限、systemd 或真实健康回滚,也未执行 CI。静态配置与 mock 测试不能替代上述实机验收。CI 已编写隔离网络的容器健康/权限/停止检查,等待父代理审核后在授权发布流程执行。
- GHCR 首次包为私有的处理已记录:公共发布需设包 Public;私有部署由操作者
docker login,Web 无 registry 凭据或 Docker socket。更新器 systemd 允许只读访问 root 的 registry 登录配置。
最终集成与复核
Main 确认最终非浏览器后端 185项:184通过、1跳过(Windows符号链接权限),0失败/错误,用时26.878秒;执行前后69份源文件哈希一致,无外发尝试。浏览器 13项通过,JS/CSP错误为0,另以新 Edge 进程验证15页与主线/孵蛋子页。上述部署专项41项、定向复核与全量测试有重叠,不相加。
本 owner 对此前五项问题复核完成:编码后与 requests 发送前的停止检查有效;修改配置不误关运行开关;120个筛选后视图缓存32项、已完成任务索引归零;主线/孵蛋标签 key 完整;12个并发错误登录得到10个401和2个429。六项定向回归与原始复现均通过,未扩大审查或重跑整套测试。
完整后端及浏览器命令见 Web 验证说明。未进行真实游戏 API、Linux Docker、systemd 或生产更新器实机验收,未发布镜像或触发部署。生产代码保持冻结,仅更新最终文档,交 Main 提交。