已关闭
【安装部署文档】补充安装成功回显示例与集群信息滚动完成判定标准 #298
lihangyu创建于  9月6日关闭于  28 天前
lihangyu
lihangyu成员
9月6日 创建

环境信息/ Environment

openFuyao 安装部署文档(docs/zh 及 en 镜像)

问题简述/ Brief Description

快速入门与管理面安装业务集群文档缺少安装成功的明确回显标志,用户只能人工观察 Pod 状态判断安装是否完成,无法确认"集群信息滚动完成"的判定标准。

问题详情&复现步骤 / Details & Reproduction Steps

  1. docs/zh/quick_start/quick_start.md 已写"所有 Pod 状态都为 Running 或 Completed 则安装完毕",但全文无任何成功回显/日志标志示例(如 bke init 成功结束日志行、kubectl get pod -A 输出节选)。
  2. docs/zh/cluster_installation_guide/service_cluster_installation/service_cluster_installation_on_the_management_plane.md 安装步骤第 7 步:"界面弹出集群信息窗口。待集群信息滚动完成后,返回集群列表界面"——没有滚动完成的判定标准(看什么信号、大约耗时多久),用户无法判断是卡住还是已完成。

处理建议/ Suggested Fix

  1. quick_start.md 4.2 与「2. 安装业务集群」处补成功回显示例:bke init 成功结束日志行 + kubectl get pod -A 输出节选。
  2. 管理面 Web 安装篇第 7 步补滚动完成判定标准(窗口内所有组件项状态均为成功且不再刷新 + 参考耗时)。
  3. en 镜像同步修改。

期望结果/ Expected Results

用户可依据文档中的成功标志/回显自行判断引导节点与业务集群安装是否完成。

实际结果/Actual Results

文档无成功回显示例;管理面安装业务集群的滚动完成无判定标准。

likedislike
openFuyao-botopenFuyao-bot成员
9月6日 添加了label:sig/sig-Installation
openFuyao-bot
openFuyao-bot成员
9月6日 评论:

欢迎来到 openFuyao 社区

Hey @piamposer-li , 感谢你对社区的贡献.

机器人使用手册

有关指令的使用,可以点击 此处 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。您可以自助配置此仓库的 PR 合并规则,更多详情,请参阅此处。

联系指引

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

likedislike
lihangyulihangyu成员
9月8日 关联了pull request:fix(docs): add install success log markers and cluster info scroll criteria
lihangyu
lihangyu成员
9月8日 评论:

修复已提交:PR #234(fix(docs): add install success log markers and cluster info scroll criteria)

已交付:

  1. quick_start.md(zh/en)补充 bke init 成功结束日志行 BKE initialization is complete(佐证:bkeadm pkg/initialize/initialize.go:163)。
  2. 业务集群安装补充成功/失败判定日志行:Reason: ClusterReady, Message: cluster is ready / Reason: ClusterDeployFailed(佐证:cluster-api-provider-bke ensure_cluster.go:397、phase_flow.go:508)。
  3. 管理面安装篇第 7 步(zh/en)补充"集群信息"窗口滚动完成判定标准:出现 ClusterReady 成功日志行且不再滚动新日志即安装成功;出现 ClusterDeployFailed 日志行即安装失败。事件经 installer-service websocket 以 "Reason: %s, Message: %s" 格式推送、finish 事件后停止滚动,文档判定标准与实现行为一致。

待补充(需实测环境采集,暂不虚构):

  • kubectl get pod -A 输出节选示例
  • 滚动/安装参考耗时数值

以上两项待取得实测环境数据后补充。

likedislike
lihangyulihangyu成员
28 天前 关联了看板:openFuyao - v26.09问题单
lihangyulihangyu成员
28 天前 关联了里程碑:v26.09
lihangyulihangyu成员
28 天前 issue状态由 开启 改变为 待测试
lihangyulihangyu成员
28 天前 issue状态由 待测试 改变为 已完成
lihangyulihangyu成员
28 天前 关闭了 issue