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

   1

   マシンテンプレートの種類を指定します。この値は、プラットフォームの値と一致する必要があります。次の値が有効です。

   Expand

   クラスターインフラストラクチャープロバイダー	値
   Amazon Web Services (AWS)	AWSMachineTemplate
   Google Cloud	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

手順

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

   コンピュートマシンセットの名前を指定します。通常、この値のパターンは、クラスター ID、マシンのロール、およびリージョンにより、<cluster_name>-<role>-<region> という形で構成されます。

   2

   クラスターの名前を指定します。次のコマンドを実行して、クラスター ID 値を取得します。

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

   3

   環境の詳細を指定します。これらのパラメーターはプロバイダー固有です。詳細は、各プロバイダーの Cluster API コンピュートマシンセットのサンプル YAML を参照してください。

2. 次のコンピュートコマンドを実行して、マシンセット CR を作成します。

   $ oc create -f <machine_set_resource_file>.yaml

3. 次のコマンドを実行して、コンピュートマシンセット CR が作成されたことを確認します。

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

   出力例

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

   新しいコンピュートマシンセットが利用可能な場合、REPLICAS と AVAILABLE の値が一致します。コンピュートマシンセットが使用できない場合は、数分待ってからコマンドを再実行してください。