已合并
docs(preflight): add unified preflight design #210
docs(preflight): add unified preflight design #210
已合并
thyzfmh创建于 7月29日
thyzfmh成员
7月29日

变更内容

本 PR 将统一前置检查设计收敛为 4 份文档,并与 bkeadm PR #358 的当前实现保持一致:

  • openFuyao统一前置检查提案.md:全局用法、边界、架构、规则、报告和退出码。
  • init阶段检查项提案.md:init 输入、检查项、依赖、采集和修复建议。
  • cluster-create阶段检查项提案.md:cluster-create 输入、检查项、management/SSH DAG 和修复建议。
  • 校验框架SDK提案.md:通用 SDK DTO、Adapter/Collector 契约、DAG、类型、安全和报告。

已删除独立的 preflight-bundle-gen提案.md 及其他文档中的相关链接和发布生成流程描述。

当前设计边界

  • 只支持 bke preflight init、bke preflight cluster-create,不覆盖 build、Web 或安装执行。
  • configs/preflight/preflight.yaml 是唯一面向用户的策略文件;二进制只嵌入默认策略。
  • SDK 运行所需 Bundle 由 bke 在进程内构造和校验,不再维护落盘的 preflight-bundle.yaml、release-input/ 或独立生成器。
  • 可通过 --preflight-config 加载完整外部策略,但不能替换规则 ID、Collector 和来源证据。
  • 只做有明确 BKE/Provider/安装要求来源的检查,不重新纳入历史泛化检查。
  • fake collector 测试不作为真实 CLI/SSH/Kubernetes E2E;真实环境证据单独记录。

用户文档

  • 中英文 before_you_start.md 增加运行 preflight 的安装前建议。
  • 中英文 command_reference.md 增加命令、参数、报告、退出码和只读边界。
  • 中英文环境预检查工具指南说明新的 bke preflight 与历史 envCheck 的能力边界。

校验

  • 设计目录仅保留上述 4 份文件。
  • 已确认无 preflight-bundle-gen、release-input、落盘 Bundle 生成/校验链路残留引用。
  • git diff --check 通过;实现验证和证据边界以 bkeadm PR #358 为准。
likedislike
Pull Request已成功合入, 合并人@openFuyao-bot
(感谢 thyzfmh 的贡献)
openFuyao-botopenFuyao-bot成员
7月29日 添加了label:sig/sig-Installation
openFuyao-bot
openFuyao-bot成员
7月29日 评论:

欢迎来到 openFuyao 社区

Hey @thyzfmh , 感谢你对社区的贡献.

机器人使用手册

有关指令的使用,可以点击 此处 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。

联系指引

有疑问可以联系 SIG: sig-Installation ,
维护者是: @foxbit, @javadoors, @regandy, @xuyouhong, @zqw1 ,
审核者是: @piamposer-li .

likedislike
openFuyao-botopenFuyao-bot成员
7月29日 添加了label:openFuyao-cla/no
openFuyao-botopenFuyao-bot成员
7月29日 添加了label:ci-running
openFuyao-botopenFuyao-bot成员
7月29日 删除了label:ci-running
此处折叠了136条消息 查看更多
openFuyao-botopenFuyao-bot成员
22 天前 添加了label:ci-successful
lihangyu
lihangyu成员
22 天前 评论:

/lgtm
/approve

likedislike
openFuyao-botopenFuyao-bot成员
22 天前 添加了label:lgtmapproved
openFuyao-bot
openFuyao-bot成员
22 天前 评论:

  • 标签 lgtm, approved 已被添加. 这意味着 piamposer-li 已经检查过代码了. 👋
Tips
  • 如果PR还没有被合入, 请评论 /check-pr 进行检查. 😄
likedislike
openFuyao-botopenFuyao-bot成员
22 天前 合入了pull request,合并节点 SHA:472d097ba3223215cc8c76b5404c9862e9c611a1