Pulse 受管控的 Docker 容器重启:Operational Trust 治理动作的资格投影、审批执行与验证边界

原创2026-10-10 23:58:031,724 阅读
文章标签:可观测性运维后端

Pulse 受管控的 Docker 容器重启:Operational Trust 治理动作的资格投影、审批执行与验证边界

导读

本文围绕 Pulse 中 Operational Trust(运营信任)Phase 5 的落地记录 docs/release-control/v6/internal/records/operational-trust-governed-docker-restart-2026-07-19.md,完整讲解第一个受治理的变异动作——Docker 容器 restart。它只从规范的 docker-container-health 运营记录(operational record)中提供,具备严格的 fail-closed 资格门槛、共享动作审批生命周期、幂等执行与"执行≠恢复"的验证边界。读完本文,你将掌握:Pulse 如何把一次容器重启安全地投影进现有动作框架(而不是新建 Patrol 本地执行器)、如何通过证据信封(evidence envelope)逐项把关资格、如何用后置条件(postcondition)读回区分"动作成功"与"问题解决",以及对应后端、前端与浏览器测试矩阵的验证方式。

背景:Operational Trust 与第一个受治理的变异动作

Pulse 的 Operational Trust 目标是把产品变成混合私有基础设施的"可信运营层",其实现回路是 observe -> identify -> detect -> relate -> explain -> act -> verify(实施规范)。整个目标被拆成 Phase 0~Phase 6,本文所依据的记录属于 Phase 5:受治理动作与验证(governed actions and verification),候选人(candidate)为 protection-posture-attention-queue。

Phase 5 的选择刻意最小化:第一个 Operational Trust 变异动作就是已声明的 Docker 容器 restart 能力,并且只从规范的 docker-container-health 运营记录中提供。这条记录同时确立了三条产品铁律:

  1. 不新建 Patrol 本地执行器:注意力界面(attention surface)只负责把资格投影进现有的动作生命周期,审批、执行、审计、回执(receipt)与验证全部由共享的 Actions review 接管。
  2. 动作来源可追溯:动作的 origin 精确绑定到对应的运营记录 ID 与证据 ID 集合。
  3. 幂等重放:稳定的请求 ID 由记录与能力共同派生,重复的规划与执行会重放同一条持久动作,而不是把变异动作发送两次。

