13.2. Cluster API 入门

流程

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

   apiVersion: cluster.x-k8s.io/v1beta1
   kind: Cluster
   metadata:
     name: <cluster_name> 1
     namespace: openshift-cluster-api
   spec:
     infrastructureRef:
       apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
       kind: <infrastructure_kind> 2
       name: <cluster_name>
       namespace: openshift-cluster-api

   1

   指定集群 ID 作为集群的名称。

   2

   指定集群的基础架构类型。以下值有效：

   • AWSCluster ：集群在 Amazon Web Services (AWS) 上运行。
   • GCPCluster ：集群在 Google Cloud Platform (GCP) 上运行。
   • VSphereCluster ：集群在 VMware vSphere 上运行。

2. 运行以下命令来创建集群 CR：

   $ oc create -f <cluster_resource_file>.yaml

流程

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

   apiVersion: infrastructure.cluster.x-k8s.io/<version> 1
   kind: <infrastructure_kind> 2
   metadata:
     name: <cluster_name> 3
     namespace: openshift-cluster-api
   spec: 4

   1

   apiVersion 因平台而异。如需更多信息，请参阅您的供应商的 Cluster API 基础架构资源 YAML 示例。以下值有效：

   • infrastructure.cluster.x-k8s.io/v1beta2: Amazon Web Services (AWS) 集群使用的版本。
   • infrastructure.cluster.x-k8s.io/v1beta1 ：Google Cloud Platform (GCP) 和 VMware vSphere 集群使用的版本。

   2

   指定集群的基础架构类型。这个值必须与您的平台的值匹配。以下值有效：

   • AWSCluster：集群在 AWS 上运行。
   • GCPCluster：集群在 GCP 上运行。
   • VSphereCluster：集群在 vSphere 上运行。

   3

   指定集群的名称。

   4

   指定您的环境的详情。这些参数特定于具体的供应商。如需更多信息，请参阅您的供应商的 Cluster API 基础架构资源 YAML 示例。

2. 运行以下命令来创建基础架构 CR：

   $ oc create -f <infrastructure_resource_file>.yaml

流程

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

   1

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

   • AWSMachineTemplate：集群在 Amazon Web Services (AWS) 上运行。
   • gcpmachinetemplate：集群在 Google Cloud Platform (GCP) 上运行。
   • VSphereMachineTemplate ：集群在 VMware vSphere 上运行。

   2

   为机器模板指定名称。

   3

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

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

   $ oc create -f <machine_template_resource_file>.yaml

流程

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
   # ...

   1

   为计算机器设置指定一个名称。

   2

   指定集群的名称。

   3

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

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

   $ oc create -f <machine_set_resource_file>.yaml

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

   $ oc get machineset -n openshift-cluster-api 1

   1

   指定 openshift-cluster-api 命名空间。

   输出示例

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

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