Clusters

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

当您从 multicluster engine operator 从 2.4.0 升级到 2.4.1 时，您可能会在 multicluster-engine 命名空间中运行的 cluster-manager pod 日志中找到 StorageVersionMigration 错误。这些错误消息不会影响 multicluster engine operator。因此，您不需要采取任何操作来解决这些错误。

请参阅以下错误消息示例：

"CRDMigrationController" controller failed to sync "cluster-manager", err: ClusterManager.operator.open-cluster-management.io "cluster-manager" is invalid: status.conditions[5].reason: Invalid value: "StorageVersionMigration Failed. ": status.conditions[5].reason in body should match '^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$'

您还可以在 StorageVersionMigration managedclustersetbindings.v1beta1.cluster.open-cluster-management.io 和 managedclustersets.v1beta1.cluster.open-cluster-management.io 的状态中找到错误。请参阅以下错误消息示例：

status:
  conditions:
  - lastUpdateTime: "2023-11-29T20:28:14Z"
    message: 'failed to list resources: the server could not find the requested resource'
    status: "True"
    type: Failed

集群代理附加组件不支持 multicluster engine operator hub 集群和受管集群之间的代理设置。如果 multicluster engine operator hub 集群和受管集群之间存在代理服务器，您可以禁用集群代理附加组件。

如果您使用自动化模板来创建托管集群，并且 prehook 任务失败，则托管集群创建仍然正在进行。这是正常的，因为托管集群的设计没有完全失败状态，因此它会继续尝试创建集群。

当您从 hub 集群中删除 VolSync ManagedClusterAddOn 时，它会删除受管集群上的 VolSync operator 订阅，但不会删除集群服务版本(CSV)。要从受管集群中删除 CSV，请在您要删除 VolSync 的每个受管集群中运行以下命令：

oc delete csv -n openshift-operators volsync-product.v0.6.0

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

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

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

如果发生这个错误，您可以在 clusterclaim-controller pod 日志中看到以下内容，它是一个带有池名称和无效生命周期的特定示例：

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。

恢复受管集群使用自定义 CA 证书的 hub 集群的备份后，受管集群和 hub 集群之间的连接可能会失败。这是因为在恢复的 hub 集群上没有备份 CA 证书。要恢复连接，将受管集群的命名空间中自定义 CA 证书信息复制到恢复的 hub 集群上的 <managed_cluster>-admin-kubeconfig secret。

提示： 如果您在创建备份副本前将此 CA 证书复制到 hub 集群，备份副本会包括 secret 信息。当使用备份副本来恢复时，hub 和受管集群之间的连接会自动完成。

如果在 disableHubSelfManagement 被设置为 false 时删除 local-cluster，则 MulticlusterHub operator 会重新创建 local-cluster。分离 local-cluster 后，可能不会自动重新创建 local-cluster。

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

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

如果出现问题，通常位于以下 OpenShift Container Platform 版本上，因为基础架构操作员不使用镜像服务：

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

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

当您意外尝试以不同名称的集群形式重新导入名为 local-cluster 的集群时，local-cluster 和重新导入的集群的状态将 离线。

要从这个问题单中恢复，请完成以下步骤：

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

如果您通过安装 klusterlet operator 导入受管集群，klusterlet Operator 的版本必须与 hub 集群的版本相同，或者 klusterlet Operator 将无法正常工作。

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

hub 集群和管理集群的时间可能会不同步，在控制台中显示 unknown，当在几分钟内会变为 available。确保正确配置了 OpenShift Container Platform hub 集群时间。请参阅自定义节点。

您无法导入 IBM OpenShift Container Platform Kubernetes Service 版本 3.11 集群。支持 IBM OpenShift Kubernetes Service 的更新的版本。

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

搜索 hub 集群中资源的 RBAC 映射。根据 RBAC 设置，用户可能无法看到来自受管集群的节点数据。搜索的结果可能与集群的 Nodes 页面中显示的结果不同。

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

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

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

Red Hat OpenShift Container Platform 集群和非 OpenShift Container Platform 集群都支持 pod 日志功能，但非 OpenShift Container Platform 集群需要启用 LoadBalancer 来使用该功能。完成以下步骤以启用 LoadBalancer：

如需有关 LoadBalancer 类型的更多信息，请参阅 Kubernetes 文档中的 Service 页面。

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

因为身份验证 operator 超时错误，在 Azure 上置备 OpenShift Container Platform 4.11 集群会失败。要临时解决这个问题，在 install-config.yaml 文件中使用不同的 worker 节点类型，或者将 vmNetworkingType 参数设置为 Basic。请参阅以下 install-config.yaml 示例：

compute:
- hyperthreading: Enabled
  name: 'worker'
  replicas: 3
  platform:
    azure:
      type:  Standard_D2s_v3
      osDisk:
        diskSizeGB: 128
      vmNetworkingType: 'Basic'

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

当使用中央基础架构管理服务在断开连接的环境中部署集群时，集群节点可能无法开始安装。

这是因为集群使用从 OpenShift Container Platform 版本 4.12.0 到 4.12.2 提供的 Red Hat Enterprise Linux CoreOS live ISO 镜像创建的发现 ISO 镜像。该镜像包含一个限制性 /etc/containers/policy.json 文件，该文件需要来自 registry.redhat.io 和 registry.access.redhat.com 的镜像的签名。在断开连接的环境中，mirror 的镜像可能没有 mirror 的签名，这会导致发现集群节点的镜像拉取失败。Agent 镜像无法与集群节点连接，这会导致与辅助服务的通信失败。

要临时解决这个问题，将 ignition 覆盖应用到集群，将 /etc/containers/policy.json 文件设置为 unrestrictive。ignition 覆盖可以在 InfraEnv 自定义资源定义中设置。以下示例显示了带有覆盖的 InfraEnv 自定义资源定义：

apiVersion: agent-install.openshift.io/v1beta1
kind: InfraEnv
metadata:
  name: cluster
  namespace: cluster
spec:
  ignitionConfigOverride: '{"ignition":{"version":"3.2.0"},"storage":{"files":[{"path":"/etc/containers/policy.json","mode":420,"overwrite":true,"contents":{"source":"data:text/plain;charset=utf-8;base64,ewogICAgImRlZmF1bHQiOiBbCiAgICAgICAgewogICAgICAgICAgICAidHlwZSI6ICJpbnNlY3VyZUFjY2VwdEFueXRoaW5nIgogICAgICAgIH0KICAgIF0sCiAgICAidHJhbnNwb3J0cyI6CiAgICAgICAgewogICAgICAgICAgICAiZG9ja2VyLWRhZW1vbiI6CiAgICAgICAgICAgICAgICB7CiAgICAgICAgICAgICAgICAgICAgIiI6IFt7InR5cGUiOiJpbnNlY3VyZUFjY2VwdEFueXRoaW5nIn1dCiAgICAgICAgICAgICAgICB9CiAgICAgICAgfQp9"}}]}}'

以下示例显示了创建的未限制文件：

{
    "default": [
        {
            "type": "insecureAcceptAnything"
        }
    ],
    "transports": {
        "docker-daemon": {
        "": [
        {
            "type": "insecureAcceptAnything"
        }
        ]
    }
    }
}

更改此设置后，集群可以安装。

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

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

如果 hub 集群无法访问或与受管集群通信，则会出现以下限制：

以下是 managed-serviceaccount 附加组件的已知问题和限制：

当 hub 集群或受管集群中有另一个代理配置时，cluster-proxy-addon 无法正常工作。以下情况导致这个问题：

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

如果注解和 ManagedCluster 名称不匹配，控制台会将集群显示为 Pending import。集群不能被 multicluster engine operator 使用。如果没有注解，而 ManagedCluster 名称与 HostedCluster 资源的 Infra-ID 值不匹配时会出现相同的问题。"

当使用控制台向现有托管集群添加新节点池时，同一版本的 OpenShift Container Platform 可能会在选项列表中出现多次。您可以在列表中为您想要的版本选择任何实例。

当节点池缩减为 0 个 worker 时，控制台中的主机列表仍然会显示处于 Ready 状态的节点。您可以通过两种方式验证节点数：

当您在使用双栈网络的环境中创建托管集群时，您可能会遇到以下与 DNS 相关的问题：

要解决这个问题，请按照 为双堆栈网络配置 DNS 中的指南来配置 DNS 服务器设置。

在裸机(Agent)平台上，托管的 control plane 功能会定期轮转 Agent 用来拉取 ignition 的令牌。错误会导致不会传播新令牌。因此，如果您有一个在一些时间前创建的 Agent 资源，则可能无法拉取 ignition。

作为临时解决方案，在 Agent 规格中，删除 IgnitionEndpointTokenReference 属性引用的 secret，然后在 Agent 资源中添加或修改任何标签。然后，系统可以检测 Agent 资源是否已修改，并使用新令牌重新创建 secret。

重要：

RBAC 在控制台和 API 一级进行验证。控制台中的操作可根据用户访问角色权限启用或禁用。查看以下部分以了解有关产品中特定生命周期的 RBAC 的更多信息。

查看以下集群池 RBAC 操作：

查看以下集群生命周期控制台和 API RBAC 表：

对凭证的访问由 Kubernetes 控制。凭据作为 Kubernetes secret 存储和保护。以下权限适用于在 Red Hat Advanced Cluster Management for Kubernetes 中访问 secret：

按照 OpenShift Container Platform 文档中的 创建基础架构机器集 中所述的步骤进行操作。基础架构节点配置有 Kubernetes 污点（taint）和标签（label），以便防止非管理工作负载在它们上运行。

要与多集群引擎 operator 提供的基础架构节点启用兼容，请确保您的基础架构节点应用了以下 taint 和 label：

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

在应用 Operator Lifecycle Manager 订阅前，添加以下配置：

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

在应用 MultiClusterEngine 自定义资源前添加以下附加配置：

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

要创建 Amazon Simple Storage Service (S3) secret，请在控制台中完成以下任务：

引用发行镜像的 YAML 文件在 acm-hive-openshift-releases GitHub 仓库中维护。文件用于在控制台中创建可用发行镜像的列表。这包括 OpenShift Container Platform 的最新快速频道镜像。

控制台仅显示三个 OpenShift Container Platform 最新版本的最新发行镜像。例如，您可能在控制台选项中看到以下发行镜像：

quay.io/openshift-release-dev/ocp-release:4.12.1-x86_64

控制台会显示最新版本，可帮助您使用最新发行镜像创建集群。如果您需要创建特定版本的集群，则也提供旧的发行镜像版本。

注： 您只能在控制台中创建集群时选择具有 visible: 'true' 标签的镜像。ClusterImageSet 资源中的此标签示例在以下内容中提供。将 4.x.1 替换为产品的当前版本：

apiVersion: hive.openshift.io/v1
kind: ClusterImageSet
metadata:
  labels:
    channel: fast
    visible: 'true'
  name: img4.x.1-x86-64-appsub
spec:
  releaseImage: quay.io/openshift-release-dev/ocp-release:4.x.1-x86_64

存储了额外的发行镜像，但无法在控制台中看到。要查看所有可用发行镜像，请运行以下命令：

oc get clusterimageset

存储库具有 clusterImageSets 目录，这是使用发行镜像时使用的目录。clusterImageSets 目录有以下目录：

您可以使用以下选项配置 ClusterImageSets ：

您可以通过手动创建具有这两个架构文件的发行镜像，在与 hub 集群架构不同的架构中创建集群。

例如，您可以从 ppc64le、aarch64 或 s390x 架构上运行的 hub 集群创建一个 x86_64 集群。如果使用两组文件创建发行镜像，集群创建成功，因为新发行镜像启用 OpenShift Container Platform 发行 registry 来提供多架构镜像清单。

OpenShift Container Platform 4.12 及更新的版本默认支持多个架构。您可以使用以下 clusterImageSet 来置备集群。使用当前版本替换 4.x.0 ：

apiVersion: hive.openshift.io/v1
kind: ClusterImageSet
metadata:
  labels:
    channel: fast
    visible: 'true'
  name: img4.x.0-multi-appsub
spec:
  releaseImage: quay.io/openshift-release-dev/ocp-release:4.x.0-multi

要为不支持多个架构的 OpenShift Container Platform 镜像创建发行镜像，请完成类似以下示例的步骤：

创建流程使用合并的发行镜像来创建集群。

在启用中央基础架构管理服务前，请查看以下先决条件：

在启用中央基础架构管理服务前，您需要裸机主机自定义资源定义。

在启用中央基础架构管理服务前，您需要 置备 资源。

要在断开连接的环境中启用中央基础架构管理，请完成以下步骤：

重要：如果您使用更新的绑定功能以及 AgentServiceConfig 自定义资源中的 spec.osImages 发行版本是 4.13 或更高版本，则您在创建集群时使用的 OpenShift Container Platform 发行镜像必须是 4.13 或更高版本。版本 4.13 及更新版本的 Red Hat Enterprise Linux CoreOS 镜像与版本 4.13 之前的版本不兼容。

您可以通过检查 assisted-service 和 assisted-image-service 部署，并验证您的中央基础架构管理服务是否健康，并确保其 pod 已准备就绪并在运行。

要在连接的环境中启用中央基础架构管理，通过在 agent_service_config.yaml 文件中保存以下 YAML 内容来创建 AgentServiceConfig 自定义资源：

apiVersion: agent-install.openshift.io/v1beta1
kind: AgentServiceConfig
metadata:
 name: agent
spec:
  databaseStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <db_volume_size> 1
  filesystemStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <fs_volume_size> 2
  imageStorage:
    accessModes:
    - ReadWriteOnce
    resources:
      requests:
        storage: <img_volume_size> 3

您的中央基础架构管理服务已配置。您可以通过检查 assisted-service 和 assisted-image-service 部署，确定 pod 已就绪并在运行，来验证其状态是否正常。

完成以下步骤，使用控制台创建主机清单：

如果您需要控制台中不可用的高级配置选项，请使用命令行界面继续 创建主机清单。

如果您不需要高级配置选项，则可以继续配置静态网络（如果需要），并开始将主机添加到基础架构环境中。

要访问主机清单，请在控制台中选择 Infrastructure > Host inventory。从列表中选择您的基础架构环境，以查看详情和主机。

完成以下步骤，使用命令行界面创建主机清单（基础架构环境）：

请参阅以下显著属性列表：

注： 如果您修改 InfraEnv 资源，请通过查看 createdTime 属性来确保 InfraEnv 已创建新的 Discovery 镜像。如果您已经引导主机，请使用最新的发现镜像再次引导它们。

如果需要，可以继续配置静态网络，并开始将主机添加到基础架构环境中。

要使用命令行界面为您的基础架构环境配置高级网络，请完成以下步骤：

注： 当您更新任何 InfraEnv 属性或更改与其标签选择器匹配的 NMStateConfig 资源时，Image Service 会自动创建一个新镜像。如果在创建 InfraEnv 资源后添加 NMStateConfig 资源，请通过检查 InfraEnv 中的 createdTime 属性来确保 InfraEnv 创建一个新的 Discovery 镜像。如果您已经引导主机，请使用最新的发现镜像再次引导它们。

通过完成以下步骤下载 ISO：

现在，您会看到下载 ISO 的 URL。引导的主机会出现在主机清单表中。显示主机可能需要几分钟时间。您必须批准每个主机，然后才能使用它。您可以通过单击 Actions 并选择 Approve 来从清单表中选择主机。

您可以在 InfraEnv 资源状态中的 isoDownloadURL 属性中看到下载 ISO 的 URL。如需有关 InfraEnv 资源的更多信息，请参阅使用命令行界面创建主机清单。

每个引导的主机在同一命名空间中创建一个 Agent 资源。您必须批准每个主机，然后才能使用它。

完成以下步骤，使用控制台自动将裸机主机添加到主机清单中：

完成以下步骤，使用命令行界面自动将裸机主机添加到主机清单中。

打开主机后，镜像将开始下载。这可能需要几分钟时间。当发现主机时，会自动创建 Agent 自定义资源。

聚合流默认启用。如果没有显示主机，您可能需要临时禁用聚合流。要禁用聚合流，请完成以下步骤：

使用 Discovery ISO 成功引导的每个主机都显示为主机清单中的一行。您可以使用控制台编辑和管理主机。如果手动引导主机且没有使用裸机 Operator 自动化，则必须在控制台中批准主机，然后才能使用它。准备好作为 OpenShift 节点安装的主机具有 Available 状态。

Agent 资源代表每个主机。您可以在 Agent 资源中设置以下属性：

Agent 资源的状态具有以下属性：

在创建集群前，您必须克隆 clusterImageSets 存储库，并将其应用到 hub 集群。请参见以下步骤：

在创建集群时选择 Red Hat OpenShift Container Platform 发行镜像。

注： 如果您使用 Nutanix 平台，请确保将 ClusterImageSet 资源中的 releaseImage 使用 x86_64 架构，并将 可见的 标签值设置为 'true'。请参见以下示例：

apiVersion: hive.openshift.io/v1
kind: ClusterImageSet
metadata:
  labels:
    channel: stable
    visible: 'true'
  name: img4.x.47-x86-64-appsub
spec:
  releaseImage: quay.io/openshift-release-dev/ocp-release:4.x.47-x86_64

ClusterDeployment 是一个 Hive 自定义资源，用于控制集群的生命周期。

按照 使用 Hive 文档创建 ClusterDeployment 自定义资源并创建单个集群。

ClusterPool 也是用于创建多个集群的 Hive 自定义资源。

按照 Cluster Pools 文档，使用 Hive ClusterPool API 创建集群。

在 AWS 上创建集群前请查看以下先决条件：

请参阅以下有关创建 AWS 集群的重要信息：

要创建新集群，请参阅以下步骤。如果您有一个要导入的现有集群，请参阅集群 导入。

注： 您不必运行随集群提供的集群详情的 oc 命令。创建集群时，它由 multicluster engine operator 管理自动配置。

如果您需要创建凭证，请参阅为 Amazon Web Services 创建凭证。

集群的主机名用于集群的主机名。

如果您使用 Red Hat Advanced Cluster Management for Kubernetes，并希望将受管集群 klusterlet 配置为在特定节点上运行，请参阅 可选：将 klusterlet 配置为在特定节点上运行。

创建 AWS GovCloud 集群前必须满足以下先决条件：

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

在 AWS GovCloud 上创建集群时与在标准 AWS 上创建集群时，您必须完成一些额外的步骤，以便在 AWS GovCloud 上为集群准备 AWS PrivateLink。

spec:
  awsPrivateLink:
    ## The list of inventory of VPCs that can be used to create VPC
    ## endpoints by the controller.
    endpointVPCInventory:
    - region: us-east-1
      vpcID: vpc-1
      subnets:
      - availabilityZone: us-east-1a
        subnetID: subnet-11
      - availabilityZone: us-east-1b
        subnetID: subnet-12
      - availabilityZone: us-east-1c
        subnetID: subnet-13
      - availabilityZone: us-east-1d
        subnetID: subnet-14
      - availabilityZone: us-east-1e
        subnetID: subnet-15
      - availabilityZone: us-east-1f
        subnetID: subnet-16
    - region: us-east-1
      vpcID: vpc-2
      subnets:
      - availabilityZone: us-east-1a
        subnetID: subnet-21
      - availabilityZone: us-east-1b
        subnetID: subnet-22
      - availabilityZone: us-east-1c
        subnetID: subnet-23
      - availabilityZone: us-east-1d
        subnetID: subnet-24
      - availabilityZone: us-east-1e
        subnetID: subnet-25
      - availabilityZone: us-east-1f
        subnetID: subnet-26
    ## The credentialsSecretRef points to a secret with permissions to create.
    ## The resources in the account where the inventory of VPCs exist.
    credentialsSecretRef:
      name: <hub-account-credentials-secret-name>

    ## A list of VPC where various mce clusters exists.
    associatedVPCs:
    - region: region-mce1
      vpcID: vpc-mce1
      credentialsSecretRef:
        name: <credentials-that-have-access-to-account-where-MCE1-VPC-exists>
    - region: region-mce2
      vpcID: vpc-mce2
      credentialsSecretRef:
        name: <credentials-that-have-access-to-account-where-MCE2-VPC-exists>

要从控制台创建集群，请导航到 Infrastructure > Clusters > Create cluster AWS > Standalone，并完成控制台中的步骤。

注： 此过程用于创建集群。如果您有一个要导入的现有集群，请参阅集群 导入 以了解这些步骤。

如果创建一个 AWS GovCloud 集群，则您选择的凭证必须有权访问 AWS GovCloud 区域中的资源。如果有部署集群所需的权限，您可以使用 Hive 命名空间中已存在的 AWS GovCloud secret。在控制台中显示现有凭证。如果您需要创建凭证，请参阅为 Amazon Web Services 创建凭证。

集群的主机名用于集群的主机名。

重要： 当您创建集群时，控制器会为集群及其资源创建一个命名空间。确保只在该命名空间中包含该集群实例的资源。销毁集群会删除命名空间和所有资源。

提示： 在控制台中输入信息时，选择 YAML: On 查看内容更新。

如果要将集群添加到现有的集群集中，则需要在集群设置上具有正确的权限来添加它。如果在创建集群时没有 cluster-admin 权限，则必须选择一个具有 clusterset-admin 权限的集群集。如果您在指定的集群集中没有正确的权限，集群创建会失败。如果您没有任何集群集选项，请联络您的集群管理员，为集群集提供 clusterset-admin 权限。

每个受管集群都必须与受管集群集关联。如果您没有将受管集群分配给 ManagedClusterSet，则会自动添加到 default 受管集群集中。

如果已有与您使用 AWS 或 AWS GovCloud 帐户配置的所选凭证关联的基本 DNS 域，则该值会在字段中填充。您可以修改它的值来覆盖它。此名称用于集群的主机名。如需更多信息 ，请参阅配置 AWS 帐户。

发行镜像标识用于创建集群的 OpenShift Container Platform 镜像的版本。如果要使用的版本可用，您可以从镜像列表中选择镜像。如果您要使用的镜像不是标准镜像，您可以输入您要使用的镜像的 URL。有关发行镜像的更多信息，请参阅发行镜像。

节点池包括 control plane 池和 worker 池。control plane 节点共享集群活动的管理。该信息包括以下字段：

您可以在 worker 池中创建零个或多个 worker 节点，以运行集群的容器工作负载。它们可以位于单个 worker 池中，也可以分布在多个 worker 池中。如果指定了零个 worker 节点，control plane 节点也充当 worker 节点。可选信息包括以下字段：

集群需要网络详情，并使用 IPv6 需要多个网络。对于 AWS GovCloud 集群，在 Machine CIDR 字段中输入 Hive VPC 地址块的值。您可以通过点 Add network 来添加额外网络。

凭证中提供的代理信息会自动添加到代理字段中。您可以使用信息原样，覆盖这些信息，或者在要启用代理时添加信息。以下列表包含创建代理所需的信息：

在创建 AWS GovCloud 集群或使用私有环境时，请使用 AMI ID 和子网值完成 AWS 私有配置页面 中的字段。在 ClusterDeployment.yaml 文件中，确保 spec:platform:aws:privateLink:enabled 的值被设置为 true，该文件在选择 Use private configuration 时会自动设置。

当您在创建集群前查看信息并选择性地自定义它时，您可以选择 YAML: On 查看面板中的 install-config.yaml 文件内容。如果有更新，您可以使用自定义设置编辑 YAML 文件。

注： 您不必运行随集群提供的集群详情的 oc 命令。创建集群时，它由 multicluster engine for Kubernetes operator 管理自动配置。

如果您使用 Red Hat Advanced Cluster Management for Kubernetes，并希望将受管集群 klusterlet 配置为在特定节点上运行，请参阅 可选：将 klusterlet 配置为在特定节点上运行。

如需了解更多与访问集群相关的信息，继续访问集群。

在 Azure 上创建集群前请查看以下先决条件：

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

要从 multicluster engine operator 控制台创建集群，请进入到 Infrastructure > Clusters。在 Clusters 页面上，点 Create cluster 并完成控制台中的步骤。

注： 此过程用于创建集群。如果您有一个要导入的现有集群，请参阅集群 导入 以了解这些步骤。

如果您需要创建凭证，请参阅为 Microsoft Azure 创建凭证。

集群的主机名用于集群的主机名。

重要： 当您创建集群时，控制器会为集群及其资源创建一个命名空间。确保只在该命名空间中包含该集群实例的资源。销毁集群会删除命名空间和所有资源。

提示： 在控制台中输入信息时，选择 YAML: On 查看内容更新。

如果要将集群添加到现有的集群集中，则需要在集群设置上具有正确的权限来添加它。如果在创建集群时没有 cluster-admin 权限，则必须选择一个具有 clusterset-admin 权限的集群集。如果您在指定的集群集中没有正确的权限，集群创建会失败。如果您没有任何集群集选项，请联络您的集群管理员，为集群集提供 clusterset-admin 权限。

每个受管集群都必须与受管集群集关联。如果您没有将受管集群分配给 ManagedClusterSet，则会自动添加到 default 受管集群集中。

如果已有与您为 Azure 帐户配置的所选凭证关联的基本 DNS 域，则该值会在那个字段中填充。您可以修改它的值来覆盖它。如需更多信息，请参阅为 Azure 云服务配置自定义域名。此名称用于集群的主机名。

发行镜像标识用于创建集群的 OpenShift Container Platform 镜像的版本。如果要使用的版本可用，您可以从镜像列表中选择镜像。如果您要使用的镜像不是标准镜像，您可以输入您要使用的镜像的 URL。有关发行镜像的更多信息，请参阅发行镜像。

Node 池包括 control plane 池和 worker 池。control plane 节点共享集群活动的管理。该信息包括以下可选字段：

您可以在创建集群后更改 control plane 池的 Instance type 和 Root 存储分配（必需）。

您可以在 worker 池中创建一个或多个 worker 节点，以运行集群的容器工作负载。它们可以位于单个 worker 池中，也可以分布在多个 worker 池中。如果指定了零个 worker 节点，control plane 节点也充当 worker 节点。该信息包括以下字段：

您可以通过点 Add network 来添加额外网络。如果您使用的是 IPv6 地址，您必须有多个网络。

凭证中提供的代理信息会自动添加到代理字段中。您可以使用信息原样，覆盖这些信息，或者在要启用代理时添加信息。以下列表包含创建代理所需的信息：

当您在创建集群前查看信息并选择性地自定义它时，您可以点 YAML 切换 On 查看面板中的 install-config.yaml 文件内容。如果有更新，您可以使用自定义设置编辑 YAML 文件。

如果您使用 Red Hat Advanced Cluster Management for Kubernetes，并希望将受管集群 klusterlet 配置为在特定节点上运行，请参阅 可选：将 klusterlet 配置为在特定节点上运行。

注： 您不必运行随集群提供的集群详情的 oc 命令。创建集群时，它由 multicluster engine operator 管理自动配置。

如需了解更多与访问集群相关的信息，继续访问集群。

在 GCP 上创建集群前请查看以下先决条件：

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

要从 multicluster engine operator 控制台创建集群，请导航到 Infrastructure > Clusters。在 Clusters 页面上，点 Create cluster 并完成控制台中的步骤。

注： 此过程用于创建集群。如果您有一个要导入的现有集群，请参阅集群 导入 以了解这些步骤。

如果您需要创建凭证，请参阅为 Google Cloud Platform 创建凭证。

集群名称用于集群的主机名。在命名 GCP 集群时有一些限制。这些限制包括，名称不要以 goog 开始；名称的任何部分都不要包含与 google 类似的内容。如需了解完整的限制列表，请参阅 Bucket 命名指南。

重要： 当您创建集群时，控制器会为集群及其资源创建一个命名空间。确保只在该命名空间中包含该集群实例的资源。销毁集群会删除命名空间和所有资源。

提示： 在控制台中输入信息时，选择 YAML: On 查看内容更新。

如果要将集群添加到现有的集群集中，则需要在集群设置上具有正确的权限来添加它。如果在创建集群时没有 cluster-admin 权限，则必须选择一个具有 clusterset-admin 权限的集群集。如果您在指定的集群集中没有正确的权限，集群创建会失败。如果您没有任何集群集选项，请联络您的集群管理员，为集群集提供 clusterset-admin 权限。

每个受管集群都必须与受管集群集关联。如果您没有将受管集群分配给 ManagedClusterSet，则会自动添加到 default 受管集群集中。

如果已有与 GCP 帐户所选凭证关联的基本 DNS 域，则该值会在字段中填充。您可以修改它的值来覆盖它。如需更多信息，请参阅设置自定义域。此名称用于集群的主机名。

发行镜像标识用于创建集群的 OpenShift Container Platform 镜像的版本。如果要使用的版本可用，您可以从镜像列表中选择镜像。如果您要使用的镜像不是标准镜像，您可以输入您要使用的镜像的 URL。有关发行镜像的更多信息，请参阅发行镜像。

Node 池包括 control plane 池和 worker 池。control plane 节点共享集群活动的管理。该信息包括以下字段：

您可以指定 control plane 池的实例类型。您可以在实例创建后更改实例的类型和大小。

您可以在 worker 池中创建一个或多个 worker 节点，以运行集群的容器工作负载。它们可以位于单个 worker 池中，也可以分布在多个 worker 池中。如果指定了零个 worker 节点，control plane 节点也充当 worker 节点。该信息包括以下字段：

网络详细信息是必需的，需要使用 IPv6 地址的多个网络。您可以通过点 Add network 来添加额外网络。

凭证中提供的代理信息会自动添加到代理字段中。您可以使用信息原样，覆盖这些信息，或者在要启用代理时添加信息。以下列表包含创建代理所需的信息：

当您在创建集群前查看信息并选择性地自定义它时，您可以选择 YAML: On 查看面板中的 install-config.yaml 文件内容。如果有更新，您可以使用自定义设置编辑 YAML 文件。

如果您使用 Red Hat Advanced Cluster Management for Kubernetes，并希望将受管集群 klusterlet 配置为在特定节点上运行，请参阅 可选：将 klusterlet 配置为在特定节点上运行。

注： 您不必运行随集群提供的集群详情的 oc 命令。创建集群时，它由 multicluster engine operator 管理自动配置。

如需了解更多与访问集群相关的信息，继续访问集群。

在 vSphere 上创建集群前请查看以下先决条件：

要从 multicluster engine operator 控制台创建集群，请进入到 Infrastructure > Clusters。在 Clusters 页面上，点 Create cluster 并完成控制台中的步骤。

注： 此过程用于创建集群。如果您有一个要导入的现有集群，请参阅集群 导入 以了解这些步骤。

如果您需要创建凭证，请参阅为 VMware vSphere 创建凭证，以了解有关创建凭证的更多信息。

集群名称用于集群的主机名。

重要： 当您创建集群时，控制器会为集群及其资源创建一个命名空间。确保只在该命名空间中包含该集群实例的资源。销毁集群会删除命名空间和所有资源。

提示： 在控制台中输入信息时，选择 YAML: On 查看内容更新。

如果要将集群添加到现有的集群集中，则需要在集群设置上具有正确的权限来添加它。如果在创建集群时没有 cluster-admin 权限，则必须选择一个具有 clusterset-admin 权限的集群集。如果您在指定的集群集中没有正确的权限，集群创建会失败。如果您没有任何集群集选项，请联络您的集群管理员，为集群集提供 clusterset-admin 权限。

每个受管集群都必须与受管集群集关联。如果您没有将受管集群分配给 ManagedClusterSet，则会自动添加到 default 受管集群集中。

如果已有与您为 vSphere 帐户配置的所选凭证关联的基域，则该值会在字段中填充。您可以修改它的值来覆盖它。如需更多信息 ，请参阅使用自定义在 vSphere 上安装集群。这个值必须与创建 prerequisites 部分中列出的 DNS 记录的名称匹配。此名称用于集群的主机名。

发行镜像标识用于创建集群的 OpenShift Container Platform 镜像的版本。如果要使用的版本可用，您可以从镜像列表中选择镜像。如果您要使用的镜像不是标准镜像，您可以输入您要使用的镜像的 URL。有关发行镜像的更多信息，请参阅发行镜像。

注： 支持 OpenShift Container Platform 版本 4.12 及更新的版本的发行镜像。

节点池包括 control plane 池和 worker 池。control plane 节点共享集群活动的管理。该信息包括 CPU 架构 字段。查看以下字段描述：

您可以在 worker 池中创建一个或多个 worker 节点，以运行集群的容器工作负载。它们可以位于单个 worker 池中，也可以分布在多个 worker 池中。如果指定了零个 worker 节点，control plane 节点也充当 worker 节点。该信息包括 每个插槽的内核数、CPU、Memory_min MiB、_Disk 大小 （以 GiB 为单位）和 节点数。

需要网络信息。使用 IPv6 需要多个网络。一些所需网络信息包括以下字段：

您可以通过点 Add network 来添加额外网络。如果您使用的是 IPv6 地址，您必须有多个网络。

凭证中提供的代理信息会自动添加到代理字段中。您可以使用信息原样，覆盖这些信息，或者在要启用代理时添加信息。以下列表包含创建代理所需的信息：

