11.2. Cluster API 入门

流程

1. 创建一个类似如下的 YAML 文件：此流程使用 <machine_template_resource_file>.yaml 作为示例文件名。

   apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
   kind: <machine_template_kind> 

   1

   
   metadata:
     name: <template_name> 

   2

   
     namespace: openshift-cluster-api
   spec:
     template:
       spec: 

   3

   Copy to Clipboard Toggle word wrap

   1

   指定机器模板类型。这个值必须与您的平台的值匹配。以下值有效：

   Expand

   集群基础架构供应商	value
   Amazon Web Services (AWS)	AWSMachineTemplate
   Google Cloud Platform (GCP)	GCPMachineTemplate
   Microsoft Azure	AzureMachineTemplate
   Red Hat OpenStack Platform (RHOSP)	OpenStackMachineTemplate
   VMware vSphere	VSphereMachineTemplate
   裸机	Metal3MachineTemplate

   Show more

   2

   为机器模板指定名称。

   3

   指定您的环境的详情。这些参数特定于具体的供应商。如需更多信息，请参阅您的供应商的 Cluster API 机器模板 YAML 示例。

2. 运行以下命令来创建虚拟机模板 CR：

   $ oc create -f <machine_template_resource_file>.yaml

   Copy to Clipboard Toggle word wrap

流程

1. 创建一个类似如下的 YAML 文件：此流程使用 <machine_set_resource_file>.yaml 作为示例文件名。

   apiVersion: cluster.x-k8s.io/v1beta1
   kind: MachineSet
   metadata:
     name: <machine_set_name> 

   1

   
     namespace: openshift-cluster-api
   spec:
     clusterName: <cluster_name> 

   2

   
     replicas: 1
     selector:
       matchLabels:
         test: example
     template:
       metadata:
         labels:
           test: example
       spec: 

   3

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   为计算机器设置指定一个名称。集群 ID、机器角色和区域形成一个典型模式，格式为：<cluster_name>-<role>-<region>。

   2

   指定集群的名称。运行以下命令来获取集群 ID 的值：

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

   Copy to Clipboard Toggle word wrap

   3

   指定您的环境的详情。这些参数特定于具体的供应商。如需更多信息，请参阅您的供应商的 Cluster API 计算机器设置 YAML 示例。

2. 运行以下命令来创建计算机器设置 CR：

   $ oc create -f <machine_set_resource_file>.yaml

   Copy to Clipboard Toggle word wrap

3. 运行以下命令确认已创建了计算机器设置 CR：

   $ oc get machineset.cluster.x-k8s.io -n openshift-cluster-api

   Copy to Clipboard Toggle word wrap

   输出示例

   NAME                 CLUSTER          REPLICAS   READY   AVAILABLE   AGE   VERSION
   <machine_set_name>   <cluster_name>   1          1       1           17m

   Copy to Clipboard Toggle word wrap

   当新的计算机器集可用时，REPLICAS 和 AVAILABLE 值会匹配。如果 compute 机器集不可用，请等待几分钟，然后再次运行命令。

流程

1. 运行以下命令，识别您要迁移到 Cluster API 资源的 Machine API 资源：

   $ oc get <resource_kind> -n openshift-machine-api

   Copy to Clipboard Toggle word wrap

   其中 <resource_kind> 是以下值之一：

   machine.machine.openshift.io

   compute 或 control plane 机器的资源类型的完全限定名称。

   machineset.machine.openshift.io

   计算机器设置的资源 kind 的完全限定名称。

2. 运行以下命令来编辑资源规格：

   $ oc edit <resource_kind>/<resource_name> -n openshift-machine-api

   Copy to Clipboard Toggle word wrap

   其中：

   <resource_kind>

   使用 machine.machine.openshift.io 指定计算机器，使用 machineset.machine.openshift.io 指定计算 机器集

   <resource_name>

   指定您要迁移到 Cluster API 资源的 Machine API 资源的名称。

3. 在资源规格中，更新 spec.authoritativeAPI 字段的值：

   apiVersion: machine.openshift.io/v1beta1
   kind: <resource_kind> 

   1

   
   metadata:
     name: <resource_name> 

   2

   
     [...]
   spec:
     authoritativeAPI: ClusterAPI 

   3

   
     [...]
   status:
     authoritativeAPI: MachineAPI 

   4

   
     [...]

   Copy to Clipboard Toggle word wrap

   1

   资源类型因资源类型而异。例如，计算机器集的资源类型是 MachineSet，计算机器的资源类型是 Machine。

   2

   要迁移的资源的名称。

   3

   指定希望此资源使用的权威 API。例如，要开始将 Machine API 资源迁移到 Cluster API，请指定 ClusterAPI。

   4

   当前权威 API 的值。这个值表示当前管理此资源的 API。不要更改规范的这个部分中的值。

流程

1. 运行以下命令，列出集群中的 Machine API 计算机器集：

   $ oc get machineset.machine.openshift.io -n openshift-machine-api

   Copy to Clipboard Toggle word wrap

2. 运行以下命令来编辑资源规格：

   $ oc edit machineset.machine.openshift.io <machine_set_name> \
     -n openshift-machine-api

   Copy to Clipboard Toggle word wrap

   其中 <machine_set_name> 是您要配置为部署 Cluster API 计算机器的 Machine API 计算机器集的名称。

3. 在资源规格中，更新 spec.template.spec.authoritativeAPI 字段的值：

   apiVersion: machine.openshift.io/v1beta1
   kind: MachineSet
   metadata:
     [...]
     name: <machine_set_name>
     [...]
   spec:
     authoritativeAPI: MachineAPI 

   1

   
     [...]
     template:
       [...]
       spec:
         authoritativeAPI: ClusterAPI 

   2

   
   status:
     authoritativeAPI: MachineAPI 

   3

   
     [...]

   Copy to Clipboard Toggle word wrap

   1

   Machine API 计算机器集的为转换的值。不要更改规范的这个部分中的值。

   2

   指定 ClusterAPI，将计算机器集配置为部署 Cluster API 计算机器。

   3

   Machine API 计算机器集的当前值。不要更改规范的这个部分中的值。

验证

1. 运行以下命令，列出由更新的计算机器集管理的机器：

   $ oc get machines.machine.openshift.io \
     -n openshift-machine-api \
     -l machine.openshift.io/cluster-api-machineset=<machine_set_name>

   Copy to Clipboard Toggle word wrap

2. 要验证更新的机器集创建的机器是否有正确的配置，请运行以下命令来检查 CR 中的 status.authoritativeAPI 字段：

   $ oc describe machines.machine.openshift.io <machine_name> \
     -n openshift-machine-api

   Copy to Clipboard Toggle word wrap

   对于 Cluster API 计算机器，字段的值是 ClusterAPI。