10.5. 集群验证

10.5.1. 使用 REST API 获取集群验证

注意：如果您使用基于 Web 的 UI，则其中许多验证不会按名称显示。要获取与标签一致的验证列表，请使用以下步骤。

先决条件

  • 已安装 jq 工具。
  • 您已使用 API 创建基础架构环境，或使用 UI 创建集群。
  • 在 shell 中以 CLUSTER_ID 的形式导出集群 ID。
  • 您在访问 API 时具有凭证，并在 shell 中导出令牌作为 API_TOKEN。

流程

  1. 刷新 API 令牌： 

    $ source refresh-token

  2. 获取所有集群验证： 

    $ curl \
  --silent \
  --header "Authorization: Bearer $API_TOKEN" \
  https://api.openshift.com/api/assisted-install/v2/clusters/$CLUSTER_ID \
  | jq -r .validations_info \
  | jq 'map(.[])'

  3. 获取非传递集群验证： 

    $ curl \
  --silent \
  --header "Authorization: Bearer $API_TOKEN" \
  https://api.openshift.com/api/assisted-install/v2/clusters/$CLUSTER_ID \
  | jq -r .validations_info \
  | jq '. | map(.[] | select(.status=="failure" or .status=="pending")) | select(length>0)'

10.5.2. 详细集群验证

参数验证类型描述

machine-cidr-defined

非阻塞

检查集群是否存在机器网络定义。

cluster-cidr-defined

非阻塞

检查集群是否存在集群网络定义。

service-cidr-defined

非阻塞

检查集群是否存在服务网络定义。

no-cidrs-overlapping

Blocking

检查定义的网络是否不重叠。

networks-same-address-families

Blocking

检查定义的网络是否共享相同的地址系列(valid 地址系列为 IPv4、IPv6)

network-prefix-valid

Blocking

检查集群网络前缀，以确保其有效，并为所有主机有足够的地址空间。

machine-cidr-equals-to-calculated-cidr

Blocking

对于非用户管理的网络集群。检查 apiVIPs 或 ingressVIPs 是否是机器 CIDR 的成员（如果存在）。

api-vips-defined

非阻塞

对于非用户管理的网络集群。检查 apiVIPs 是否存在。

api-vips-valid

Blocking

对于非用户管理的网络集群。检查 apiVIPs 是否属于机器 CIDR，且没有使用。

ingress-vips-defined

Blocking

对于非用户管理的网络集群。检查 ingressVIPs 是否存在。

ingress-vips-valid

非阻塞

对于非用户管理的网络集群。检查 ingressVIPs 是否属于机器 CIDR，且没有使用。

all-hosts-are-ready-to-install

Blocking

检查集群中的所有主机是否处于 "ready to install" 状态。

sufficient-masters-count

Blocking

此验证只适用于多节点集群。

  • 集群必须有三个 master。
  • 如果集群有 worker 节点，则至少必须存在 2 个 worker 节点。

dns-domain-defined

非阻塞

检查集群是否存在基本 DNS 域。

pull-secret-set

非阻塞

检查 pull secret 是否存在。不检查 pull secret 是否有效或授权。

ntp-server-configured

Blocking

检查每个主机时钟都不超过 4 分钟，相互同步。

lso-requirements-satisfied

Blocking

验证集群是否满足 Local Storage Operator 的要求。

odf-requirements-satisfied

Blocking

验证集群是否满足 Openshift Data Foundation Operator 的要求。

  • 集群至少有 3 个主机。
  • 集群只有 3 个 master 或至少 3 个 worker。
  • 集群有 3 个有资格的磁盘，每个主机都必须有合格的磁盘。

cnv-requirements-satisfied

Blocking

验证集群是否满足容器原生虚拟化的要求。

  • 集群的 CPU 架构是 x86

lvm-requirements-satisfied

Blocking

验证集群是否满足逻辑卷管理器 Operator 的要求。

  • 集群必须是单一节点。
  • 集群必须运行 Openshift >= 4.11.0。

network-type-valid

Blocking

检查网络类型的有效性（如果存在）。

  • 网络类型必须是 OpenshiftSDN 或 OVNKubernetes。
  • OpenShiftSDN 不支持 IPv6 或单节点 Openshift。
  • OVNKubernetes 不支持 VIP DHCP 分配。