2.3. Azure でのマシンセットの作成

手順

1. 以下のコマンドを実行してカスタムリソース (CR) を編集します。

   $ oc edit machineset <machine-set-name>

   ここで、<machine-set-name> は、エフェメラル OS ディスクにマシンをプロビジョニングするマシンセットです。

2. 以下を providerSpec フィールドに追加します。

   providerSpec:
     value:
       ...
       osDisk:
          ...
          diskSettings: 1
            ephemeralStorageLocation: Local 2
          cachingType: ReadOnly 3
          managedDisk:
            storageAccountType: Standard_LRS 4
          ...

   1 2 3

   これらの行では、Ephemeral OS ディスクを使用できます。

   4

   一時 OS ディスクは、標準の LRS ストレージのアカウントタイプを使用する仮想マシンまたはスケールセットインスタンスでのみサポートされます。

   重要

   OpenShift Container Platform での Ephemeral OS ディスクのサポートの実装は、CacheDisk 配置タイプのみをサポートします。placement 設定は変更しないでください。

3. 更新された設定を使用してマシンセットを作成します。

   $ oc create -f <machine-set-config>.yaml

手順

1. 次のコマンドを実行して、ワーカーデータシークレットを使用して openshift-machine-api namespace にカスタムシークレットを作成します。

   $ oc -n openshift-machine-api \
   get secret worker-user-data \
   --template='{{index .data.userData | base64decode}}' | jq > userData.txt

   ここで、userData.txt は新しいカスタムシークレットの名前です。

2. テキストエディターで、userData.txt ファイルを開き、ファイル内の最後の } 文字を見つけます。

   1. 直前の行に、, を追加します。

   2. , の後に新しい行を作成し、以下の設定内容を追加します。

      "storage": {
        "disks": [ 1
          {
            "device": "/dev/disk/azure/scsi1/lun0", 2
            "partitions": [ 3
              {
                "label": "lun0p1", 4
                "sizeMiB": 1024, 5
                "startMiB": 0
              }
            ]
          }
        ],
        "filesystems": [ 6
          {
            "device": "/dev/disk/by-partlabel/lun0p1",
            "format": "xfs",
            "path": "/var/lib/lun0p1"
          }
        ]
      },
      "systemd": {
        "units": [ 7
          {
            "contents": "[Unit]\nBefore=local-fs.target\n[Mount]\nWhere=/var/lib/lun0p1\nWhat=/dev/disk/by-partlabel/lun0p1\nOptions=defaults,pquota\n[Install]\nWantedBy=local-fs.target\n", 8
            "enabled": true,
            "name": "var-lib-lun0p1.mount"
          }
        ]
      }

      1

      ウルトラディスクとしてノードに接続するディスクの設定の詳細。

      2

      使用しているマシンセットの dataDisks スタンザで定義されている lun 値を指定します。たとえば、マシンセットに lun:0 が含まれている場合は、lun0 を指定します。この設定ファイルで複数の "disks" エントリーを指定することにより、複数のデータディスクを初期化できます。複数の "disks" エントリーを指定する場合は、それぞれの lun 値がマシンセットの値と一致することを確認してください。

      3

      ディスク上の新しいパーティションの設定の詳細。

      4

      パーティションのラベルを指定します。lun0 の最初のパーティションに lun0p1 などの階層名を使用すると便利な場合があります。

      5

      パーティションの合計サイズを MiB で指定します。

      6

      パーティションをフォーマットするときに使用するファイルシステムを指定します。パーティションラベルを使用して、パーティションを指定します。

      7

      起動時にパーティションをマウントする systemd ユニットを指定します。パーティションラベルを使用して、パーティションを指定します。この設定ファイルで複数の "partitions" エントリーを指定することにより、複数のパーティションを作成できます。複数の "partitions" エントリーを指定する場合は、それぞれに systemd ユニットを指定する必要があります。

      8

      Where には、storage.filesystems.path の値を指定します。What には、storage.filesystems.device の値を指定します。

