11.2. Cluster API の使用開始

手順

1. 次の例のような YAML ファイルを作成します。この手順では、ファイル名の例として <machine_template_resource_file>.yaml を使用します。

   apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
   kind: <machine_template_kind>
   metadata:
     name: <template_name>
     namespace: openshift-cluster-api
   spec:
     template:
       spec:

   各項目の説明:

   kind

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

   次の値が有効です。

   Expand

   クラスターインフラストラクチャープロバイダー	値
   Amazon Web Services (AWS)	AWSMachineTemplate
   Google Cloud	GCPMachineTemplate
   Microsoft Azure	AzureMachineTemplate
   Red Hat OpenStack Platform (RHOSP)	OpenStackMachineTemplate
   VMware vSphere	VSphereMachineTemplate
   ベアメタル	Metal3MachineTemplate

   Show more

   metadata.name

   マシンテンプレートの名前を指定します。

   spec.template.spec

   環境の詳細を指定します。これらのパラメーターはプロバイダー固有です。詳細は、各プロバイダーの 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>
     namespace: openshift-cluster-api
   spec:
     clusterName: <cluster_name>
     replicas: 1
     selector:
       matchLabels:
         test: example
     template:
       metadata:
         labels:
           test: example
       spec:
   # ...

   各項目の説明:

   metadata.name

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

   spec.clusterName

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

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

   spec.template.spec

   環境の詳細を指定します。これらのパラメーターはプロバイダー固有です。詳細は、各プロバイダーの 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 の値が一致します。コンピュートマシンセットが使用できない場合は、数分待ってからコマンドを再実行してください。