1.4. 使用多集群引擎 operator 的集群生命周期发行注记

当在带有托管 control plane 集群的 OpenShift Service 上安装 multicluster engine operator 时，安装状态可能会处于 Installing 状态。local-cluster 可能也处于 Unknown 状态。

当您检查 hub 集群上的 open-cluster-management-agent 命名空间中的 klusterlet-agent pod 日志时，您会看到类似如下的错误：

E0809 18:45:29.450874       1 reflector.go:147] k8s.io/client-go@v0.29.4/tools/cache/reflector.go:229: Failed to watch *v1.CertificateSigningRequest: failed to list *v1.CertificateSigningRequest: Get "https://api.xxx.openshiftapps.com:443/apis/certificates.k8s.io/v1/certificatesigningrequests?limit=500&resourceVersion=0": tls: failed to verify certificate: x509: certificate signed by unknown authority

要解决这个问题，请配置 hub 集群 API 服务器验证策略。完成以下步骤：

启用 managed-serviceaccount 附加组件时，ManagedClusterAddOn 资源中的 installNamespace 字段必须有 open-cluster-management-agent-addon 值。其他值将被忽略。managed-serviceaccount 附加组件代理总是在受管集群上的 open-cluster-management-agent-addon 命名空间中部署。

通过配置复制和粘贴功能来加快开发速度。要在 assisted-installer 中配置 copy-from-mac 功能，您必须将 mac-address 添加到 nmstate 定义接口和 mac-mapping 接口。mac-mapping 接口在 nmstate 定义接口之外提供。因此，您必须提供相同的 mac-address 两次。

如果您安装了不同版本的 VolSync，请将 v0.6.0 替换为您的安装版本。

删除 ManagedClusterSet 后，添加到每个受管集群的标签不会被自动删除。从已删除受管集群集中包含的每个受管集群手动删除该标签。该标签类似以下示例：cluster.open-cluster-management.io/clusterset:<ManagedClusterSet Name>。

如果您针对 ClusterPool 创建 Hive ClusterClaim 并手动将 ClusterClaimspec 生命周期字段设置为无效的 golang 时间值，则产品将停止实现并协调所有 ClusterClaims，而不仅仅是不正确的声明。

您在 clusterclaim-controller pod 日志中看到以下错误，这是带有 PoolName 和无效生命周期的 特定示例 ：

E0203 07:10:38.266841       1 reflector.go:138] sigs.k8s.io/controller-runtime/pkg/cache/internal/informers_map.go:224: Failed to watch *v1.ClusterClaim: failed to list *v1.ClusterClaim: v1.ClusterClaimList.Items: []v1.ClusterClaim: v1.ClusterClaim.v1.ClusterClaim.Spec: v1.ClusterClaimSpec.Lifetime: unmarshalerDecoder: time: unknown unit "w" in duration "1w", error found in #10 byte of ...|time":"1w"}},{"apiVe|..., bigger context ...|clusterPoolName":"policy-aas-hubs","lifetime":"1w"}},{"apiVersion":"hive.openshift.io/v1","kind":"Cl|...

您可以删除无效的声明。

如果删除了不正确的声明，则声明可以在不需要进一步交互的情况下再次成功进行协调。

clusterimageset 处于 fast 频道，但置备的集群处于 stable 频道。目前，产品不会将 频道 同步到置备的 OpenShift Container Platform 集群。

进入 OpenShift Container Platform 控制台中的正确频道。点 Administration > Cluster Settings > Details Channel。

使用控制台创建内部集群时，您必须为集群选择一个可用的子网。它没有标记为必填字段。

当满足以下条件时，配置为自动置备受管集群的 Automation 模板可能会失败：

您无法手动删除受管集群的命名空间。受管集群命名空间会在受管集群分离后自动删除。如果在分离受管集群前手动删除受管集群命名空间，受管集群会在删除受管集群后显示持续终止状态。要删除此正在终止的受管集群，请从分离的受管集群中手动删除终结器。

当您在云供应商一端更改云供应商访问密钥时，您还需要在 multicluster engine operator 的控制台中更新此云供应商的对应凭证。当凭证在托管受管集群的云供应商过期并尝试删除受管集群时，需要此项。

当销毁受管集群时，在一小时后仍然继续显示 Destroying 状态，且集群不会被销毁。要解决这个问题请完成以下步骤：

您不能使用 Red Hat Advanced Cluster Management 控制台升级 OpenShift Container Platform Dedicated 环境中的 OpenShift Container Platform 受管集群。

特定受管集群中特定资源的搜索详情页面可能会失败。在进行搜索前，您必须确保受管集群中的 work-manager 附加组件处于 Available 状态。

在 Red Hat Advanced Cluster Management 版本 2.10 及更新的版本中默认启用 ManagedServiceAccount 和集群代理附加组件。如果升级后禁用了附加组件，您必须手动启用 ManagedServiceAccount 和集群代理附加组件，以便在非 OpenShift Container Platform 受管集群上使用 pod 日志功能。

请参阅 ManagedServiceAccount 附加组件 以了解如何启用 ManagedServiceAccount 和使用集群代理附加组件 以了解如何启用集群代理附加组件。

当您在 OpenShift Container Platform 4.10.z 上使用集群范围代理配置创建托管服务集群时，nodeip-configuration.service 服务不会在 worker 节点上启动。

iPXE 是开源网络引导固件。如需了解更多详细信息，请参阅 iPXE。

引导节点时，一些 DHCP 服务器中的 URL 长度限制会关闭 InfraEnv 自定义资源定义中的 ipxeScript URL，从而导致在控制台中的以下错误消息：

no bootable devices

