登录到您的集群。对于通常的用例，您应该在登录到 hub 集群时运行 must-gather。

注： 如果要检查受管集群，找到位于 cluster-scoped-resources 目录中的 gather-managed.log 文件：

<your-directory>/cluster-scoped-resources/gather-managed.log>

检查 JOINED 和 AVAILABLE 列中未设置 True 的受管集群。您可以在没有连接到 True 状态的集群中运行 must-gather 命令。

添加用于收集数据和目录的 Red Hat Advanced Cluster Management for Kubernetes 镜像。运行以下命令，在其中提供您要插入的镜像和输出目录：

oc adm must-gather --image=registry.redhat.io/rhacm2/acm-must-gather-rhel8:v2.2.0 --dest-dir=<directory>

进入您指定的目录查看输出。输出以以下级别进行组织：

将以下脚本复制到一个文件中：

#!/bin/bash
ACM_NAMESPACE=<namespace>
oc delete mch --all -n $ACM_NAMESPACE
helm ls --namespace $ACM_NAMESPACE | cut -f 1 | tail -n +2 | xargs -n 1 helm delete --namespace $ACM_NAMESPACE
oc delete apiservice v1beta1.webhook.certmanager.k8s.io v1.admission.cluster.open-cluster-management.io v1.admission.work.open-cluster-management.io
oc delete clusterimageset --all
oc delete configmap -n $ACM_NAMESPACE cert-manager-controller cert-manager-cainjector-leader-election cert-manager-cainjector-leader-election-core
oc delete consolelink acm-console-link
oc delete crd klusterletaddonconfigs.agent.open-cluster-management.io placementbindings.policy.open-cluster-management.io policies.policy.open-cluster-management.io userpreferences.console.open-cluster-management.io searchservices.search.acm.com
oc delete mutatingwebhookconfiguration cert-manager-webhook cert-manager-webhook-v1alpha1
oc delete oauthclient multicloudingress
oc delete rolebinding -n kube-system cert-manager-webhook-webhook-authentication-reader
oc delete scc kui-proxy-scc
oc delete validatingwebhookconfiguration cert-manager-webhook cert-manager-webhook-v1alpha1

将脚本中的 <namespace> 替换为安装 Red Hat Advanced Cluster Management 的命名空间的名称。确保指定正确的命名空间，因为命名空间会被清理和删除。

确定受管集群是否可用。您可以在 Red Hat Advanced Cluster Management 控制台的 Clusters 区域中进行检查。

如果不可用，请尝试重启受管集群。

如果受管集群状态仍处于离线状态，完成以下步骤：

在受管集群中运行以下命令查看有问题的 Kubernetes pod 的名称：

kubectl get pod -n open-cluster-management-agent | grep klusterlet-registration-agent

在受管集群中运行以下命令查找错误的日志条目：

kubectl logs <registration_agent_pod>

把 registration_agent_pod 替换为在第 1 步中获得的 pod 名称。

通过在 hub 集群中输入以下命令来检索有问题的端口号：

oc get infrastructure cluster -o yaml | grep apiServerURL

确保来自受管集群的主机名可以被解析，并确保建立到主机和端口的出站连接。

如果无法通过受管集群建立通信，集群导入就不完整。受管集群的集群状态将会是 Pending import。

再次手动导入集群。从 Red Hat Advanced Cluster Management 创建的 Red Hat OpenShift Container Platform 集群将每 2 小时重新同步，以便可以为这些集群跳过这一步。

运行以下命令以生成保留在 <cluster_name> 命名空间中的资源列表：

oc api-resources --verbs=list --namespaced -o name | grep -E '^secrets|^serviceaccounts|^managedclusteraddons|^roles|^rolebindings|^manifestworks|^leases|^managedclusterinfo|^appliedmanifestworks' | xargs -n 1 oc get --show-kind --ignore-not-found -n <cluster_name>

使用您要删除的集群的命名空间名称替换 cluster_name。

输入以下命令编辑列表，删除列表中状态不是 Delete 的资源：

oc edit <resource_kind> <resource_name> -n <namespace>

将 resource_kind 替换为资源类型。将 resource_name 替换为资源的名称。将 namespace 替换为资源的命名空间的名称。

输入以下命令来删除命名空间：

oc delete ns <cluster-name>

将 cluster-name 替换为您要删除的命名空间的名称。

输入以下命令在 hub 集群上编辑 ManagedCluster 规格：

oc edit managedcluster <cluster-name>

