第 4 章 集群更新故障排除
4.1. 收集集群更新的数据 复制链接链接已复制到粘贴板!
当联系红帽支持以获取更新时,务必要为支持团队提供数据,以便对失败的集群更新进行故障排除。
4.1.1. 为支持问题单收集日志数据 复制链接链接已复制到粘贴板!
要从集群收集数据,包括日志数据,请使用 oc adm must-gather
命令。请参阅收集有关集群的数据。
4.1.2. 使用 oc adm upgrade status 收集集群更新状态(技术预览) 复制链接链接已复制到粘贴板!
在更新集群时,了解您更新的过程会很有用。oc adm upgrade
命令返回有关更新状态的有限信息,在这个版本引入了 oc adm upgrade status
命令作为一个技术预览功能。这个命令将状态信息与 oc adm upgrade
命令分离,并提供集群更新的具体信息,包括 control plane 和 worker 节点更新的状态。
oc adm upgrade status
命令是只读的,它永远不会更改集群中的任何状态。
oc adm upgrade status
命令只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议(SLA)支持,且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能,并有机会在开发阶段提供反馈意见。
有关红帽技术预览功能支持范围的更多信息,请参阅技术预览功能支持范围。
oc adm upgrade status
命令可用于从 4.12 版本到最新支持的发行版本的集群。
虽然您的集群不需要是一个启用了技术预览的集群,但您需要启用 OC_ENABLE_CMD_UPGRADE_STATUS
技术预览环境变量,否则 OpenShift CLI (oc
) 将无法识别该命令,导致您无法使用该功能。
流程
运行以下命令,将
OC_ENABLE_CMD_UPGRADE_STATUS
环境变量设置为true
:export OC_ENABLE_CMD_UPGRADE_STATUS=true
$ export OC_ENABLE_CMD_UPGRADE_STATUS=true
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 运行
oc adm upgrade status
命令:oc adm upgrade status
$ oc adm upgrade status
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 例 4.1. 成功更新进度的输出示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 通过这些信息,您可以对如何进行更新做出明智的决策。
4.1.3. 收集 ClusterVersion 历史记录 复制链接链接已复制到粘贴板!
Cluster Version Operator (CVO) 记录对集群所做的更新,称为 ClusterVersion 历史记录。条目可以显示与潜在的触发器的集群行为更改之间的关联,尽管关联并不意味着会造成问题。
初始、次版本和 z-stream 版本更新由 ClusterVersion 历史记录存储。但是 ClusterVersion 历史记录有大小限制。如果达到了限制,则会修剪之前次版本中最旧的 z-stream 更新以满足限制。
您可以使用 OpenShift Container Platform Web 控制台或使用 OpenShift CLI (oc
) 查看 ClusterVersion 历史记录。
您可以在 OpenShift Container Platform Web 控制台中查看 ClusterVersion 历史记录。
先决条件
-
您可以使用具有
cluster-admin
角色的用户访问集群。 - 访问 OpenShift Container Platform web 控制台。
流程
-
在 web 控制台中点击 Administration
Cluster Settings 并查看 Details 选项卡中的内容。
4.1.3.2. 使用 OpenShift CLI 收集 ClusterVersion 历史记录 (oc) 复制链接链接已复制到粘贴板!
您可以使用 OpenShift CLI (oc
) 查看 ClusterVersion 历史记录。
先决条件
-
您可以使用具有
cluster-admin
角色的用户访问集群。 -
已安装 OpenShift CLI(
oc
)。
流程
输入以下命令查看集群更新历史记录:
oc describe clusterversions/version
$ oc describe clusterversions/version
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 输出示例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow