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) で実行されている場合。

2. 次のコマンドを実行して、クラスターを作成します。

   $ 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/v1beta1: Google Cloud Platform (GCP) クラスターが使用するバージョン。
   • Infrastructure.cluster.x-k8s.io/v1beta1: Amazon Web Services (AWS) クラスターが使用するバージョン。

   2

   クラスターのインフラストラクチャーの種類を指定します。この値は、プラットフォームの値と一致する必要があります。次の値が有効です。

   • AWSCluster: クラスターが AWS 上で実行されている場合。
   • GCPCluster: クラスターが GCP 上で実行されている場合。

   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) 上で実行されている場合。

   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 namespace を指定します。

   出力例

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

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