1.2. 在线安装


通过 Operator Lifecycle Manager 安装 Red Hat Advanced Cluster Management for Kubernetes,它管理安装、升级和删除包含 Red Hat Advanced Cluster Management hub 集群的组件。因为 Red Hat Advanced Cluster Management 依赖于并使用 multicluster engine operator,所以在安装过程中创建 MultiClusterHub 资源后,Red Hat Advanced Cluster Management Operator 会自动安装 multicluster engine operator operator 并创建 MultiClusterEngine 资源。

您必须有一个受支持的 OpenShift Container Platform 版本才能安装 Red Hat Advanced Cluster Management。

需要的访问权限:集群管理员

OpenShift Container Platform Dedicated 环境需要访问权限: 您需要 cluster-admin 权限。默认情况下,dedicated-admin 角色没有在 OpenShift Container Platform Dedicated 环境中创建命名空间所需的权限。

备注:

  • 默认情况下,hub 集群组件安装在 OpenShift Container Platform 集群的 worker 节点上,无需额外配置。您可以使用 OpenShift Container Platform OperatorHub Web 控制台界面或使用 OpenShift Container Platform CLI 将 hub 集群安装到 worker 节点上。
  • 如果您使用基础架构节点配置了 OpenShift Container Platform 集群,您可以使用带有其他资源参数的 OpenShift Container Platform CLI 将 hub 集群安装到这些基础架构节点上。详情请参阅在基础架构节点上安装 Red Hat Advanced Cluster Management hub 集群部分。
  • 如果您计划导入不是 OpenShift Container Platform 或 Red Hat Advanced Cluster Management 集群的 Kubernetes 集群,则需要配置镜像 pull secret。
  • 如果您之前在集群中安装 Red Hat Advanced Cluster Management,然后卸载,则需要按照清理步骤删除工件。请参阅在 重新安装前清理工件 并遵循这个流程。

有关如何配置高级配置的详情,请查看文档中的 MultiClusterHub 高级配置部分中的选项。

1.2.1. 先决条件

在安装 Red Hat Advanced Cluster Management 前,请查看以下要求:

  • 您的 Red Hat OpenShift Container Platform 集群必须通过 OpenShift Container Platform 控制台访问 OperatorHub 目录中的 Red Hat Advanced Cluster Management operator。
  • 您需要访问 catalog.redhat.com
  • 您需要一个受支持的 OpenShift Container Platform 和 OpenShift Container Platform CLI。请参阅 OpenShift Container Platform 安装
  • 您的 OpenShift Container Platform 命令行界面(CLI)被配置为运行 oc 命令。如需有关安装和配置 OpenShift Container Platform CLI 的信息,请参阅 CLI 入门
  • OpenShift Container Platform 权限必须允许创建命名空间。如果没有命名空间,安装会失败。
  • 需要有一个互联网连接来访问 Operator 的依赖项。
  • 要在 OpenShift Container Platform Dedicated 环境中安装,请参阅以下要求:

    • 您必须已配置并运行了 OpenShift Container Platform Dedicated 环境。
    • 您必须在要安装 hub 集群的 OpenShift Container Platform Dedicated 环境中具有 cluster-admin 授权。
    • 要导入,您必须为 2.12 使用 klusterlet operator 的 stable-2.0 频道。

1.2.2. 确认 OpenShift Container Platform 安装

验证 OpenShift Container Platform 集群中是否尚未安装 Red Hat Advanced Cluster Management hub 集群。您不能有多个 hub 集群。

每个 OpenShift Container Platform 集群中只能有一个 Red Hat Advanced Cluster Management hub 集群安装。如果没有安装 Red Hat Advanced Cluster Management hub 集群,请继续执行以下步骤。

  1. 要确保正确设置 OpenShift Container Platform 集群,请使用以下命令访问 OpenShift Container Platform Web 控制台:

    oc -n openshift-console get route

    请参见以下示例输出:

    openshift-console console console-openshift-console.apps.new-coral.purple-chesterfield.com
    console   https   reencrypt/Redirect     None
  2. 在浏览器中打开 URL 并检查结果。如果控制台 URL 显示 console-openshift-console.router.default.svc.cluster.local,当安装 OpenShift Container Platform 时把 openshift_master_default_subdomain 设置为这个值。请参阅以下 URL 示例 :https://console-openshift-console.apps.new-coral.purple-chesterfield.com

您可以使用控制台或 CLI 继续运行 Red Hat Advanced Cluster Management。

注: 要在基础架构节点上安装 Red Hat Advanced Cluster Management hub 集群,请参阅此流程在基础架构节点上安装 Red Hat Advanced Cluster Management hub 集群部分。

1.2.3. 从 OperatorHub Web 控制台界面安装

最佳实践: 通过控制台中的 Administrator 视图安装 OpenShift Container Platform 提供的 OperatorHub Web 控制台界面。

  1. 选择 Operators > OperatorHub 以访问可用操作器列表,然后选择 Advanced Cluster Management for Kubernetes operator。
  2. Operator subscription 页中,选择安装选项:

    Channel
    选择的频道与您要安装的发行版本对应。当您选择频道时,它会安装指定的发行版本,并确定以后获得该发行版本中的勘误更新。
    命名空间信息

    Red Hat Advanced Cluster Management hub 集群必须安装在自己的命名空间或项目中。

    • 默认情况下,OperatorHub 控制台安装过程会创建一个名为 open-cluster-management 的命名空间。最佳实践:继续使用 open-cluster-management 命名空间(如果可用)。
    • 如果已有一个名为 open-cluster-management 的命名空间,请选择不同的命名空间。
    更新的批准策略

    批准策略标识了将更新应用到您订阅的频道或发行版本的所需人交互。

    • 选择 Automatic 以确保该版本内的任何更新被自动应用。
    • 选择 Manual 在有更新可用时接收通知。如果您对更新的应用有疑问,这可能是您的最佳实践。

      重要: 要升级到下一个次版本,您必须返回 OperatorHub 页面并为较新的发行版本选择新频道。

  3. 选择 Install 以应用您的更改并创建 Operator。
  4. 创建 MultiClusterHub 自定义资源。

    1. 在 OpenShift Container Platform 控制台导航中,选择 Installed Operators > Advanced Cluster Management for Kubernetes
    2. 选择 MultiClusterHub 标签页。
    3. 选择 Create MultiClusterHub
    4. 更新 YAML 文件中的默认值。请参阅文档中的 MultiClusterHub 高级配置 部分中的选项。
  5. MultiClusterHub 标签页查看列出 Operator 的资源列表。

    • 以下示例显示了 YAML 视图中的默认模板。确认 namespace 是项目的命名空间。请参阅以下示例:

      apiVersion: operator.open-cluster-management.io/v1
      kind: MultiClusterHub
      metadata:
        name: multiclusterhub
        namespace: <namespace>
  6. 选择 Create 来初始化自定义资源。Red Hat Advanced Cluster Management hub 集群最多可能需要 10 分钟才能构建和部署组件。

    创建 Red Hat Advanced Cluster Management hub 集群后,MultiClusterHub 资源状态会在 Red Hat Advanced Cluster Management operator 的 MultiClusterHub 标签页中显示 Running

要获取控制台的访问权限,请参阅附加资源 中的访问控制台主题。

1.2.4. 通过 OpenShift Container Platform CLI 安装

安装 Operator 和对象。完成以下步骤:

  1. 创建一个包含 Operator 要求的 Red Hat Advanced Cluster Management hub 集群命名空间。运行以下命令,其中 namespace 是 Red Hat Advanced Cluster Management hub 集群命名空间的名称。在 OpenShift Container Platform 环境中,namespace 的值可能被称为 Project(项目)

    oc create namespace <namespace>
  2. 将项目命名空间切换到您创建的命名空间。使用在第 1 步中创建的 Red Hat Advanced Cluster Management hub 集群命名空间的名称替换 namespace

    oc project <namespace>
  3. 创建 YAML 文件来配置 OperatorGroup 资源。每个命名空间只能有一个 operator 组:

    apiVersion: operators.coreos.com/v1
    kind: OperatorGroup
    metadata:
      name: <default> 1
      namespace: <namespace> 2
    spec:
      targetNamespaces:
      - <namespace>
    1
    <default > 替换为 operator 组的名称。
    2
    <namespace > 替换为项目命名空间的名称。
  4. 运行以下命令来创建 OperatorGroup 资源。将 operator-group 替换为您创建的 operator 组 YAML 文件的名称:

    oc apply -f <path-to-file>/<operator-group>.yaml
  5. 创建一个 YAML 文件,将 OpenShift Container Platform 订阅配置为选择要安装的版本。文件内容类似以下示例,将 release-<2.x> 替换为所选发行版本:

    apiVersion: operators.coreos.com/v1alpha1
    kind: Subscription
    metadata:
      name: acm-operator-subscription
    spec:
      sourceNamespace: openshift-marketplace
      source: redhat-operators
      channel: release-<2.x>
      installPlanApproval: Automatic
      name: advanced-cluster-management
  6. 运行以下命令以应用该文件并创建 OpenShift Container Platform 订阅。使用您创建的订阅文件的名称替换 subscription

    oc apply -f <path-to-file>/<subscription>.yaml
  7. 创建一个 YAML 文件来配置 MultiClusterHub 自定义资源。您的默认模板应当类似于以下示例。将 namespace 替换为项目命名空间:

    apiVersion: operator.open-cluster-management.io/v1
    kind: MultiClusterHub
    metadata:
      name: multiclusterhub
      namespace: <namespace>
    spec: {}
  8. 运行以下命令以应用该文件并创建 MultiClusterHub 自定义资源。将 custom-resource 替换为自定义资源文件的名称:

    oc apply -f <path-to-file>/<custom-resource>.yaml

    如果您收到以下错误,则资源进程仍在运行。创建资源后几分钟内再次运行 oc apply 命令:

    error: unable to recognize "./mch.yaml": no matches for kind "MultiClusterHub" in version "operator.open-cluster-management.io/v1"
  9. 运行以下命令来获取自定义资源。MultiClusterHub 自定义资源状态最多可能需要 10 分钟才能显示为 Running

    oc get mch -o yaml

备注:

  • 具有 ClusterRoleBindingServiceAccount 会自动向 Red Hat Advanced Cluster Management 以及有权访问安装 Red Hat Advanced Cluster Management 的命名空间的用户凭证授予集群管理员特权。
  • 当 Red Hat Advanced Cluster Management hub 集群被自助管理时,会为 Red Hat Advanced Cluster Management hub 集群保留名为 local-cluster 的命名空间。这是产品中唯一可以存在的 local-cluster 命名空间。
  • 重要: 为了安全起见,请不要向任何不是 cluster-administrator 的用户授予对 local-cluster 命名空间的访问权限。

现在,您可以将 OpenShift Container Platform 集群配置为包含基础架构节点来运行批准的管理组件。在基础架构节点上运行组件可避免为运行这些管理组件的节点分配 OpenShift Container Platform 订阅配额。详情请参阅 为 Red Hat Advanced Cluster Management 配置基础架构节点

了解大小、扩展和高级配置。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.