安装

为确保正确设置 OpenShift Container Platform 集群，请访问 OpenShift Container Platform Web 控制台。

运行 kubectl -n openshift-console get route 命令来访问 OpenShift Container Platform Web 控制台。

请参见以下示例输出：

openshift-console        console  console-openshift-console.apps.new-coral.purple-chesterfield.com                       console                  https   reencrypt/Redirect     None

本例中的控制台 URL 是：https://console-openshift-console.apps.new-coral.purple-chesterfield.com。

按照 OpenShift Container Platform 文档中的 创建基础架构机器集中的步骤将基础架构节点配置为基础架构机器集。

请参阅以下容限示例：

tolerations:
  - effect: NoSchedule
    key: node-role.kubernetes.io/infra
    operator: Exists

把以下 nodeSelector 项添加到 MultclusterHub 资源的 object 部分：

spec:
  nodeSelector:
    node-role.kubernetes.io/infra: ""

在 Operator subscription 页中，选择安装选项：

如果您计划导入不是由 OpenShift Container Platform 或 Red Hat Advanced Cluster Management 创建的 Kubernetes 集群，请创建一个包含 OpenShift Container Platform pull secret 的 secret，以从容器镜像仓库（registry）中访问授权内容。OpenShift Container Platform 集群的 secret 要求由 OpenShift Container Platform 和 Red Hat Advanced Cluster Management 自动解决，因此如果您没有导入其他类型的 Kubernetes 集群，则不必创建 secret。

重要：这些 secret 是特定于命名空间的，因此请确保在安装 Red Hat Advanced Cluster Management 的命名空间中创建一个 secret。

创建 MultiClusterHub 自定义资源。

可选： 如有必要，禁用 hub 自助管理。默认情况下，Red Hat Advanced Cluster Management hub 集群会自动导入和管理。此 受管 hub 集群名为 local-cluster。

如果您不希望 Red Hat Advanced Cluster Management hub 集群管理自己，请将 disableHubSelfManagement 的设置从 false 改为 true。如果该设置没有包括在定义自定义资源的 YAML 文件中，请添加它。hub 集群只能通过这个选项进行管理。

将这个选项设置为 true 并尝试手动管理 hub，会导致意外行为。

以下示例显示，如果要禁用 hub 自助管理功能，要使用的默认模板。将 namespace 替换为项目命名空间的名称：

apiVersion: operator.open-cluster-management.io/v1
kind: MultiClusterHub
metadata:
  name: multiclusterhub
  namespace: <namespace>
spec:
  disableHubSelfManagement: true

选择 Create 来初始化自定义资源。hub 集群最多可能需要 10 分钟才会构建并启动。

创建 hub 集群后，Installed Operators 页面中的 operator 的状态为 Running。

访问 hub 集群的控制台。

创建一个 hub 集群命名空间，其中包含 Operator 的要求。运行以下命令，其中 namespace 是 hub 集群命名空间的名称。在 OpenShift Container Platform 环境中，namespace 的值可能被称为 Project（项目）。

oc create namespace <namespace>

将项目命名空间切换到您创建的命名空间。使用在第 1 步中创建的 hub 集群命名空间的名称替换 namespace。

oc project <namespace>

如果您计划导入不是由 OpenShift Container Platform 或 Red Hat Advanced Cluster Management 创建的 Kubernetes 集群，生成一个包含 OpenShift Container Platform pull secret 信息的 secret，以从发行 registry 中访问授权内容。OpenShift Container Platform 集群的 secret 要求由 OpenShift Container Platform 和 Red Hat Advanced Cluster Management 自动解决，因此如果您没有导入其他类型的 Kubernetes 集群，则不必创建 secret。重要：这些 secret 是特定于命名空间的，因此请确保处于在第 1 步中创建的命名空间中。

创建一个 operator 组。每个命名空间只能有一个 operator 组。

应用订阅。

oc apply -f <path-to-file><subscription>.yaml

应用 MultiClusterHub 自定义资源。

error: unable to recognize "./mch.yaml": no matches for kind "MultiClusterHub" in version "operator.open-cluster-management.io/v1"

运行以下命令来获取自定义资源。在运行以下命令后，在最多 10 分钟内，MultiClusterHub 自定义资源状态会在 status.phase 字段中显示为 Running：

oc get mch -o=jsonpath='{.items[0].status.phase}'

状态变为 Running 后，查看查找路由的路由列表：

oc get routes

创建镜像 registry。如果您还没有镜像 registry，请按照 Red Hat OpenShift Container Platform 文档中的为断开连接的环境创建镜像的容器镜像的步骤来创建。

注： 确保按照 OpenShift Container Platform 文档中的从镜像 Operator 目录中提取 OperatorHub 的步骤。

镜像 operator 目录。按照 Mirroring Operator catalogs for use with disconnected clusters 中的步骤对 operator 进行了镜像。

注： 如果您要从现有的 Red Hat Operator 索引镜像中修剪软件包，请确保修剪 advanced-cluster-management 软件包。请参阅过滤基于 SQLite 的索引镜像。

注： 对于裸机，您需要在 install-config.yaml 文件中为断开连接的 registry 提供证书信息。要访问受保护的断开连接的 registry 中的镜像，必须提供证书信息，以便 Red Hat Advanced Cluster Management 可以访问 registry。

重要： 如果需要以下监管策略，则需要额外的镜像 registry：

    - mirrors:
      - <your_registry>/rhacm2
      source: registry.redhat.io/rhacm2
    - mirrors:
      - <your_registry>/quay
      source: registry.redhat.io/quay
    - mirrors:
      - <your_registry>/compliance
      source: registry.redhat.io/compliance

创建一个包含 ImageContentSourcePolicy 的 YAML 文件，其名称为 rhacm-policy.yaml。注： 如果您在正在运行的集群中修改此操作，则会导致所有节点的滚动重启。

apiVersion: operator.openshift.io/v1alpha1
kind: ImageContentSourcePolicy
metadata:
  name: rhacm-repo
spec:
  repositoryDigestMirrors:
  - mirrors:
    - mirror.registry.com:5000/rhacm2
    source: registry.redhat.io/rhacm2

输入以下命令应用 ImageContentSourcePolicy 文件：

oc apply -f rhacm-policy.yaml

启用断开连接的 Operator Lifecycle Manager Red Hat Operator 和 Community Operator。

Red Hat Advanced Cluster Management 包括在 Operator Lifecycle Manager Red Hat Operator 目录中。

输入以下命令来更改到您的项目命名空间。将 namespace 替换为项目命名空间的名称：

oc project <namespace>

输入以下命令删除 MultiClusterHub 自定义资源：

oc delete multiclusterhub --all

您可以输入以下命令来查看进度：

oc get mch -o yaml

运行清理脚本删除所有潜在的剩余工件。

注 ： 如果在集群中手动安装了 cert-manager，请务必查看清理脚本中的命令，并删除特定于 cert-manager 的命令。

输入以下命令删除所有相关组件和订阅：

oc delete subs --all

输入以下命令删除 ClusterServiceVersion:

oc delete clusterserviceversion --all

删除 MultiClusterHub 自定义资源。

参照 Removing a MultiClusterHub instance by using commands 的内容运行 clean-up 脚本。

提示： 如果您计划重新安装相同的 Red Hat Advanced Cluster Management 版本，您可以跳过这个过程中的其余步骤并重新安装自定义资源。