16.4. Outpost にエッジコンピュートマシンをデプロイするコンピュートマシンセットの作成

手順

1. 以下のコマンドを実行して、クラスター内のコンピュートマシンセットを一覧表示します。

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

   出力例

   NAME                            DESIRED   CURRENT   READY   AVAILABLE   AGE
   <original_machine_set_name_1>   1         1         1       1           55m
   <original_machine_set_name_2>   1         1         1       1           55m

2. 既存のコンピュートマシンセットの名前を記録します。

3. 次のいずれかの方法を使用して、新しいコンピュートマシンセットのカスタムリソース (CR) の値を含む YAML ファイルを作成します。

   • 次のコマンドを実行して、既存のコンピュートマシンセット設定を新しいファイルにコピーします。

     $ oc get machinesets.machine.openshift.io <original_machine_set_name_1> \
       -n openshift-machine-api -o yaml > <new_machine_set_name_1>.yaml

     この YAML ファイルは、任意のテキストエディターで編集できます。

   • 任意のテキストエディターを使用して <new_machine_set_name_1>.yaml という名前の空の YAML ファイルを作成し、新しいコンピュートマシンセットに必要な値を含めます。

     特定のフィールドに設定する値がわからない場合は、次のコマンドを実行して、既存のコンピュートマシンセット CR の値を確認できます。

     $ oc get machinesets.machine.openshift.io <original_machine_set_name_1> \
       -n openshift-machine-api -o yaml

     出力例

     apiVersion: machine.openshift.io/v1beta1
     kind: MachineSet
     metadata:
       labels:
         machine.openshift.io/cluster-api-cluster: <infrastructure_id> 1
       name: <infrastructure_id>-<role>-<availability_zone> 2
       namespace: openshift-machine-api
     spec:
       replicas: 1
       selector:
         matchLabels:
           machine.openshift.io/cluster-api-cluster: <infrastructure_id>
           machine.openshift.io/cluster-api-machineset: <infrastructure_id>-<role>-<availability_zone>
       template:
         metadata:
           labels:
             machine.openshift.io/cluster-api-cluster: <infrastructure_id>
             machine.openshift.io/cluster-api-machine-role: <role>
             machine.openshift.io/cluster-api-machine-type: <role>
             machine.openshift.io/cluster-api-machineset: <infrastructure_id>-<role>-<availability_zone>
         spec:
           providerSpec: 3
     # ...

     1

     クラスターインフラストラクチャー ID。

     2

     デフォルトのノードラベル。AWS Outposts の場合は、outposts ロールを使用します。

     3

     省略されている providerSpec セクションには、Outpost 用に設定する必要がある値が含まれています。

4. <new_machine_set_name_1>.yaml ファイルを編集して、Outpost にエッジコンピュートマシンを作成するように新しいコンピュートマシンセットを設定します。

   AWS Outposts 用のコンピュートマシンセットの例

   apiVersion: machine.openshift.io/v1beta1
   kind: MachineSet
   metadata:
     labels:
       machine.openshift.io/cluster-api-cluster: <infrastructure_id> 1
     name: <infrastructure_id>-outposts-<availability_zone> 2
     namespace: openshift-machine-api
   spec:
     replicas: 1
     selector:
       matchLabels:
         machine.openshift.io/cluster-api-cluster: <infrastructure_id>
         machine.openshift.io/cluster-api-machineset: <infrastructure_id>-outposts-<availability_zone>
     template:
       metadata:
         labels:
           machine.openshift.io/cluster-api-cluster: <infrastructure_id>
           machine.openshift.io/cluster-api-machine-role: outposts
           machine.openshift.io/cluster-api-machine-type: outposts
           machine.openshift.io/cluster-api-machineset: <infrastructure_id>-outposts-<availability_zone>
       spec:
         metadata:
           labels:
             node-role.kubernetes.io/outposts: ""
             location: outposts
         providerSpec:
           value:
             ami:
               id: <ami_id> 3
             apiVersion: machine.openshift.io/v1beta1
             blockDevices:
               - ebs:
                   volumeSize: 120
                   volumeType: gp2 4
             credentialsSecret:
               name: aws-cloud-credentials
             deviceIndex: 0
             iamInstanceProfile:
               id: <infrastructure_id>-worker-profile
             instanceType: m5.xlarge 5
             kind: AWSMachineProviderConfig
             placement:
               availabilityZone: <availability_zone>
               region: <region> 6
             securityGroups:
               - filters:
                 - name: tag:Name
                   values:
                     - <infrastructure_id>-worker-sg
             subnet:
               id: <subnet_id> 7
             tags:
               - name: kubernetes.io/cluster/<infrastructure_id>
                 value: owned
             userDataSecret:
               name: worker-user-data
         taints: 8
           - key: node-role.kubernetes.io/outposts
             effect: NoSchedule

   1

   クラスターインフラストラクチャー ID を指定します。

   2

   コンピュートマシンセットの名前を指定します。この名前は、クラスターインフラストラクチャー ID、outposts ロール名、および Outpost のアベイラビリティーゾーンで構成されます。

   3

   Amazon Machine Image (AMI) ID を指定します。

   4

   EBS ボリュームのタイプを指定します。AWS Outposts には gp2 ボリュームが必要です。

   5

   AWS インスタンスのタイプを指定します。Outpost で設定されているインスタンスタイプを使用する必要があります。

   6

   Outpost のアベイラビリティーゾーンが存在する AWS リージョンを指定します。

   7

   Outpost の専用サブネットを指定します。

   8

   node-role.kubernetes.io/outposts ラベルを持つノードでワークロードがスケジュールされないように taint を指定します。Outpost でユーザーのワークロードをスケジュールするには、アプリケーションの Deployment リソースで対応する toleration を指定する必要があります。

5. 変更を保存します。

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

   $ oc create -f <new_machine_set_name_1>.yaml