1.3. 安装和升级多集群引擎 Operator

在为 Kubernetes 安装多集群引擎前，请查看以下要求：

您必须有一个受支持的 OpenShift Container Platform 版本，包括 registry 和存储服务，并可以正常工作。有关安装 OpenShift Container Platform 的更多信息，请参阅 OpenShift Container Platform 文档。

您可以继续安装 multicluster engine operator。

最佳实践： 从 OpenShift Container Platform 导航中的 Administrator 视图，安装 OpenShift Container Platform 提供的 OperatorHub Web 控制台界面。

如果您要重新安装多集群引擎 operator 且 pod 没有启动，请参阅故障排除重新安装失败以了解解决这个问题的步骤。

备注：

OpenShift Container Platform 集群可以配置为包含用于运行批准的管理组件的基础架构节点。在基础架构节点上运行组件可避免为运行这些管理组件的节点分配 OpenShift Container Platform 订阅配额。

将基础架构节点添加到 OpenShift Container Platform 集群后，请按照 OpenShift Container Platform CLI 指令安装，并将以下配置添加到 Operator Lifecycle Manager Subscription 和 MultiClusterEngine 自定义资源中。

metadata:
  labels:
    node-role.kubernetes.io/infra: ""
spec:
  taints:
  - effect: NoSchedule
    key: node-role.kubernetes.io/infra

spec:
  config:
    nodeSelector:
      node-role.kubernetes.io/infra: ""
    tolerations:
    - key: node-role.kubernetes.io/infra
      effect: NoSchedule
      operator: Exists

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

在安装 multicluster engine operator 前，您必须满足以下要求：

重要： 您需要将所需的镜像下载到镜像 registry 中，以便在断开连接的环境中安装 Operator。如果没有下载，您可能会在部署过程中收到 ImagePullBackOff 错误。

按照以下步骤在断开连接的环境中安装多集群引擎 Operator：

如需了解所需步骤，请参阅在线安装。

您可以使用控制台为 OpenShift Container Platform 版本 4.6 或更高版本上的集群升级选择频道。选择频道后，会自动提醒两个勘误版本可用的集群升级（4.8.1 > 4.8.2 > 4.8.3 等）和发行版本（4.8 > 4.9 等）。

要为集群选择频道，请完成以下步骤：

您可以在集群的 Cluster details 页中找到有关可用频道更新的提示信息。

您可以使用带有多集群引擎 operator 的 Red Hat OpenShift Update Service 来在断开连接的环境中升级集群。

在某些情况下，安全性考虑会阻止集群直接连接到互联网。这使得您很难知道什么时候可以使用升级，以及如何处理这些升级。配置 OpenShift Update Service 可能会有所帮助。

OpenShift Update Service 是一个独立的操作对象，它监控受管集群在断开连接的环境中的可用版本，并使其可用于在断开连接的环境中升级集群。配置 OpenShift Update Service 后，它可以执行以下操作：

以下主题解释了升级断开连接的集群的步骤：

默认情况下，运行 multicluster engine operator 的集群管理其自身。要在没有集群管理其自身的情况下安装 multicluster engine operator，在 MultiClusterEngine 部分中的 spec.overrides.components 设置中指定以下值：

apiVersion: multicluster.openshift.io/v1
kind: MultiClusterEngine
metadata:
  name: multiclusterengine
spec:
  overrides:
    components:
    - name: local-cluster
      enabled: false

由自身管理的 hub 集群在集群列表中被指定为 local-cluster。

如果您计划导入不是由 OpenShift Container Platform 或 multicluster engine operator 创建的 Kubernetes 集群，请生成一个包含 OpenShift Container Platform pull secret 信息的 secret，以便从发布 registry 中访问授权内容。

OpenShift Container Platform 集群的 secret 要求由 Kubernetes 的 OpenShift Container Platform 和多集群引擎自动解决，因此如果您没有导入其他类型的 Kubernetes 集群，则不必创建 secret。

重要： 这些 secret 是特定于命名空间的，因此请确保处于用于引擎的命名空间中。

以下示例显示，如果使用自定义 pull secret，要使用的 spec.imagePullSecret 模板。将 secret 替换为 pull secret 的名称：

apiVersion: multicluster.openshift.io/v1
kind: MultiClusterEngine
metadata:
  name: multiclusterengine
spec:
  imagePullSecret: <secret>

可通过在 MultiClusterEngine 自定义资源中指定位置，在指定的命名空间中安装操作对象。此命名空间在 MultiClusterEngine 自定义资源的应用程序上创建。

