2.2. 既存の Nutanix クラスターへの障害ドメインの追加

手順

1. 次のコマンドを実行して、クラスターのインフラストラクチャー CR を表示します。

   $ oc describe infrastructures.config.openshift.io cluster

2. 各障害ドメイン (platformSpec.nutanix.failureDomains) について、クラスターの UUID、名前、サブネットオブジェクト UUID をメモします。これらの値は、障害ドメインをコンピュートマシンセットに追加するために必要です。

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

   $ oc get machinesets -n openshift-machine-api

   出力例

   NAME                   DESIRED   CURRENT   READY   AVAILABLE   AGE
   <machine_set_name_1>   1         1         1       1           55m
   <machine_set_name_2>   1         1         1       1           55m

4. 次のコマンドを実行して、最初のコンピュートマシンセットを編集します。

   $ oc edit machineset <machine_set_name_1> -n openshift-machine-api

5. spec.template.spec.providerSpec.value スタンザを次のように更新して、最初の障害ドメインを使用するようにコンピュートマシンセットを設定します。

   注記

   cluster および subnets フィールドに指定する値が、クラスターのインフラストラクチャー CR の failureDomains スタンザに設定されている値と一致していることを確認してください。

   Nutanix 障害ドメインを使用したコンピュートマシンセットの例

   apiVersion: machine.openshift.io/v1
   kind: MachineSet
   metadata:
     creationTimestamp: null
     labels:
       machine.openshift.io/cluster-api-cluster: <cluster_name>
     name: <machine_set_name_1>
     namespace: openshift-machine-api
   spec:
     replicas: 2
   # ...
     template:
       spec:
   # ...
         providerSpec:
           value:
             apiVersion: machine.openshift.io/v1
             failureDomain:
               name: <failure_domain_name_1>
             cluster:
               type: uuid
               uuid: <prism_element_uuid_1>
             subnets:
             - type: uuid
               uuid: <prism_element_network_uuid_1>
   # ...

6. spec.replicas の値をメモします。この値は、変更を適用するためにコンピュートマシンセットをスケーリングする際に必要になるためです。
7. 変更を保存します。

8. 次のコマンドを実行して、更新されたコンピュートマシンセットによって管理されているマシンをリスト表示します。

   $ oc get -n openshift-machine-api machines \
     -l machine.openshift.io/cluster-api-machineset=<machine_set_name_1>

   出力例

   NAME                        PHASE     TYPE   REGION    ZONE                 AGE
   <machine_name_original_1>   Running   AHV    Unnamed   Development-STS   4h
   <machine_name_original_2>   Running   AHV    Unnamed   Development-STS   4h

9. 次のコマンドを実行して、更新されたコンピュートマシンセットで管理されるマシンごとに delete アノテーションを設定します。

   $ oc annotate machine/<machine_name_original_1> \
     -n openshift-machine-api \
     machine.openshift.io/delete-machine="true"

10. 代わりとなるマシンを新しい設定で作成するために、次のコマンドを実行して、コンピュートマシンセットをレプリカ数の 2 倍にスケーリングします。

    $ oc scale --replicas=<twice_the_number_of_replicas> \1
      machineset <machine_set_name_1> \
      -n openshift-machine-api

    1

    たとえば、コンピュートマシンセット内のレプリカの元の数が 2 の場合、レプリカを 4 にスケーリングします。

11. 次のコマンドを実行して、更新されたコンピュートマシンセットによって管理されているマシンをリスト表示します。

    $ oc get -n openshift-machine-api machines -l machine.openshift.io/cluster-api-machineset=<machine_set_name_1>

    新しいマシンが Running フェーズにある場合、コンピュートマシンセットを元のレプリカ数にスケーリングできます。

12. 古い設定で作成されたマシンを削除するために、次のコマンドを実行して、コンピュートマシンセットを元のレプリカ数にスケーリングします。

    $ oc scale --replicas=<original_number_of_replicas> \1
      machineset <machine_set_name_1> \
      -n openshift-machine-api

    1

    たとえば、コンピュートマシンセット内のレプリカの元の数が 2 であった場合、レプリカを 2 にスケーリングします。

13. 必要に応じて、デプロイメントで使用可能な追加の障害ドメインを参照するようにマシンセットの変更を続けます。

手順

1. 次のコマンドを実行して、クラスターのインフラストラクチャー CR を表示します。

   $ oc describe infrastructures.config.openshift.io cluster

2. 各障害ドメイン (platformSpec.nutanix.failureDomains) について、クラスターの UUID、名前、サブネットオブジェクト UUID をメモします。これらの値は、障害ドメインをコンピュートマシンセットに追加するために必要です。

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

   $ oc get machinesets -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

4. 既存のコンピュートマシンセットの名前に注意してください。

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

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

     $ oc get machineset <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 machineset <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> 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>
       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>
         spec:
           providerSpec: 3
             ...

     1

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

     2

     デフォルトのノードラベル。

     注記

     user-provisioned infrastructure を持つクラスターの場合、コンピュートマシンセットが作成できるのは、worker または infra ロールを持つマシンのみです。

     3

     コンピュートマシンセット CR の <providerSpec> セクションの値は、プラットフォーム固有です。CR の <providerSpec> パラメーターの詳細は、プロバイダーのサンプルコンピュートマシンセット CR 設定を参照してください。

6. <new_machine_set_name_1>.yaml ファイルの spec.template.spec.providerSpec.value スタンザを更新または追加して、最初の障害ドメインを使用するように新しいコンピュートマシンセットを設定します。

   注記

   cluster および subnets フィールドに指定する値が、クラスターのインフラストラクチャー CR の failureDomains スタンザに設定されている値と一致していることを確認してください。

   Nutanix 障害ドメインを使用したコンピュートマシンセットの例

   apiVersion: machine.openshift.io/v1
   kind: MachineSet
   metadata:
     creationTimestamp: null
     labels:
       machine.openshift.io/cluster-api-cluster: <cluster_name>
     name: <new_machine_set_name_1>
     namespace: openshift-machine-api
   spec:
     replicas: 2
   # ...
     template:
       spec:
   # ...
         providerSpec:
           value:
             apiVersion: machine.openshift.io/v1
             failureDomain:
               name: <failure_domain_name_1>
             cluster:
               type: uuid
               uuid: <prism_element_uuid_1>
             subnets:
             - type: uuid
               uuid: <prism_element_network_uuid_1>
   # ...

7. 変更を保存します。

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

   $ oc create -f <new_machine_set_name_1>.yaml

9. 必要に応じて、デプロイメントで使用可能な追加の障害ドメインを参照するコンピュートマシンセットの作成に進みます。

10. 新しいコンピュートマシンセットごとに次のコマンドを実行して、新しいコンピュートマシンセットによって管理されているマシンをリスト表示します。

    $ oc get -n openshift-machine-api machines -l machine.openshift.io/cluster-api-machineset=<new_machine_set_name_1>

    出力例

    NAME                             PHASE          TYPE   REGION    ZONE                 AGE
    <machine_from_new_1>             Provisioned    AHV    Unnamed   Development-STS   25s
    <machine_from_new_2>             Provisioning   AHV    Unnamed   Development-STS   25s

    新しいマシンが Running フェーズにある場合、障害ドメイン設定を含まない古いコンピュートマシンセットを削除できます。

11. 新しいマシンが Running フェーズにあることを確認したら、古いコンピュートマシンセットごとに次のコマンドを実行して削除します。

    $ oc delete machineset <original_machine_set_name_1> -n openshift-machine-api