将 cluster-name 替换为您的受管集群的名称。

在 Red Hat Advanced Cluster Management 集群中，运行以下命令以应用该文件：

oc apply -f apps.open-cluster-management.io_channels_crd.yaml

在 open-cluster-management 命名空间中，编辑 advanced-cluster-management.v2.2.0 CSV，运行以下命令并编辑：

oc edit csv advanced-cluster-management.v2.2.0 -n open-cluster-management

查找以下容器：

更新会在 open-cluster-management 命名空间中重新创建以下 pod：

更新受管集群上的镜像。

在 hub 集群中，使用实际的受管集群名称替换 CLUSTER_NAME 来运行以下命令：

oc annotate klusterletaddonconfig -n CLUSTER_NAME CLUSTER_NAME klusterletaddonconfig-pause=true --overwrite=true

运行以下命令，将 CLUSTER_NAME 替换为实际受管集群名称：

oc edit manifestwork -n CLUSTER_NAME  CLUSTER_NAME-klusterlet-addon-appmgr

找到 spec.global.imageOverrides.multicluster_operators_subscription 并将值设置为：

quay.io/open-cluster-management/multicluster-operators-subscription:2.2-PR337-91af6cb37d427d22160b2c055589a4418dada4eb

这会在受管集群的 open-cluster-management-agent-addon 命名空间中重新创建 klusterlet-addon-appmgr-<random-characters> pod。

当您通过控制台或 CLI 创建应用程序时，手动在频道 spec 中添加 'insecureSkipVerify: true'。请参见以下示例：

apiVersion: apps.open-cluster-management.io/v1
kind: Channel
metadata:
labels:
  name: sample-channel
  namespace: sample
spec:
  type: GitHub
  pathname: <Git URL>
  insecureSkipVerify: true

确认受管集群列表包含 local-cluster，放置规则 decisions 列表没有显示本地集群。运行以下命令并查看结果：

% oc get managedclusters

NAME            HUB ACCEPTED   MANAGED CLUSTER URLS   JOINED   AVAILABLE   AGE
local-cluster   true                                  True     True        56d
cluster1        true                                  True     True        16h

apiVersion: apps.open-cluster-management.io/v1
kind: PlacementRule
metadata:
  name: all-ready-clusters
  namespace: default
spec:
  clusterSelector: {}
status:
  decisions:
  - clusterName: cluster1
    clusterNamespace: cluster1

在 .yaml 文件中创建一个 Role，授予 local-cluster 命名空间中的可部署管理权限。请参见以下示例：

apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: deployables-admin-user-zisis
  namespace: local-cluster
rules:
- apiGroups:
  - apps.open-cluster-management.io
  resources:
  - deployables
  verbs:
  - '*'

创建 RoleBinding 资源，授予放置规则用户对 local-cluster 命名空间的访问权限。请参见以下示例：

apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  name: deployables-admin-user-zisis
  namespace: local-cluster
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: Role
  name: deployables-admin-user-zisis
  namespace: local-cluster
subjects:
- kind: User
  name: zisis
  apiGroup: rbac.authorization.k8s.io

更新资源中的 apiVersion。例如，如果订阅 YAML 文件中显示 Deployment kind 的错误，您需要将 apiVersion 从 extensions/v1beta1 更新至 apps/v1。

请参见以下示例：

apiVersion: apps/v1
kind: Deployment

在受管集群中运行以下命令来验证可用版本：

kubectl explain <resource>

安装后，找到订阅 multicluster subscription community operator 的 operator 订阅 CR。运行以下命令：

% oc get sub -n open-cluster-management acm-operator-subscription

通过附加 spec.config.resources 文件来编辑 operator 订阅自定义资源，以定义资源限制。.yaml

注： 不要创建新的、订阅了同一个多集群订阅社区 operator 的订阅自定义资源。因为两个 operator 订阅都链接到一个 operator，operator Pod 会被 "killed" 并由两个 operator 订阅自定义资源重启。

请参阅以下更新的 .yaml 文件示例：

apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: multicluster-operators-subscription-alpha-community-operators-openshift-marketplace
  namespace: open-cluster-management
spec:
  channel: release-2.2
  config:
    resources:
      limits:
        cpu: 750m
        memory: 2Gi
      requests:
        cpu: 150m
        memory: 128Mi
  installPlanApproval: Automatic
  name: multicluster-operators-subscription
  source: community-operators
  sourceNamespace: openshift-marketplace

