lei.chen
805288d747
E2 Phase 2: external-license-resources 运维面 — stale 标记、last-updated 展示、xceadmin extres status
design.md 3.5 Phase 2（PEN D reason 专用名为可选项，复用 PREASON_NO_RESOURCE
已带资源名，跳过）：
① esd stale 标记与 WARN
- esd_source_t 增 stale_limit/last_ok_time；esd_source_is_stale(): 从未有值
不算 stale、时钟超前钳到 0、严格大于（interval==limit 不抖动）、
ESD_STALE_LIMIT_DEFAULT 150；fail-open 保持旧值不变
- 采集失败首轮一次性 WARN，过限后每轮升级为 STALE WARN（带 age/limit/kept
值），恢复即静默
- status 文件 esd_status_write(): daemon/pid/started_at/generated_at/
pushes ok/fail/sources[{name,last_value,last_ok_time,stale}]，tmp+rename
原子写；写失败仅状态转换时告警一次，绝不拖垮 poll 循环
② `xce resources` 展示 last-updated
- controller worker.c: EXTERNAL 共享值被接受时盖 last_report——同时盖
live resmgr 对象与 myconf 配置树副本（apiserver 定义 store 只由 join 时
config push 供给，串行的是配置树，缺后者 CLI 永远显示 never）
- scheduler core_events.c: RESOURCES_PUSH 原地更新拷贝 last_report（纯
metadata，resobj.c 比较本就排除）
- apiserver: model 带 last_report + 默认列（SelectFields 只投影默认列，
缺失即 API/CLI 全链不可见）；convert cResourceToModel 透传
- apiserver handler.go: OnResourceLocationUpdated 对 host=="" 且定义带
EXTERNAL(0x10) 的推送刷新 store 内 LastReport——config push 快照之外
的活刷新；host 来源值与非 EXTERNAL 资源绝不触碰
- xcecli: LAST_UPDATED 列（-l verbose 表格/详情/JSON 三态），0 显示 "-"
④ `xceadmin extres status`
- 本机读 status 文件（远程读取留待 PR-2，需新 wire 协议；LAST_UPDATED
已覆盖远程新鲜度语义）——--status-file 显式路径或
/var/run/xce/esd-status.json 默认，无 controller 连接依赖
- XceExtresStatusError 本地文件类错误；click default=None 装饰期冻结坑
用调用期解析
TDD：test_extres_resvals +2（配置树盖戳/非 EXTERNAL 不盖戳）、test_esd_core
+4（stale 判式/状态文件）、apiserver models +2（默认列/json tag）、backend
integration +2（EXTERNAL 刷新/非 EXTERNAL 不刷新）、xceadmin +11（渲染/
本地读/容错）。全绿：controller 1360、scheduler 100、apiserver（cgo+nocgo）、
esd 11、xceadmin 385。
t1 E2E 实证：esd join 即推送→API last_report=join 时刻→CLI LAST_UPDATED
"Oct 27 13:52"；破坏采集器后 60s 过限转 per-round STALE WARN + status
stale:true + fail-open 保值，恢复脚本即回 false；liccheck 作业提交→运行→
DONE，五 daemon 全健康。
Co-Authored-By: Claude Code <noreply@anthropic.com>