bingshuo
7f5ad74c6b
Part 1/4 of the verified continuation from local 18dfdfd: navigation, in-place upgrade boundary, enterprise UPGRADE_STAGING checkpoint, identity and intent state. Source base b03619e.
86 lines
3.9 KiB
Text
86 lines
3.9 KiB
Text
# AW-HLCC-DEPLOYMENT-CHECKPOINT-20260726
|
||
|
||
> **目标节点**：`AW-GZ-001`
|
||
>
|
||
> **现场主机名**：`GH-CVM-MAIN-PROD-01`
|
||
>
|
||
> **目标服务**：HoloLake Code Channel Enterprise isolated candidate
|
||
>
|
||
> **状态**：UPGRADE_STAGING · ISOLATED_CANDIDATE_HEALTHY · PRODUCTION_NOT_CUT_OVER
|
||
|
||
## 已核验现场
|
||
|
||
- 腾讯云 OrcaTerm 官方在线终端可用。
|
||
- 现有 `lighthouse-gitea`、PostgreSQL、Redis 容器健康。
|
||
- 现有 Gitea 为 `gitea/gitea:1.21.11`，监听 `127.0.0.1:3000`；不得覆盖。
|
||
- 企业灯塔 `guanghu-enterprise-lighthouse.service` 正常，监听 `127.0.0.1:8031`。
|
||
- 旧光湖驱动引擎 `/opt/engine.js` 仍监听 `0.0.0.0:3910`，提供旧执行、健康、状态和文件
|
||
路由并连接多个历史节点。它是升级依赖，不得当成无关服务或直接拔除。
|
||
- `api-router.service` 运行 `/root/api-router-v3.py`，是旧 Python 网关。
|
||
- `guanghu-portal.service`、`/opt/zhuyuan/revive-guard/revive-guard.py`、TAT/Barad Agent
|
||
均属于需要恢复拓扑和职责边界的既有运行面。
|
||
- 旧驱动脚本含硬编码历史节点访问材料且为世界可读，必须在调用方盘点后迁移、轮换和收口；
|
||
不得把材料复制到对话、仓库、意图胶囊或新回执。
|
||
- Nginx 监听 80/443；本轮不修改公网反向代理或生产入口。
|
||
- `/etc/fstab` 仍声明 `/dev/vdb -> /data`，但 `lsblk` 当前不存在 `/dev/vdb`，
|
||
`data.mount` 因此失败。系统盘约 50GB、当前剩余约 30GB。
|
||
- 现有企业 Gitea 数据位于 `/opt/docker-data/lighthouse-cn/data/lighthouse/gitea`，
|
||
其中已有 `bingshuo/lighthouse.git` 与 `bingshuo/hololake-world.git`。
|
||
- `certbot.service` 为已不存在单元的旧失败记录，不是当前代码频道故障根因。
|
||
|
||
## 离线包
|
||
|
||
本地包：
|
||
|
||
```text
|
||
光湖代码频道-Forgejo-16.0.1-完整离线包
|
||
```
|
||
|
||
本机 `MANIFEST.sha256` 六个文件已全部通过。企业节点具备 `/usr/bin/gpg`；上传结束后必须
|
||
在目标端再次执行完整 SHA-256 校验、发布密钥指纹核对和二进制签名验证。
|
||
|
||
## 部署边界
|
||
|
||
隔离验证阶段只允许：
|
||
|
||
1. 上传到隔离暂存区；
|
||
2. 在系统盘创建隔离候选目录；
|
||
3. 以无登录专用用户运行；
|
||
4. 监听 `127.0.0.1:3340`；
|
||
5. 导入离线光湖代码频道 bundle；
|
||
6. 验证版本、首页、仓库读取、重启保持和关闭在线更新；
|
||
7. 写回执。
|
||
|
||
本轮不允许：
|
||
|
||
- 替换现有 `127.0.0.1:3000` Gitea；
|
||
- 修改 Nginx 生产路由或自动开放公网；
|
||
- 把缺失的 `/data` 当作已挂载；
|
||
- 复制个人第五域账号、密码哈希、令牌或仓库数据库；
|
||
- 使用旧 `3910` 任意命令驱动；
|
||
- 未验签启动、自动镜像、在线更新或 Actions。
|
||
- 把 `3340` 候选声明为脱离旧语言系统的第二套权威代码频道；
|
||
- 未恢复旧小湖灯、驱动、门户和守护 Agent 拓扑就替换旧内部入口。
|
||
|
||
## 恢复顺序
|
||
|
||
```text
|
||
完成六文件上传
|
||
→ 目标端 SHA-256 + GPG 指纹 + 签名
|
||
→ 建立 nologin 的 guanghu 服务用户
|
||
→ 安装到 /var/lib/guanghu-enterprise-code-channel/candidates/hlcc-v16.0.1
|
||
→ 启动 127.0.0.1:3340 隔离候选
|
||
→ 健康验证并写隔离候选回执
|
||
→ 恢复旧小湖灯、驱动、门户、守护 Agent 和内部进入方式的全局拓扑
|
||
→ 把新导航/意图/Agent 门作为兼容升级嵌入旧链路
|
||
→ 再决定导入 guanghu-code-channel.bundle 与正式迁移
|
||
→ 验证前停在 UPGRADE_STAGING，不切公网
|
||
→ 后续单独决定恢复 /dev/vdb 或登记正式替代数据根
|
||
```
|
||
|
||
## 京东链路判断
|
||
|
||
2026-07-26 本机访问 `https://guanghulab.com/`、`/authz/health` 和 `/code/` 均返回
|
||
HTTP 200。当前“京东又上不去”不是整机公网服务中断；已发现的问题是在线授权运行时版本偏旧、
|
||
AW 导航图读取失败以及动作/传输链未完全登记。工单批准、导航图、动作注册、传输、执行和健康
|
||
回执必须继续分开证明。
|