重要： 如果没有指定目标命名空间，Operator 将安装到 multicluster-engine 命名空间，并在 MultiClusterEngine 自定义资源规格中设置它。

以下示例显示了可以用来指定目标命名空间的 spec.targetNamespace 模板。使用目标命名空间的名称替换 target。注： target 目标命名空间不能是 default 命名空间：

apiVersion: multicluster.openshift.io/v1
kind: MultiClusterEngine
metadata:
  name: multiclusterengine
spec:
  targetNamespace: <target>

hub 集群有两个可用功能： High 和 Basic。默认情况下，hub 集群的可用性为 High，hub 集群组件副本数 为 2。它提供了对故障转移功能的支持，但消耗的资源数量比可用性为 Basic（副本数为1） 的集群多。

以下示例显示了具有 Basic 可用性的 spec.availabilityConfig 模板：

apiVersion: multicluster.openshift.io/v1
kind: MultiClusterEngine
metadata:
  name: multiclusterengine
spec:
  availabilityConfig: "Basic"

您可以在 MultiClusterEngine 中定义一组节点选择器，以安装到集群中的特定节点。以下示例显示了将 pod 分配给带有标签 node-role.kubernetes.io/infra 的节点的 spec.nodeSelector ：

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

您可以定义容限列表，以允许 MultiClusterEngine 容许在集群中定义的特定污点。以下示例显示了与 node-role.kubernetes.io/infra 污点匹配的 spec.tolerations ：

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

默认情况下，以上 infra-node 容限在 pod 上设置，而不在配置中指定任何容限。在配置中自定义容限将替换此默认行为。

默认情况下，Managed-ServiceAccount 附加组件被禁用。启用该组件后，您可以在受管集群上创建或删除服务帐户。要在启用此附加组件的环境中安装，请在 spec.overrides 的 MultiClusterEngine 规格中包括以下内容：

apiVersion: multicluster.openshift.io/v1
kind: MultiClusterEngine
metadata:
  name: multiclusterengine
spec:
  overrides:
    components:
    - name: managedserviceaccount-preview
      enabled: true

在创建 MultiClusterEngine 后，可以在命令行中编辑资源并将 managedserviceaccount-preview 组件设置为 enabled: true 来启用 Managed-ServiceAccount 插件。或者，您可以运行以下命令，将 <multiclusterengine-name> 替换为 MultiClusterEngine 资源的名称。

oc patch MultiClusterEngine <multiclusterengine-name> --type=json -p='[{"op": "add", "path": "/spec/overrides/components/-","value":{"name":"managedserviceaccount-preview","enabled":true}}]'

默认情况下，Hypershift 附加组件被禁用。要在启用此附加组件的环境中安装，请在 spec.overrides 的 MultiClusterEngine 值中包含以下内容：

apiVersion: multicluster.openshift.io/v1
kind: MultiClusterEngine
metadata:
  name: multiclusterengine
spec:
  overrides:
    components:
    - name: hypershift-preview
      enabled: true

在创建 MultiClusterEngine 后，可在命令行中编辑资源，将 hypershift-preview 组件设置为 enabled: true 来启用 Hypershift 附加组件。或者，您可以运行以下命令，将 <multiclusterengine-name> 替换为 MultiClusterEngine 资源的名称：

oc patch MultiClusterEngine <multiclusterengine-name> --type=json -p='[{"op": "add", "path": "/spec/overrides/components/-","value":{"name":"hypershift-preview","enabled":true}}]'

在卸载 Kubernetes 引擎的多集群引擎前，您必须分离所有由该引擎管理的集群。为了避免错误，分离仍由引擎管理的所有集群，然后尝试再次卸载。

❯ oc get csv
NAME                         DISPLAY                              VERSION   REPLACES   PHASE
multicluster-engine.v2.0.0   multicluster engine for Kubernetes   2.0.0                Succeeded

❯ oc delete clusterserviceversion multicluster-engine.v2.0.0
❯ oc delete sub multicluster-engine

此处显示的 CSV 版本可能会有所不同。

当使用 Red Hat OpenShift Container Platform 控制台卸载时，需要删除 operator。使用控制台完成以下步骤进行卸载：

如果没有删除多集群引擎自定义资源，请通过运行清理脚本删除潜在的剩余工件。

https://access.redhat.com/documentation/zh-cn/openshift_container_platform/4.11/html/installing/disconnected-installation-mirroring