要临时解决这个问题，请完成以下步骤：

如果您在 Red Hat Advanced Cluster Management 2.6 中使用已删除的 BareMetalAssets API，则在升级到 Red Hat Advanced Cluster Management 2.7 后无法删除 ClusterDeployment，因为 BareMetalAssets API 绑定到 ClusterDeployment。

要临时解决这个问题，请在升级到 Red Hat Advanced Cluster Management 2.7 前运行以下命令来删除 finalizers：

oc patch clusterdeployment <clusterdeployment-name> -p '{"metadata":{"finalizers":null}}' --type=merge

聚合流是置备的默认过程。当您使用 Bare Metal Operator (BMO)将主机连接到 live ISO 时，Ironic Python 代理执行以下操作：

如果 Assisted Installer 代理启动缓慢，且部署受管集群，受管集群可能会处于 Pending 状态，且没有任何代理资源。您可以通过禁用聚合流来解决这个问题。

重要： 当您禁用聚合流时，只有 Assisted Installer 代理在 live ISO 中运行，减少打开的端口数量并禁用您在 Ironic Python 代理代理启用的任何功能，包括：

要决定要在不禁用聚合流的情况下启用或禁用哪些端口号，请参阅 网络配置。

要禁用聚合流，请完成以下步骤：

使用 Clustersets API 时不支持 selectorType: LaberSelector 设置。支持 selectorType: ExclusiveClusterSetLabel 设置。

当使用 ClusterCurator 资源升级 OpenShift Container Platform Dedicated 集群时，升级会失败，因为 Cluster curator 不支持 OpenShift Container Platform Dedicated 集群。

您可以在安装受管集群时使用 ClusterDeployment 资源指定自定义 ingress 域，但更改仅在使用 SyncSet 资源安装后才会生效。因此，clusterdeployment.yaml 文件中的 spec 字段显示您指定的自定义入口域，但 status 仍然会显示默认域。

如果您在 ManagedClusterAddon 中定义配置来覆盖 ClusterManagementAddon 中的一些配置，则 ManagedClusterAddon 可能会处于以下状态：

progressing... mca and work configs mismatch

当您检查 ManagedClusterAddon 状态时，配置的一部分有一个空的 spec 哈希，即使配置存在。请参见以下示例：

status:
  conditions:
  - lastTransitionTime: "2024-09-09T16:08:42Z"
    message: progressing... mca and work configs mismatch
    reason: Progressing
    status: "True"
    type: Progressing
...
  configReferences:
  - desiredConfig:
      name: deploy-config
      namespace: open-cluster-management-hub
      specHash: b81380f1f1a1920388d90859a5d51f5521cecd77752755ba05ece495f551ebd0
    group: addon.open-cluster-management.io
    lastObservedGeneration: 1
    name: deploy-config
    namespace: open-cluster-management-hub
    resource: addondeploymentconfigs
  - desiredConfig:
      name: cluster-proxy
      specHash: ""
    group: proxy.open-cluster-management.io
    lastObservedGeneration: 1
    name: cluster-proxy
    resource: managedproxyconfigurations

要解决这个问题，请运行以下命令来删除 ManagedClusterAddon，以重新安装并恢复 ManagedClusterAddon。将 <cluster-name& gt; 替换为 ManagedClusterAddon 命名空间。将 <addon-name& gt; 替换为 ManagedClusterAddon 名称：

oc -n <cluster-name> delete managedclusteraddon <addon-name>

当使用 infrastructure operator for Red Hat OpenShift 创建 OpenShift Container Platform 集群时，ISO 镜像的文件名可能太长。镜像名称长会导致镜像置备和集群置备失败。要确定这是否是问题，请完成以下步骤：

如果出现这个问题，这通常位于以下 OpenShift Container Platform 版本中，因为 Red Hat OpenShift 的基础架构 Operator 不使用镜像服务：

为了避免这个错误，将 OpenShift Container Platform 升级到 4.8.18 或更高版本，或 4.9.7 或更高版本。

您不能使用主机清单或 InfraEnv 自定义资源来通过发现镜像进行两个引导，并自动添加主机。如果您将之前的 InfraEnv 资源用于 BareMetalHost 资源，并且希望自行引导镜像，您可以通过创建一个新的 InfraEnv 资源来解决此问题。

如果要在 4.16 之前使用 Red Hat OpenShift Container Platform 版本安装单节点 OpenShift 集群，您的 InfraEnv 自定义资源和引导的主机必须使用相同的 OpenShift Container Platform 版本来安装单节点 OpenShift 集群。如果版本不匹配，安装会失败。

要临时解决这个问题，请在使用 Discovery ISO 引导主机前编辑 InfraEnv 资源，并包含以下内容：

apiVersion: agent-install.openshift.io/v1beta1
kind: InfraEnv
spec:
  osImageVersion: 4.15

osImageVersion 字段必须与您要安装的 Red Hat OpenShift Container Platform 集群版本匹配。

在 MultiClusterEngine 和 MultiClusterHub 资源中配置的 tolerations 和 nodeSelector 设置不会影响本地集群中部署的 managed-serviceaccount 代理。本地集群中并不总是需要 managed-serviceaccount 附加组件。

如果需要 managed-serviceaccount 附加组件，您可以通过完成以下步骤来临时解决这个问题：

请参阅为 klusterlet 附加组件配置 nodeSelectors 和 tolerations，以了解如何使用 addonDeploymentConfig 自定义资源为附加组件配置 tolerations（容限） 和 nodeSelector。

如果您从 hub 集群中删除 BareMetalHost 资源，节点会关闭。您可以再次手动打开节点电源。