3. 次のコマンドを実行して、無効化テンプレート値を disableTemplating.txt というファイルに抽出します。

   $ oc -n openshift-machine-api get secret worker-user-data \
   --template='{{index .data.disableTemplating | base64decode}}' | jq > disableTemplating.txt

4. 次のコマンドを実行して、userData.txt ファイルと disableTemplating.txt ファイルを組み合わせてデータシークレットファイルを作成します。

   $ oc -n openshift-machine-api create secret generic worker-user-data-x5 \
   --from-file=userData=userData.txt \
   --from-file=disableTemplating=disableTemplating.txt

   ここで、worker-user-data-x5 はシークレットの名前です。

5. 既存の Azure MachineSet カスタムリソース (CR) をコピーし、次のコマンドを実行して編集します。

   $ oc edit machineset <machine-set-name>

   ここで、<machine-set-name> は、Ultra ディスクと共にマシンをプロビジョニングするマシンセットです。

6. 示された位置に次の行を追加します。

   apiVersion: machine.openshift.io/v1beta1
   kind: MachineSet
     ...
   spec:
     ...
     template:
       ...
       spec:
         metadata:
           ...
           labels:
             ...
             disk: ultrassd 1
             ...
         providerSpec:
           value:
             ...
             ultraSSDCapability: Enabled 2
             dataDisks: 3
             - nameSuffix: ultrassd
               lun: 0
               diskSizeGB: 4
               deletionPolicy: Delete
               cachingType: None
               managedDisk:
                 storageAccountType: UltraSSD_LRS
             userDataSecret:
               name: worker-user-data-x5 4
                ...

   1

   このマシンセットによって作成されるノードを選択するために使用するラベルを指定します。この手順では、この値に disk.ultrassd を使用します。

   2 3

   これらのラインにより、ウルトラディスクの使用が可能になります。dataDisk の場合、スタンザ全体を含めます。

   4

   以前に作成したユーザーデータシークレットを指定します。

7. 次のコマンドを実行して、更新された設定を使用してマシンセットを作成します。

   $ oc create -f <machine-set-name>.yaml

検証

1. 次のコマンドを実行して、マシンが作成されていることを確認します。

   $ oc get machines

   マシンは Running 状態になっているはずです。

2. 実行中でノードが接続されているマシンの場合、次のコマンドを実行してパーティションを検証します。

   $ oc debug node/<node-name> -- chroot /host lsblk

   このコマンドでは、oc debug node/<node-name> がノード <node-name> でデバッグシェルを開始し、-- を付けてコマンドを渡します。渡されたコマンド chroot /host は、基盤となるホスト OS バイナリーへのアクセスを提供し、lsblk は、ホスト OS マシンに接続されているブロックデバイスを表示します。

手順

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

   $ oc get machinesets -n openshift-machine-api

   マシンセットは <cluster-id>-worker-<region> の形式で一覧表示されます。

   出力例

   NAME                                DESIRED   CURRENT   READY   AVAILABLE   AGE
   jmywbfb-8zqpx-worker-centralus1     1         1         1       1           15m
   jmywbfb-8zqpx-worker-centralus2     1         1         1       1           15m
   jmywbfb-8zqpx-worker-centralus3     1         1         1       1           15m

2. それぞれのマシンセットについて以下を実行します。

   1. 以下のコマンドを実行してカスタムリソース (CR) を編集します。

      $ oc edit machineset <machine-set-name>

   2. 以下を providerSpec フィールドに追加します。

      providerSpec:
        value:
          ...
          acceleratedNetworking: true 1
          ...
          vmSize: <azure-vm-size> 2
          ...

      1

      この行は Accelerated Networking を有効にします。

      2

      4 つ以上の vCPU を含む Azure 仮想マシンのサイズを指定します。仮想マシンのサイズに関する情報は、Microsoft Azure のドキュメント を参照してください。

3. 現在実行中のノードで機能を有効にするには、それぞれの既存マシンを置き換える必要があります。これは、各マシンに対して個別に行うか、レプリカをゼロにスケールダウンしてから、必要なレプリカ数にスケールアップして実行できます。