12.2. control plane 机器集入门

1. 从 4.11 或更早版本升级的 AWS 集群需要激活 CR。
2. 从 4.12 或更早版本升级的 Google Cloud 和 Azure 集群 需要激活 CR。
3. 从 4.13 或更早版本升级的 Nutanix 和 RHOSP 集群 需要激活 CR。
4. 从 4.15 或更早版本升级的 vSphere 集群需要激活 CR。

流程

1. 运行以下命令，查看 CR 的配置：

   $ oc --namespace openshift-machine-api edit controlplanemachineset.machine.openshift.io cluster

   Copy to Clipboard Toggle word wrap
2. 更改集群配置不正确的字段的值。

3. 当配置正确时，通过将 .spec.state 字段设置为 Active 并保存您的更改来激活 CR。

   重要

   要激活 CR，您必须在用来更新 CR 配置的同一 oc edit 会话中将 .spec.state 字段改为 Active。如果 CR 保存为 Inactive，control plane 机器集生成器会将 CR 重置为其原始设置。

流程

1. 使用以下模板创建 YAML 文件：

   control plane 机器集 CR YAML 文件模板

   apiVersion: machine.openshift.io/v1
   kind: ControlPlaneMachineSet
   metadata:
     name: cluster
     namespace: openshift-machine-api
   spec:
     replicas: 3
     selector:
       matchLabels:
         machine.openshift.io/cluster-api-cluster: <cluster_id> 

   1

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

   2

   
     strategy:
       type: RollingUpdate 

   3

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

   4

   
           <platform_failure_domains> 

   5

   
         metadata:
           labels:
             machine.openshift.io/cluster-api-cluster: <cluster_id> 

   6

   
             machine.openshift.io/cluster-api-machine-role: master
             machine.openshift.io/cluster-api-machine-type: master
         spec:
           providerSpec:
             value:
               <platform_provider_spec> 

   7

   Copy to Clipboard Toggle word wrap

   1

   指定基于置备集群时所设置的集群 ID 的基础架构 ID。在创建 ControlPlaneMachineSet CR 时，您必须指定这个值。如果已安装 OpenShift CLI（oc）软件包，您可以通过运行以下命令来获取基础架构 ID：

   $ oc get -o jsonpath='{.status.infrastructureName}{"\n"}' infrastructure cluster

   Copy to Clipboard Toggle word wrap

   2

   指定 Operator 的状态。当状态为 Inactive 时，Operator 无法正常工作。您可以通过将值设置为 Active 来激活 Operator。

   重要

   在激活 CR 前，您必须确保其配置正确并满足集群要求。

   3

   指定集群的更新策略。有效值为 OnDelete 和 RollingUpdate。默认值为 RollingUpdate。有关更新策略的更多信息，请参阅"更新 control plane 配置"。

   4

   指定您的云供应商平台名称。有效值为 AWS、Azure、GCP、Nutanix、VSphere 和 OpenStack。

   5

   为集群添加 <platform_failure_domains> 配置。本节的格式和值特定于提供程序。如需更多信息，请参阅您的云供应商的故障域配置示例。

   6

   指定基础架构 ID。

   7

   为集群添加 <platform_provider_spec> 配置。本节的格式和值特定于提供程序。如需更多信息，请参阅云供应商的供应商规格示例。

2. 请参阅 control plane 机器集 CR 的示例 YAML，并使用适合集群配置的值填充该文件。
3. 请参阅云供应商的示例故障域配置和示例供应商规格，并使用适当的值更新您的文件的这些部分。
4. 当配置正确时，通过将 .spec.state 字段设置为 Active 并保存您的更改来激活 CR。

5. 运行以下命令，从 YAML 文件创建 CR：

   $ oc create -f <control_plane_machine_set>.yaml

   Copy to Clipboard Toggle word wrap

   其中 <control_plane_machine_set> 是包含 CR 配置的 YAML 文件的名称。