Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

10.4. control plane 机器集配置

此 YAML 片断示例显示 control plane 机器集自定义资源 (CR) 的基本结构。

ControlPlaneMachineSet CR 的基础构建方式与所有平台相同。

ControlPlaneMachineSet CR YAML 文件示例

apiVersion: machine.openshift.io/v1
kind: ControlPlaneMachineSet
metadata:
  name: cluster
1 

  namespace: openshift-machine-api
spec:
  replicas: 3
2 

  selector:
    matchLabels:
      machine.openshift.io/cluster-api-cluster: <cluster_id>
3 

      machine.openshift.io/cluster-api-machine-role: master
      machine.openshift.io/cluster-api-machine-type: master
  state: Active
4 

  strategy:
    type: RollingUpdate
5 

  template:
    machineType: machines_v1beta1_machine_openshift_io
    machines_v1beta1_machine_openshift_io:
      failureDomains:
        platform: <platform>
6 

        <platform_failure_domains>
7 

      metadata:
        labels:
          machine.openshift.io/cluster-api-cluster: <cluster_id>
          machine.openshift.io/cluster-api-machine-role: master
          machine.openshift.io/cluster-api-machine-type: master
      spec:
        providerSpec:
          value:
            <platform_provider_spec>
8
Copy to Clipboard Toggle word wrap

1
指定 ControlPlaneMachineSet CR 的名称，即 集群。不要更改这个值。
2
指定 control plane 机器的数量。仅支持具有三个 control plane 机器的集群，因此 replicas 值为 3。不支持水平扩展。不要更改这个值。
3
指定基于置备集群时所设置的集群 ID 的基础架构 ID。在创建 ControlPlaneMachineSet CR 时，您必须指定这个值。如果已安装 OpenShift CLI（oc）软件包，您可以通过运行以下命令来获取基础架构 ID： 
$ oc get -o jsonpath='{.status.infrastructureName}{"\n"}' infrastructure cluster
Copy to Clipboard Toggle word wrap
4
指定 Operator 的状态。当状态为 Inactive 时，Operator 无法正常工作。您可以通过将值设置为 Active 来激活 Operator。
重要

在激活 Operator 前，您必须确保 ControlPlaneMachineSet CR 配置适合您的集群要求。有关激活 Control Plane Machine Set Operator 的更多信息，请参阅"使用 control plane 机器集入门"。

5
指定集群的更新策略。允许的值是 OnDelete 和 RollingUpdate。默认值为 RollingUpdate。有关更新策略的更多信息，请参阅"更新 control plane 配置"。
6
指定云供应商平台名称。不要更改这个值。
7
为集群指定 <platform_failure_domains> 配置。本节的格式和值特定于提供程序。如需更多信息，请参阅您的云供应商的故障域配置示例。
8
为集群指定 <platform_provider_spec> 配置。本节的格式和值特定于提供程序。如需更多信息，请参阅云供应商的供应商规格示例。

10.4.2. control plane 机器集配置选项
复制链接

您可以配置 control plane 机器集来根据您的需要自定义集群。

您可以自定义 control plane 机器集创建的机器名称前缀。这可以通过编辑 ControlPlaneMachineSet 自定义资源(CR)来完成。

流程

  1. 运行以下命令来编辑 ControlPlaneMachineSet CR： 

    $ oc edit controlplanemachineset.machine.openshift.io cluster \
  -n openshift-machine-api
    Copy to Clipboard Toggle word wrap

  2. 编辑 ControlPlaneMachineSet CR 的 .spec.machineNamePrefix 字段： 

    apiVersion: machine.openshift.io/v1
kind: ControlPlaneMachineSet
metadata:
  name: cluster
  namespace: openshift-machine-api
spec:
  machineNamePrefix: <machine_prefix>
# ...
    Copy to Clipboard Toggle word wrap

    其中 <machine_prefix> 指定遵循小写 RFC 1123 子域要求的前缀名称。

    重要

    小写 RFC 1123 子域只能包含小写字母数字字符、连字符('-')和句点('.')。每个块（以句点分开）必须以字母数字字符开头和结尾。在块的开头或结尾不允许连字符，且不允许连续的句点。

  3. 保存您的更改。

后续步骤

  • 如果您只更改 machineNamePrefix 参数的值，则使用默认 RollingUpdate 更新策略的集群不会被自动更新。要传播这个更改，无论集群的更新策略是什么，您必须手动替换 control plane 机器。如需更多信息，请参阅"替换 control plane 机器"。

10.4.3. 特定于供应商的配置选项
复制链接

control plane 机器集清单的 <platform_provider_spec> 和 <platform_failure_domains> 部分是特定于供应商的。有关集群的特定于供应商的配置选项，请参阅以下资源：

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat