涵盖预览环境的验证、可观测性、发布控制、回滚、灾难处理和运营所有权。它修正了采用边界和可观察的失败证据,同时保持环境特定限制的可配置性。
包状态: 参考上下文已准备好供人工审查。合同和测试场景已完成,但不保证采用的实现已通过它们。
决策
对于预览环境,采用通过受控环境推广的不可变工件摘要。通过命名信号、有界容量、专属警报、诊断运行手册和经过测试的恢复证据来操作该能力。此包为参考合同:采用团队必须根据自身环境中的证据选择数值限制、提供商、管辖区和运营所有者。
范围
- 由此运营模块描述的预览环境参与者、输入、输出、状态、策略或模式版本及外部可见结果。
- 主要和备用接口、后台工作、缓存、集成、支持路径以及可行使相同边界的证据。
- 安全应用参考所需的采用特定配置、发布、恢复和验证职责。
本模块之外
- 为所有采用者选择通用供应商、框架、管辖区、数值阈值、保留期或服务级别目标。
- 声称已针对下游实现运行打包场景,或该参考授予法律、安全或无障碍认证。
合同
- 一次构建,通过摘要识别,附加来源信息,推广相同经过验证的工件,而非每个环境重建。
- 将密钥和环境配置保留在镜像之外,将部署凭据范围限制到最小目标和操作。
- 在风险需要时,基于可复现检查和明确批准来门控推广;保留谁推广了什么及原因。
- 在部署开始前定义回滚或向前滚动触发器、兼容窗口和数据迁移行为。
- 定义正常、降级、耗尽和不可用状态,包含决策指标和明确的操作员操作。
- 在故障切换、重放、回滚和修复期间保持已接受工作的身份,确保恢复不会重复或悄然丢失效果。
- 从隔离的临时凭据和合成或批准数据创建预览,包含所有者、源修订、过期和成本边界。
- 入站访问、出站效果、Webhook、电子邮件和支付调用默认采用安全沙箱行为。
实施指导
- 在代表性环境中演练运行手册,记录恢复时间、数据丢失边界和未解决假设。
- 在选择框架或供应商细节前,建模预览环境的输入、输出、参与者、状态、不变量、副作用和证据。
- 将适用的预览环境合同或策略版本与重要状态一起存储,以便迁移、重放和支持决策可追溯。
- 引入受控发布背后的路径,比较预期与观察结果,并保持经过测试的恢复路径,直至采用证据完整。
失败处理与保障措施
- 健康门失败会停止推广,并保留先前可运行版本及恢复所需证据。
- 无效或矛盾的预览环境状态被拒绝或隔离;实现绝不猜测会扩大权限或重复效果的值。
- 重试有界且使用持久身份;耗尽后,工作进入可检查的终态并有责任所有者。
验证与运营
- 注入饱和、依赖故障、过期配置和遥测丢失,确认声明的降级行为。
- 监控预览环境的成功、拒绝、验证失败、依赖失败、重试耗尽和按合同版本恢复情况,不含敏感负载维度。
- 在策略、模式、依赖、迁移或边界变更后,重新运行正负配对夹具并保留结果证据。
采用假设
- 示例中的名称和值为具体夹具,不是通用默认;采用者通过文档化证据和所有权替换它们。
- 采用系统能提供认证身份、持久操作或记录版本、有界遥测和受控变更路径。
本包中看似可执行的示例为夹具和验收合同。运行集合验证器检查结构和元数据,然后在目标仓库中翻译并执行场景,最后记录实现证据。
参考资料
- SLSA 规范 1.2(自 2026-09-08 起适用)
- 开放容器倡议镜像格式规范