您可以点 Disconnected 安装来定义断开连接的安装镜像。当使用 Red Hat OpenStack Platform 供应商和断开连接的安装创建集群时，如果需要一个证书才能访问镜像 registry，在配置集群时需要在 Configuration for disconnected installation 段中的 Additional trust bundle 字段中输入它，在创建集群时在 Disconnected installation 段中输入它。

您可以点击 Add Automation template 来创建模板。

当您在创建集群前查看信息并选择性地自定义它时，您可以点 YAML 切换 On 查看面板中的 install-config.yaml 文件内容。如果有更新，您可以使用自定义设置编辑 YAML 文件。

如果您使用 Red Hat Advanced Cluster Management for Kubernetes，并希望将受管集群 klusterlet 配置为在特定节点上运行，请参阅 可选：将 klusterlet 配置为在特定节点上运行。

注： 您不必运行随集群提供的集群详情的 oc 命令。创建集群时，它由 multicluster engine operator 管理自动配置。

如需了解更多与访问集群相关的信息，继续访问集群。

在 Red Hat OpenStack Platform 上创建集群前请查看以下先决条件：

要从 multicluster engine operator 控制台创建集群，请进入到 Infrastructure > Clusters。在 Clusters 页面上，点 Create cluster 并完成控制台中的步骤。

注： 此过程用于创建集群。如果您有一个要导入的现有集群，请参阅集群 导入 以了解这些步骤。

如果您需要创建凭证，请参阅为 Red Hat OpenStack Platform 创建凭证。

集群的主机名用于集群的主机名。名称必须包含少于 15 个字符。这个值必须与创建凭证先决条件中列出的 DNS 记录的名称匹配。

重要： 当您创建集群时，控制器会为集群及其资源创建一个命名空间。确保只在该命名空间中包含该集群实例的资源。销毁集群会删除命名空间和所有资源。

提示： 在控制台中输入信息时，选择 YAML: On 查看内容更新。

如果要将集群添加到现有的集群集中，则需要在集群设置上具有正确的权限来添加它。如果在创建集群时没有 cluster-admin 权限，则必须选择一个具有 clusterset-admin 权限的集群集。如果您在指定的集群集中没有正确的权限，集群创建会失败。如果您没有任何集群集选项，请联络您的集群管理员，为集群集提供 clusterset-admin 权限。

每个受管集群都必须与受管集群集关联。如果您没有将受管集群分配给 ManagedClusterSet，则会自动添加到 default 受管集群集中。

如果已有与您为 Red Hat OpenStack Platform 帐户配置的所选凭证关联的基本 DNS 域，则该值会在字段中填充。您可以修改它的值来覆盖它。如需更多信息，请参阅 Red Hat OpenStack Platform 文档中的管理域。此名称用于集群的主机名。

发行镜像标识用于创建集群的 OpenShift Container Platform 镜像的版本。如果要使用的版本可用，您可以从镜像列表中选择镜像。如果您要使用的镜像不是标准镜像，您可以输入您要使用的镜像的 URL。有关发行镜像的更多信息，请参阅发行镜像。仅支持 OpenShift Container Platform 版本 4.6.x 或更高版本的发行镜像。

节点池包括 control plane 池和 worker 池。control plane 节点共享集群活动的管理。如果受管集群的构架类型与 hub 集群的架构不同，请为池中机器的说明集合架构输入一个值。有效值为 amd64, ppc64le, s390x, 和 arm64。

您必须为 control plane 池添加实例类型，但您可以在创建后更改实例的类型和大小。

您可以在 worker 池中创建一个或多个 worker 节点，以运行集群的容器工作负载。它们可以位于单个 worker 池中，也可以分布在多个 worker 池中。如果指定了零个 worker 节点，control plane 节点也充当 worker 节点。该信息包括以下字段：

集群需要网络详情。您必须为 IPv4 网络提供一个或多个网络的值。对于 IPv6 网络，您必须定义多个网络。

您可以通过点 Add network 来添加额外网络。如果您使用的是 IPv6 地址，您必须有多个网络。

凭证中提供的代理信息会自动添加到代理字段中。您可以使用信息原样，覆盖这些信息，或者在要启用代理时添加信息。以下列表包含创建代理所需的信息：

您可以点 Disconnected 安装来定义断开连接的安装镜像。当使用 Red Hat OpenStack Platform 供应商和断开连接的安装创建集群时，如果需要一个证书才能访问镜像 registry，在配置集群时需要在 Configuration for disconnected installation 段中的 Additional trust bundle 字段中输入它，在创建集群时在 Disconnected installation 段中输入它。

当您在创建集群前查看信息并选择性地自定义它时，您可以点 YAML 切换 On 查看面板中的 install-config.yaml 文件内容。如果有更新，您可以使用自定义设置编辑 YAML 文件。

在创建使用内部证书颁发机构(CA)的集群时，您需要通过完成以下步骤为集群自定义 YAML 文件：

如果您使用 Red Hat Advanced Cluster Management for Kubernetes，并希望将受管集群 klusterlet 配置为在特定节点上运行，请参阅 可选：将 klusterlet 配置为在特定节点上运行。

注： 您不必运行随集群提供的集群详情的 oc 命令。创建集群时，它由 multicluster engine operator 管理自动配置。

如需了解更多与访问集群相关的信息，继续访问集群。

在 Red Hat Virtualization 上创建集群前请查看以下先决条件（已弃用）：

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

要从 multicluster engine operator 控制台创建集群，请进入到 Infrastructure > Clusters。在 Clusters 页面上，点 Create cluster 并完成控制台中的步骤。

注： 此过程用于创建集群。如果您有一个要导入的现有集群，请参阅集群 导入 以了解这些步骤。

如果您需要创建凭证，请参阅为 Red Hat Virtualization 创建凭证。

集群名称用于集群的主机名。

重要： 当您创建集群时，控制器会为集群及其资源创建一个命名空间。确保只在该命名空间中包含该集群实例的资源。销毁集群会删除命名空间和所有资源。

提示： 在控制台中输入信息时，选择 YAML: On 查看内容更新。

如果要将集群添加到现有的集群集中，则需要在集群设置上具有正确的权限来添加它。如果在创建集群时没有 cluster-admin 权限，则必须选择一个具有 clusterset-admin 权限的集群集。如果您在指定的集群集中没有正确的权限，集群创建会失败。如果您没有任何集群集选项，请联络您的集群管理员，为集群集提供 clusterset-admin 权限。

每个受管集群都必须与受管集群集关联。如果您没有将受管集群分配给 ManagedClusterSet，则会自动添加到 default 受管集群集中。

如果已有与您为 Red Hat Virtualization 帐户配置的所选凭证关联的基本 DNS 域，则该值会在那个字段中填充。您可以覆盖该值来更改它。