选择这个能力的公开背景是 Docker 容器重启诉求(issue #1034),而另外两个公开问题分别说明了设计约束的由来:#1564 表明"provider 变异成功 ≠ 服务已恢复",#1586 表明"执行器当前就绪性与授权必须在提供动作前实时核对"。因此该能力被有意做得比 update/recreate、包缓存清理或宽泛的自主修复更小,直接套用已声明的能力、审批、投递、回执与验证契约。

资格门槛:五项同时成立才 fail-closed 通过

记录明确:除非下列所有条件同时保持为真,否则该动作拒绝提供(fails closed):

  1. 生命周期记录处于 open 或 acknowledged——已解决、已抑制、陈旧或未知状态的记录不再提供动作;
  2. 每一份贡献的证据信封都是 fresh、complete、confirmed、权限充足,且无歧义地绑定到同一个规范容器——任何一份证据过期、不完整、未确认、权限受限或主体不匹配都会否决;
  3. 当前统一资源(unified resource)仍声明精确的 restart 能力、admin 审批下限与 Docker 生命周期处理器——能力注册表是动作存在的唯一来源;
  4. 实时执行器报告该能力就绪——执行器掉线、拒绝或就绪状态不可验证都不提供动作;
  5. 当前操作者可以对该动作执行 plan、approve 与 execute——权限在提供时与执行时双重检查。

这些门槛在源码 internal/ai/attention_actions.go 中被逐一实现为可枚举的资格原因(AttentionActionEligibilityReason),包括:

资格原因常量 含义
unsupported_condition 非 Docker 健康类注意力项或非应用容器主体
lifecycle_inactive 记录不在 open / acknowledged 状态
evidence_missing / evidence_stale / evidence_incomplete / evidence_unconfirmed / evidence_permission_limited 证据缺失、过期、不完整、未确认、权限不足
evidence_subject_mismatch 证据主体与注意力项主体不一致,或身份关联存在歧义(候选数 ≠ 1)
resource_unavailable 规范资源缺失或与主体 ID 不匹配
capability_unavailable 资源不再声明 restart 能力、docker.container.lifecycle 处理器或 admin 审批下限
execution_unavailable 实时执行器不可用或能力未就绪
operator_unauthorized 当前操作者无 plan/approve/execute 权限

单元测试 attention_actions_test.go 对上述每一条否决原因都有独立用例(stale evidence、partial evidence、permission limited、ambiguous subject、capability missing、executor refused、executor readiness missing、operator unauthorized),并用 offer.Capability == "" 断言"不得返回任何动作"。这正是"未知、陈旧、不完整或歧义证据对变异动作必须 fail-closed"这一规范原则的落地。

验证边界:执行成功不等于运营问题解决

记录中最关键的诚实性设计是验证边界(Verification Boundary):

  • Docker 执行器在 provider 接受重启后执行其既有的类型化读回(typed readback);这次读回可以确认或反驳动作的后置条件,其信任类别(agent-attested / independently observed)保持可见。
  • 但成功的命令或已确认的运行态读回,都不会关闭运营问题。
  • 只有之后由检测器(detector)拥有、且新鲜的健康观察,才允许把规范的运营记录转为 resolved。

因此 Patrol 详情页对注意力项区分四种状态:

状态 含义
pending execution or verification 等待执行或验证
confirmed restart postcondition 重启后置条件已确认,问题仍开放
contradicted postcondition 后置条件被反驳,问题仍开放
inconclusive verification 验证无定论,问题仍开放

此外,provider 超时、回调丢失与服务器重启都会保留持久化的投递尝试(durable dispatch attempt),并协调一条相关联的回执(correlated receipt),而不会重新投递。源码层面,attention_actions.go 的 AttentionActionVerificationState 把动作审计记录映射为五档验证语义:pending(planned/pending/approved/executing)、not_available(rejected/expired)、succeeded(confirmed)、failed(contradicted 或执行失败)、unknown(inconclusive / not attempted);对应测试 TestAttentionActionVerificationStatePreservesExecutionAndPostconditionTruth 逐一验证了 executing→pending、confirmed→succeeded、contradicted→failed、inconclusive→unknown 的映射。

这与 Docker Engine API 的语义一致:restart 是"窄的、容器作用域的 provider 操作",其响应只代表传输层/provider 接受,并不代表应用健康;因此 Pulse 用独立的 inspect/event 状态作为读回边界,而不是把 restart 响应当作验证。Kubernetes probes 也做同样的区分:容器生命周期状态 ≠ 就绪 ≠ 工作负载健康。

用户视角:一次导航、一个动作、诚实验证

记录为操作者定义了明确的工作(job):

这个容器不健康。请把 Pulse 唯一能安全执行的那个动作给我看,在我发出任何东西之前让我先审查它,并且告诉我它到底有没有生效——不要假装原来的健康问题已经修复。

现场可重复的确定性演练(live deterministic exercise):

  1. 从 monitor-first shell 打开 Patrol;
  2. 选中不健康的 API 容器;
  3. 在选中项详情中阅读影响、新鲜证据姿态、有界重启后置条件与显式审批边界;
  4. 打开共享的受治理动作审查(governed-action review);
  5. 展开规划时(planning-time)的策略证据;
  6. 审批,进行第二次有意的 Run 动作,然后关闭审查;
  7. 在仍然开放的运营问题旁边,阅读"已确认"或"已反驳"的验证结果。

"答案的距离"(distance to the answer)是:一次 Patrol 导航 + 一次条目选择 + 一次动作审查。默认队列不携带变异按钮;选中详情里只有一个有界动作;而精确的策略、审批、投递与验证取证都保留在共享审查中。

记录还对界面元素给出了明确的 keep / demote / cut 判定:

  • 保留:选中问题旁边的一个合格安全动作;打开审查前的预期后置条件与审批警告;动作之后执行与验证真相的显式区分;
  • 降级(demote):策略权威、精确审计身份、投递回执与原始验证证据——全部收进共享审查;
  • 删除(cut):陈旧、部分、权限受限、歧义、不支持或当前不可用证据对应的动作;把 provider 成功当作运营恢复的同义词;重复的执行控件与任何 Patrol 本地动作生命周期。

词汇表(Vocabulary)也被明确定义,用来对齐产品文案:

  • Review and approve:陈述操作者的下一个决策;
  • Review action:计划已存在后打开持久历史;
  • Postcondition confirmed:只说明该动作证明了什么,不说服务已健康;
  • Issue stays open until fresh health evidence:解释为什么队列项仍然存在。

判定结论:product(非 prototype)——流程有界、审慎、可审计、响应式、可键盘操作,且对"验证失败"和"检测器拥有的独立恢复边界"都保持诚实。前端实现中,PatrolAttentionWorkbench.tsx 对应展示了 expectedPostcondition、确认/反驳文案("The action postcondition was confirmed. This issue stays open until fresh health evidence confirms recovery." / "The action did not satisfy its postcondition. The issue remains open.")。

源码实现:纯资格投影与有界动作提供

internal/ai/attention_actions.go 是资格与提供投影(offer projection)的纯逻辑所有者,入口函数 ProjectAttentionAction(detail, candidate, now) 依次执行:

  1. 若已存在 origin 绑定的持久动作且 AttentionActionMatchesItem 通过(记录 ID、规范资源 ID、能力名三要素匹配),则直接重放该动作的提供(含其固化证据 ID 与审批状态),实现"重复规划与执行重放同一条持久动作";
  2. 检查类型与生命周期状态(docker-container-health + app-container + open/acknowledged);
  3. 逐信封检查证据的新鲜度(FreshnessAt(now))、完整性、置信度、权限与主体绑定;
  4. 核对统一资源声明的 restart 能力、docker.container.lifecycle 处理器与 admin 审批下限;
  5. 核对执行器就绪(Readiness.Available 且名字为 restart);
  6. 核对操作者授权。

通过后生成的提供(AttentionActionOffer)是有界、零参数的:

TargetResourceID:      item.SubjectResourceID,
Capability:            "restart",
Kind:                  "container_restart",
Label:                 "Restart this container",
Mode:                  "plan",
Risk:                  "low",
Approval:              "required",
Eligibility:           "eligible",
Reasons:               []string{"fresh_confirmed_unhealthy_container", "declared_live_capability"},
ExpectedPostcondition: "The same container is observed running after the restart.",
VerificationPolicy:    "Pulse requires a fresh container readback and records whether it is agent-attested or independently observed.",
RequiresApproval:      true,

ActionOrigin 采用加性(additive)设计:携带 operationalRecordId 以及排序、去重后的 evidenceIds(uniqueSortedAttentionEvidenceIDs 保证稳定顺序)。请求 ID 由记录与能力派生:"operational-trust:" + operationalRecordID + ":restart",这正是幂等重放的锚点。

API 契约:固定路由、零参数、执行前重新把关

internal/api/attention_actions.go 提供唯一的规划端点:

POST /api/ai/patrol/attention/{id}/actions/restart/plan

其行为约束与源码一一对应:

  • 客户端只能请求固定的零参数 plan:浏览器调用 patrolAttention.ts 中的 planPatrolAttentionAction(itemId, capability),POST body 恒为 {};客户端无法提供 origin、target、evidence IDs、handler、actor 或 authority。路径解析函数 parseAttentionActionPlanPath 只接受 /{item}/{capability}/plan 两段形式,并对 item ID 做 URL 解码以兼容含 / 的记录 ID。
  • 规划即重把关:handleAttentionActionPlan 在调用规范动作生命周期(ActionLifecycle().PlanWithOptions)之前,重新执行完整投影(projectAttentionActions),实时检查生命周期证据、资源能力、执行器就绪与操作者权限(plan/approve/execute 三者都要求授权)。
  • mock 模式拒绝:启用 mock 时返回 403 attention_action_mock_mode,防止伪执行。
  • 许可证门槛:Patrol 修复动作要求 Pulse Pro(WriteLicenseRequired(featureAIAutoFixKey, ...))。
  • 共享生命周期唯一:规划产出交给现有 ActionLifecycle().PlanWithOptions,审批走既有 action decision 路由,执行走既有 execute 路由,详情由 ActionReviewDialog 呈现——Patrol 不复制任何动作生命周期。

API 层还按三种列表场景区分负载:List 的分页后富化(enrichment after pagination)、Detail 只富化选中项、Summary 不做任何动作富化。同时,只有已存在 origin 绑定动作且匹配时,才把持久动作的 ActionID 与审批状态注入提供,从而让"审查中的动作"与"全新计划的动作"在 UI 上可区分。

存储层:按运营记录的批次"最新动作"查询

internal/unifiedresources/store.go 实现了 OperationalActionAuditOriginBatchReader 接口,Memory 与 SQLite 两种存储都暴露按运营记录查最新动作的批次能力:

  • SQLite 端(SQLiteResourceStore.GetLatestActionAuditsByOperationalRecords)对 action_audits 表做基于 JSON origin 的索引查询(json_valid(origin_json) + json_extract(origin_json, '$.surface') + json_extract(origin_json, '$.operationalRecordId') IN (...)),按 updated_at DESC, created_at DESC 排序后取每个记录的最新一条;
  • 批次上限 200 条记录:len(ids) > 200 直接报错,防止无界查询;一份 200 条记录的批次就是一次 store 读("a 200-record batch is one store read"),符合规范中"不得逐行 fetch、Patrol 列表读不得扫描无界历史"的性能要求。

这解释了运行时记录中的表述:"Memory and SQLite stores expose bounded latest-action lookup by operational record. SQLite uses an indexed JSON-origin query; a 200-record batch is one store read."

前端与浏览器旅程:单一执行请求与诚实验证文案

浏览器客户端通过 ActionReviewDialog(ActionReviewDialog.tsx)完成唯一的审批与执行生命周期。规划时它校验 reviewedPlanHash(计划哈希)防止会话内参数被篡改,提供 "Approve → Run action" 两次刻意操作;执行按钮在 Run 后消失,确保恰好一次 execute 请求。

Playwright 用例 tests/integration/tests/91-operational-trust-attention-workbench.spec.ts 是这份记录的直接证据,其 mock 场景完整复刻了真实契约:

  • 注意力项 docker-container-health、动作提供 container_restart、origin operational_trust_attention、请求 ID operational-trust:{record}:restart;
  • 规划返回 pending_approval 的审计(plan 含 approvalPolicy: "admin"、quorum: 1、predictedBlastRadius、rollbackAvailable: false、planHash、策略权威 capability_registry);
  • 执行审计的结果采用 v2 结构:execution.status: succeeded、verification.status: confirmed|contradicted、evidenceClass: agent_attested、compensation.support: unavailable(明确"容器重启不可回滚");
  • 回执(receipt)与投递尝试({id}.dispatch.1)体现"持久投递尝试 + 关联回执、不重发"。

用例针对 confirmed 与 contradicted 两种验证结果各跑一遍完整旅程,断言包括:详情展示预期后置条件与"显式审查与审批"警告;审查对话框中展开"Policy evidence"并看到"Eligible for low-risk automation";Approve 后出现 Run action、执行后按钮消失;executeCalls() 恰好为 1;确认场景显示"restart postcondition was confirmed / issue stays open until fresh health evidence",反驳场景显示"restart did not satisfy its postcondition / issue remains open";反驳场景还在 390px 视口 + reduced-motion 下断言无文档横向溢出。这正是记录所述"五个旅程矩阵"中受治理动作部分的核心:策略披露、审批、恰好一次执行请求、确认/反驳验证文案、仍开放的生命周期真相、焦点恢复、屏幕阅读器命名、窄屏布局与减少动画。

验证命令与测试矩阵

记录给出了三组可复现的验证命令:

后端契约与集成测试(覆盖每个 fail-closed 资格原因、origin/evidence 绑定、含斜杠记录 ID、计划重放、审批、恰好一次执行、确认与反驳验证、动作后不自动解析、新鲜检测器恢复、发送后超时、关联迟到回执、SQLite 重启协调不重发):

go test ./internal/actionlifecycle ./internal/actionplanner \
  ./internal/unifiedresources ./internal/ai ./internal/api -count=1

前端类型检查、组件测试与 lint:

npm run type-check
npm run test -- \
  src/features/patrol/__tests__/PatrolAttentionWorkbench.test.tsx \
  src/features/actions/__tests__/ActionReviewDialog.test.tsx
npx eslint \
  src/api/patrolAttention.ts \
  src/features/patrol/PatrolAttentionWorkbench.tsx \
  src/features/patrol/__tests__/PatrolAttentionWorkbench.test.tsx

浏览器旅程(桌面与移动双项目):

PLAYWRIGHT_BASE_URL=http://127.0.0.1:5173 \
  npx playwright test \
  tests/91-operational-trust-attention-workbench.spec.ts \
  --project=chromium

PLAYWRIGHT_BASE_URL=http://127.0.0.1:5173 \
  npx playwright test \
  tests/91-operational-trust-attention-workbench.spec.ts \
  --project=mobile-chrome

记录声明两组五旅程矩阵均通过。组件测试 PatrolAttentionWorkbench.test.tsx 中 opens the canonical governed action review from an eligible attention item 用例亦复现了"点击 Review and approve → 调 planAction → 取动作 → 审查对话框"的完整链路。

范围边界与剩余工作

这份记录明确接受的范围与边界:

  • 本记录只验收 Phase 5,不关闭整体 Operational Trust 目标或主候选人;
  • 该能力有意小于 update/recreate、包缓存清理或宽泛的自主修复;它是首个落地的窄变异动作,直接回应公开诉求并套用既有能力、审批、投递、回执与验证契约;
  • Phase 6 仍持有全部收尾工作:完整兼容性、迁移、并发、故障、留存、负载、遥测、文档、升级以及最终的跨仓库治理矩阵,对应规范中全部十四条完成标准(completion criteria)的剩余部分。

从治理映射看,本记录服务于 status.json.lanes.L23(Monitor-first Patrol operations)与 L20(动作能力、审批、审计与验证)等主通道,并作为 protection-posture-attention-queue 候选在 Phase 5 验收后的运行时证据之一。整体规范还立了两条不可动摇的底线(direction captured):

Pulse v6 在每一个面向客户的活跃状态、证据解释、保护断言、通知后果与受治理动作都经由同一个无矛盾规范生命周期与证据模型解析之前,不算运营上可信。

只有当当前、足够完整、主体绑定的证据支撑该断言时,资源才能被称为 protected / healthy / resolved / action-eligible;否则 Pulse 必须展示限制性的陈旧、部分、歧义、失败或未知状态。

小结

从这份 Phase 5 记录与仓库源码可以看出,Pulse 的受管控 Docker 重启是一个"小而完整"的治理闭环:资格投影在 internal/ai/attention_actions.go 中纯函数式判定(十几种显式否决原因)、有界零参数提供;internal/api/attention_actions.go 把计划路由收敛到唯一端点并在执行前重新把关;存储层用 JSON-origin 批次查询做到 200 条记录一次读取;前端与浏览器测试则保证了"恰好一次执行请求、确认/反驳验证文案、问题保持开放直到新鲜健康证据"的诚实表达。它没有创建 Patrol 本地执行器,也没有把 provider 成功伪装成恢复——这正是 Operational Trust 所追求的"审慎、可审计、诚实"的动作语义。

登录后查看全文
Pulse