保存资源后，确保独立订阅 Pod 被重启为有 2GB 内存限制。运行以下命令：

% oc get pods -n open-cluster-management multicluster-operators-standalone-subscription-7c8cbf885f-c94kz -o yaml

apiVersion: v1
kind: Pod
...
spec:
  containers:
  - image: quay.io/open-cluster-management/multicluster-operators-subscription:community-2.2
...
    resources:
      limits:
        cpu: 750m
        memory: 2Gi
      requests:
        cpu: 150m
        memory: 128Mi
...
status:
  qosClass: Burstable

在受管集群中运行以下命令查看 Klusterlet 状态：

kubectl get klusterlets klusterlet -oyaml

在 hub 集群中，注解 klusterletaddonconfig 来暂停复制。使用以下命令：

oc annotate klusterletaddonconfig -n ${CLUSTER_NAME} ${CLUSTER_NAME} klusterletaddonconfig-pause=true --  overwrite=true

在 hub 集群中，缩减 klusterlet-addon-operator。使用以下命令：

oc edit manifestwork ${CLUSTER_NAME}-klusterlet-addon-operator -n ${CLUSTER_NAME}

找到 klusterlet-addon-operator 部署并在 spec 中添加 replicas: 0 来缩减。

- apiVersion: apps/v1
  kind: Deployment
  metadata:
    labels:
      app: cluster1
    name: klusterlet-addon-operator
    namespace: open-cluster-management-agent-addon
    spec:
      replicas: 0

在受管集群中，open-cluster-management-agent-addon/klusterlet-addon-operator pod 将被终止。

登录到受管集群，手动增加 appmgr pod 中的内存限值。

运行以下命令：

% oc edit deployments -n open-cluster-management-agent-addon klusterlet-addon-appmgr

例如，如果限制为 5G，将限制增加到 8G。

resources:
  limits:
    memory: 2Gi  -> 8Gi
  requests:
    memory: 128Mi -> 256Mi

注解订阅 CR，以便生成一个协调的单个订阅 operator。请参阅以下 data 规格：

apiVersion: apps.open-cluster-management.io/v1
kind: Channel
metadata:
  name: deva
  namespace: ch-obj
  labels:
    name: obj-sub
spec:
  type: ObjectBucket
  pathname: http://ec2-100-26-232-156.compute-1.amazonaws.com:9000/deva
  sourceNamespaces:
    - default
  secretRef:
    name: dev
---
apiVersion: v1
kind: Secret
metadata:
  name: dev
  namespace: ch-obj
  labels:
    name: obj-sub
data:
  AccessKeyID: YWRtaW4=
  SecretAccessKey: cGFzc3dvcmRhZG1pbg==

运行 oc annotate 测试：

oc annotate appsub -n <subscription-namespace> <subscription-name> test=true

验证是否安装了可观察性组件：

通过更新放置规则，将 observability 参数值改为 enabled。运行以下命令：

oc edit placementrule -n open-cluster-management-observability

运行以下命令来验证 OpenShift 是否已被列为目标受管集群的厂商：

oc get managedcluster <CLUSTER NAME> -o yaml

将 metadata.labels.vendor 参数值更新为 OpenShift。

使用以下命令检查 hub 集群命名空间中的 pod 事件：

oc describe pod search-redisgraph-0

如果您创建了 searchcustomization CR，检查存储类和存储大小是否有效，并检查是否可以创建 PVC。运行以下命令列出 PVC：

oc get pvc  <storageclassname>-search-redisgraph-0

确保 PVC 可以绑定到 search-redisgraph-0 pod。如果问题仍没有解决，请删除 StatefulSet search-redisgraph。search operator 会重新创建 StatefulSet。运行以下命令：

oc delete statefulset -n open-cluster-management search-redisgraph

运行查询确认磁盘空间已满。

扩展 data-observability-observatorium-thanos-receive-default-x PVC，将 storage 参数更新为大于 MultiClusterObservability(mco)CR 的 statefulSetSize 值。对每个 data-observability-observatorium-thanos-receive-default-x PVC 运行以下命令：

kubectl get pvc data-observability-observatorium-thanos-receive-default-0 -o yaml

您的 data-observability-observatorium-thanos-receive-default-x PVC 可能类似以下内容：

spec:
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage:

这可能需要一些时间才能工作。当 storage 和 status 匹配时，您的更改将生效。运行上一个命令进行检查。

通过完成以下步骤验证修复：