发行镜像标识用于创建集群的 OpenShift Container Platform 镜像的版本。如果要使用的版本可用，您可以从镜像列表中选择镜像。如果您要使用的镜像不是标准镜像，您可以输入您要使用的镜像的 URL。有关发行镜像的更多信息，请参阅发行镜像。

节点池的信息包括 control plane 池的内核、插槽、内存和磁盘大小。这三个 control plane 节点共享集群活动的管理。该信息包括 Architecture 字段。查看以下字段描述：

worker 池信息需要池名称、内核数量、内存分配、磁盘大小分配和 worker 池的节点数。worker 池中的 worker 节点可以在单个 worker 池中，也可以分布到多个 worker 池中。

您预先配置的 oVirt 环境中需要以下网络详情。

凭证中提供的代理信息会自动添加到代理字段中。您可以使用信息原样，覆盖这些信息，或者在要启用代理时添加信息。以下列表包含创建代理所需的信息：

当您在创建集群前查看信息并选择性地自定义它时，您可以点 YAML 切换 On 查看面板中的 install-config.yaml 文件内容。如果有更新，您可以使用自定义设置编辑 YAML 文件。

如果您使用 Red Hat Advanced Cluster Management for Kubernetes，并希望将受管集群 klusterlet 配置为在特定节点上运行，请参阅 可选：将 klusterlet 配置为在特定节点上运行。

注： 您不必运行随集群提供的集群详情的 oc 命令。创建集群时，它由 multicluster engine operator 管理自动配置。

如需了解更多与访问集群相关的信息，继续访问集群。

在内部环境中创建集群前需要满足以下先决条件：

要从控制台创建集群，请完成以下步骤：

以下选项可用于您的支持安装：

如果您需要创建凭证，请参阅 为内部环境创建凭证。

集群的名称用于集群的主机名。

重要： 当您创建集群时，控制器会为集群及其资源创建一个命名空间。确保只在该命名空间中包含该集群实例的资源。销毁集群会删除命名空间和所有资源。

注： 选择 YAML: On 在控制台中输入信息时查看内容更新。

如果要将集群添加到现有的集群集中，则需要在集群设置上具有正确的权限来添加它。如果在创建集群时没有 cluster-admin 权限，则必须选择一个具有 clusterset-admin 权限的集群集。如果您在指定的集群集中没有正确的权限，集群创建会失败。如果您没有任何集群集选项，请联络您的集群管理员，为集群集提供 clusterset-admin 权限。

每个受管集群都必须与受管集群集关联。如果您没有将受管集群分配给 ManagedClusterSet，则会自动添加到 default 受管集群集中。

如果已有与您为供应商帐户配置的所选凭证关联的基本 DNS 域，则该值会在那个字段中填充。您可以通过覆盖它来更改值，但创建集群后无法更改此设置。此基础域用于创建到 OpenShift Container Platform 集群组件的路由。它在集群供应商的 DNS 中被配置为授权起始(SOA)记录。

OpenShift 版本 标识用于创建集群的 OpenShift Container Platform 镜像的版本。如果要使用的版本可用，您可以从镜像列表中选择镜像。如果您要使用的镜像不是标准镜像，您可以输入您要使用的镜像的 URL。请参阅 发行镜像 以了解更多信息。

当您选择受支持的 OpenShift Container Platform 版本时，会显示 安装单节点 OpenShift 的选项。单节点 OpenShift 集群仅包含一个节点，用于托管 control plane 服务和用户工作负载。请参阅 将主机扩展到基础架构环境，以了解有关在创建节点后向单节点 OpenShift 集群添加节点的更多信息。

如果您希望集群是一个单节点 OpenShift 集群，请选择 单节点 OpenShift 选项。您可以通过完成以下步骤，向单节点 OpenShift 集群添加额外的 worker：

注： 单节点 OpenShift control plane 需要 8 个 CPU 内核，而多节点 control plane 集群的 control plane 节点只需要 4 个 CPU 内核。

查看并保存集群后，您的集群将保存为集群草稿。您可以通过在 Clusters 页面中选择集群名称来关闭创建过程，并在稍后完成该过程。

如果您使用的是现有主机，请选择是否要自行选择主机，还是自动选择它们。主机数量取决于您选择的节点数量。例如，单节点 OpenShift 集群只需要一个主机，而标准的三节点集群需要三个主机。

主机位置列表中显示了满足此集群要求的可用主机位置。对于主机的分发和更加高可用性的配置，请选择多个位置。

如果您要发现没有现有基础架构环境的新主机，请使用 Discovery Image 完成将主机添加到主机清单中的步骤。

绑定主机以及验证通过后，通过添加以下 IP 地址完成集群的网络信息：

如果您使用 Red Hat Advanced Cluster Management for Kubernetes，并希望将受管集群 klusterlet 配置为在特定节点上运行，请参阅 可选：将 klusterlet 配置为在特定节点上运行。

您可以在 Clusters 导航页面中查看安装状态。

如需了解更多与访问集群相关的信息，继续访问集群。

您还可以使用中央基础架构管理组件中的辅助安装程序功能在没有控制台的情况下创建集群。完成此步骤后，您可以从生成的发现镜像引导主机。步骤的顺序通常并不重要，但在有必要顺序时请注意。

apiVersion: v1
kind: Namespace
metadata:
  name: sample-namespace

apiVersion: v1
kind: Secret
type: kubernetes.io/dockerconfigjson
metadata:
  name: <pull-secret>
  namespace: sample-namespace
stringData:
  .dockerconfigjson: 'your-pull-secret-json' 1

apiVersion: hive.openshift.io/v1
kind: ClusterImageSet
metadata:
  name: openshift-v4.12.0
spec:
  releaseImage: quay.io/openshift-release-dev/ocp-release:4.12.0-rc.0-x86_64

apiVersion: hive.openshift.io/v1
kind: ClusterDeployment
metadata:
  name: single-node
  namespace: demo-worker4
spec:
  baseDomain: hive.example.com
  clusterInstallRef:
    group: extensions.hive.openshift.io
    kind: AgentClusterInstall
    name: test-agent-cluster-install 1
    version: v1beta1
  clusterName: test-cluster
  controlPlaneConfig:
    servingCertificates: {}
  platform:
    agentBareMetal:
      agentSelector:
        matchLabels:
          location: internal
  pullSecretRef:
    name: <pull-secret> 2

apiVersion: extensions.hive.openshift.io/v1beta1
kind: AgentClusterInstall
metadata:
  name: test-agent-cluster-install
  namespace: demo-worker4
spec:
  platformType: BareMetal 1
  clusterDeploymentRef:
    name: single-node 2
  imageSetRef:
    name: openshift-v4.12.0 3
  networking:
    clusterNetwork:
    - cidr: 10.128.0.0/14
      hostPrefix: 23
    machineNetwork:
    - cidr: 192.168.111.0/24
    serviceNetwork:
    - 172.30.0.0/16
  provisionRequirements:
    controlPlaneAgents: 1
  sshPublicKey: ssh-rsa <your-public-key-here> 4

apiVersion: agent-install.openshift.io/v1beta1
kind: NMStateConfig
metadata:
  name: <mynmstateconfig>
  namespace: <demo-worker4>
  labels:
    demo-nmstate-label: <value>
spec:
  config:
    interfaces:
      - name: eth0
        type: ethernet
        state: up
        mac-address: 02:00:00:80:12:14
        ipv4:
          enabled: true
          address:
            - ip: 192.168.111.30
              prefix-length: 24
          dhcp: false
      - name: eth1
        type: ethernet
        state: up
        mac-address: 02:00:00:80:12:15
        ipv4:
          enabled: true
          address:
            - ip: 192.168.140.30
              prefix-length: 24
          dhcp: false
    dns-resolver:
      config:
        server:
          - 192.168.126.1
    routes:
      config:
        - destination: 0.0.0.0/0
          next-hop-address: 192.168.111.1
          next-hop-interface: eth1
          table-id: 254
        - destination: 0.0.0.0/0
          next-hop-address: 192.168.140.1
          next-hop-interface: eth1
          table-id: 254
  interfaces:
    - name: "eth0"
      macAddress: "02:00:00:80:12:14"
    - name: "eth1"
      macAddress: "02:00:00:80:12:15"

apiVersion: agent-install.openshift.io/v1beta1
kind: InfraEnv
metadata:
  name: myinfraenv
  namespace: demo-worker4
spec:
  clusterRef:
    name: single-node  1
    namespace: demo-worker4 2
  pullSecretRef:
    name: pull-secret
    sshAuthorizedKey: <your_public_key_here> 3
  nmStateConfigLabelSelector:
    matchLabels:
      demo-nmstate-label: value 4

要配置 AgentClusterInstall 代理，请将 代理设置 添加到 AgentClusterInstall 资源中。请参阅以下带有 httpProxy、httpsProxy 和 noProxy 的 YAML 示例：

apiVersion: extensions.hive.openshift.io/v1beta1
kind: AgentClusterInstall
spec:
  proxy:
    httpProxy: http://<username>:<password>@<proxy.example.com>:<port> 1
    httpsProxy: https://<username>:<password>@<proxy.example.com>:<port> 2
    noProxy: <wildcard-of-domain>,<provisioning-network/CIDR>,<BMC-address-range/CIDR> 3

所需的用户类型或访问权限级别：集群管理员

如果需要创建新的 pull secret，请完成以下步骤：

您可以从控制台为每个可用的云供应商导入现有集群。

注： hub 集群无法管理不同的 hub 集群。hub 集群被设置为自动导入和管理自身，因此您不必手动导入 hub 集群来管理自己。

默认情况下，命名空间用于集群名称和命名空间，但您可以更改它。

重要： 当您创建集群时，控制器会为集群及其资源创建一个命名空间。确保只在该命名空间中包含该集群实例的资源。销毁集群会删除命名空间和所有资源。

每个受管集群都必须与受管集群集关联。如果您没有将受管集群分配给 ManagedClusterSet，集群会自动添加到 默认 受管集群集中。

如果要将集群添加到不同的集群集合中，则必须对集群集具有 clusterset-admin 权限。如果在导入集群时没有 cluster-admin 权限，则必须选择一个具有 clusterset-admin 权限的集群集。如果您在指定集群集中没有正确的权限，集群导入会失败。如果没有要选择的集群设置选项，请联系集群管理员，为集群集提供 clusterset-admin 权限。

如果您导入了 OpenShift Container Platform Dedicated 集群，且没有为 vendor=OpenShiftDedicated 指定一个标签，或者为 vendor=auto-detect 添加标签，则 managed-by=platform 标签会自动添加到集群中。您可以使用此添加的标签将集群识别为 OpenShift Container Platform Dedicated 集群，并作为一个组检索 OpenShift Container Platform Dedicated 集群。

下表提供了 导入模式 的可用选项，它指定了导入集群的方法：

注： 您必须已从 OperatorHub 安装 Red Hat Ansible Automation Platform Resource Operator，以创建并运行 Ansible Automation Platform 作业。

要配置集群 API 地址，请参阅 可选：配置集群 API 地址。

要将受管集群 klusterlet 配置为在特定节点上运行，请参阅 可选：将 klusterlet 配置为在特定节点上运行。

完成以下步骤以删除导入的集群以及在受管集群上创建的 open-cluster-management-agent-addon。

在 Clusters 页面上，点 Actions > Detach cluster 从管理中删除集群。

注意： 如果您试图分离名为 local-cluster 的 hub 集群，请注意 disableHub selfManagement 的默认设置为 false 。此设置会导致 hub 集群在分离时会重新导入自己并管理自己，并协调 MultiClusterHub 控制器。hub 集群可能需要几小时时间来完成分离过程并重新导入。如果要在等待进程完成的情况下重新导入 hub 集群，您可以运行以下命令来重启 multiclusterhub-operator pod 并更快地重新导入：

oc delete po -n open-cluster-management `oc get pod -n open-cluster-management | grep multiclusterhub-operator| cut -d' ' -f1`

您可以通过将 disableHubSelfManagement 值改为 true 来更改 hub 集群的值，使其不会自动导入。如需更多信息，请参阅 disableHubSelfManagement 主题。

在使用 CLI 导入受管集群前，您必须完成以下步骤：

现在，您可以使用 自动导入 secret 或 手动导入集群来继续导入集群。

要使用自动导入 secret 导入受管集群，您必须创建一个 secret，其中包含集群的 kubeconfig 文件，或 kube API 服务器和集群的令牌对。完成以下步骤，使用自动导入 secret 导入集群：

现在 ，您可以继续导入 klusterlet 附加组件。

重要： 导入命令包含复制到每个导入的受管集群中的 pull secret 信息。具有访问导入集群权限的所有用户都可以查看 pull secret 信息。

完成以下步骤以手动导入受管集群：

现在 ，您可以继续导入 klusterlet 附加组件。

实现 KlusterletAddonConfig klusterlet 附加组件配置，以在受管集群上启用其他附加组件。通过完成以下步骤来创建并应用配置文件：

要使用命令行界面删除受管集群，请运行以下命令：

oc delete managedcluster <cluster_name>

将 <cluster_name > 替换为集群的名称。

要使用代理注册端点导入受管集群，请完成以下步骤：

完成以下步骤，手动导入 OpenShift Container Platform 集群，没有静态网络或裸机主机，并准备好添加节点：

完成以下步骤以导入使用 ManagedClusterImageRegistry 自定义资源定义自定义的集群：