5.6. より高い仮想マシンワークロード密度の設定

手順

1. スワップの使用を許可するように kubelet サービスを設定します。

   1. 次の例に示すパラメーターを使用して KubeletConfig ファイルを作成または編集します。

      apiVersion: machineconfiguration.openshift.io/v1
      kind: KubeletConfig
      metadata:
        name: custom-config
      spec:
        machineConfigPoolSelector:
          matchLabels:
            pools.operator.machineconfiguration.openshift.io/worker: ''  # MCP
            #machine.openshift.io/cluster-api-machine-role: worker # machine
            #node-role.kubernetes.io/worker: '' # node
        kubeletConfig:
          failSwapOn: false

   2. 次のコマンドを実行して、ワーカーノードが新しい設定と同期されるまで待ちます。

      $ oc wait mcp worker --for condition=Updated=True --timeout=-1s

2. MachineConfig オブジェクトを作成し、スワップをプロビジョニングします。

   1. 以下の例に示されているパラメーターを使用して MachineConfig ファイルを作成します。

      apiVersion: machineconfiguration.openshift.io/v1
      kind: MachineConfig
      metadata:
        labels:
          machineconfiguration.openshift.io/role: worker
        name: 90-worker-swap
      spec:
        config:
          ignition:
            version: 3.5.0
          systemd:
            units:
              - contents: |
                  [Unit]
                  Description=Provision and enable swap
                  ConditionFirstBoot=no
                  ConditionPathExists=!/var/tmp/swapfile
      
                  [Service]
                  Type=oneshot
                  Environment=SWAP_SIZE_MB=5000
                  ExecStart=/bin/sh -c "sudo dd if=/dev/zero of=/var/tmp/swapfile count=${SWAP_SIZE_MB} bs=1M && \
                  sudo chmod 600 /var/tmp/swapfile && \
                  sudo mkswap /var/tmp/swapfile && \
                  sudo swapon /var/tmp/swapfile && \
                  free -h"
      
                  [Install]
                  RequiredBy=kubelet-dependencies.target
                enabled: true
                name: swap-provision.service
              - contents: |
                  [Unit]
                  Description=Restrict swap for system slice
                  ConditionFirstBoot=no
      
                  [Service]
                  Type=oneshot
                  ExecStart=/bin/sh -c "sudo systemctl set-property --runtime system.slice MemorySwapMax=0 IODeviceLatencyTargetSec=\"/ 50ms\""
      
                  [Install]
                  RequiredBy=kubelet-dependencies.target
                enabled: true
                name: cgroup-system-slice-config.service

      最悪のシナリオに備えて十分なスワップ領域を確保するには、オーバーコミットされた RAM と同量以上のスワップ領域をプロビジョニングしておく必要があります。次の式を使用して、ノードにプロビジョニングするスワップ領域の量を計算します。

      NODE_SWAP_SPACE = NODE_RAM * (MEMORY_OVER_COMMIT_PERCENT / 100% - 1)

      以下に例を示します。

      NODE_SWAP_SPACE = 16 GB * (150% / 100% - 1)
                     = 16 GB * (1.5 - 1)
                     = 16 GB * (0.5)
                     =  8 GB

   2. 次のコマンドを実行して、ワーカーノードが新しい設定と同期されるまで待ちます。

      $ oc wait mcp worker --for condition=Updated=True --timeout=-1s

3. Web コンソールまたは CLI を使用して、OpenShift Virtualization でメモリーのオーバーコミットを有効にします。

   • Web コンソール

     1. OpenShift Container Platform Web コンソールで、Virtualization Overview Settings General settings Memory density に移動します。
     2. Enable memory density をオンに設定します。

   • CLI

     • より高いメモリー密度を有効にし、オーバーコミットレートを設定するように OpenShift Virtualization を設定します。

       $ oc -n openshift-cnv patch HyperConverged/kubevirt-hyperconverged --type='json' -p='[ \
         { \
         "op": "replace", \
         "path": "/spec/higherWorkloadDensity/memoryOvercommitPercentage", \
         "value": 150 \
         } \
       ]'

       正常な出力:

       hyperconverged.hco.kubevirt.io/kubevirt-hyperconverged patched

検証

1. wasp-agent のデプロイメントを確認するには、次のコマンドを実行します。

   $ oc rollout status ds wasp-agent -n openshift-cnv

   デプロイメントが成功すると、次のメッセージが表示されます。

   出力例:

   daemon set "wasp-agent" successfully rolled out

2. スワップが正しくプロビジョニングされていることを確認するには、次の手順を実行します。

   1. 次のコマンドを実行して、ワーカーノードのリストを表示します。

      $ oc get nodes -l node-role.kubernetes.io/worker

   2. リストからノードを選択し、次のコマンドを実行してそのメモリー使用量を表示します。

      $ oc debug node/<selected_node> -- free -m 

      1

      1

      <selected_node> をノード名に置き換えます。

      スワップがプロビジョニングされている場合、Swap: 行にゼロより大きい値が表示されます。

      Expand

      表5.1 出力例

      	total	used	free	shared	buff/cache	available
      Mem:	31846	23155	1044	6014	14483	8690
      Swap:	8191	2337	5854

      Show more

3. 次のコマンドを実行して、OpenShift Virtualization のメモリーオーバーコミットメント設定を確認します。

   $ oc -n openshift-cnv get HyperConverged/kubevirt-hyperconverged -o jsonpath='{.spec.higherWorkloadDensity}{"\n"}'

   出力例:

   {"memoryOvercommitPercentage":150}

   返される値は、以前に設定した値と一致する必要があります。

手順

1. 次のコマンドを実行して、メモリーのオーバーコミット設定を元に戻します。

   $ oc -n openshift-cnv patch HyperConverged/kubevirt-hyperconverged \
     --type='json' \
     -p='[{"op": "remove", "path": "/spec/higherWorkloadDensity"}]'

2. 次のコマンドを実行して、スワップメモリーをプロビジョニングする MachineConfig を削除します。

   $ oc delete machineconfig 90-worker-swap

3. 次のコマンドを実行して、関連付けられた KubeletConfig カスタムリソース(CR)を削除します。

   $ oc delete kubeletconfig custom-config

4. 以下のコマンドを実行して出力を確認し、ワーカーノードが調整されるのを待ちます。

   $ oc wait mcp worker --for condition=Updated=True --timeout=-1s