Virtualization

1. HyperConverged CR を削除 します。
2. OpenShift Virtualization Operator を削除 します。
3. openshift-cnv namespace を削除 します。
4. OpenShift Virtualization カスタムリソース定義 (CRD) を削除 します。

手順

1. HyperConverged カスタムリソースを削除します。

   $ oc delete HyperConverged kubevirt-hyperconverged -n openshift-cnv

   Copy to Clipboard Toggle word wrap

2. OpenShift Virtualization Operator サブスクリプションを削除します。

   $ oc delete subscription kubevirt-hyperconverged -n openshift-cnv

   Copy to Clipboard Toggle word wrap

3. OpenShift Virtualization ClusterServiceVersion リソースを削除します。

   $ oc delete csv -n openshift-cnv -l operators.coreos.com/kubevirt-hyperconverged.openshift-cnv

   Copy to Clipboard Toggle word wrap

4. OpenShift Virtualization namespace を削除します。

   $ oc delete namespace openshift-cnv

   Copy to Clipboard Toggle word wrap

5. dry-run オプションを指定して oc delete crd コマンドを実行し、OpenShift Virtualization カスタムリソース定義 (CRD) を一覧表示します。

   $ oc delete crd --dry-run=client -l operators.coreos.com/kubevirt-hyperconverged.openshift-cnv

   Copy to Clipboard Toggle word wrap

   出力例

   customresourcedefinition.apiextensions.k8s.io "cdis.cdi.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "hostpathprovisioners.hostpathprovisioner.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "hyperconvergeds.hco.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "kubevirts.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "networkaddonsconfigs.networkaddonsoperator.network.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "ssps.ssp.kubevirt.io" deleted (dry run)
   customresourcedefinition.apiextensions.k8s.io "tektontasks.tektontasks.kubevirt.io" deleted (dry run)

   Copy to Clipboard Toggle word wrap

6. dry-run オプションを指定せずに oc delete crd コマンドを実行して、CRD を削除します。

   $ oc delete crd -l operators.coreos.com/kubevirt-hyperconverged.openshift-cnv

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行して、デフォルトのエディターでオブジェクトを編集します。

   $ oc edit <resource_type> <resource_name> -n openshift-cnv

   Copy to Clipboard Toggle word wrap
2. 変更を適用するためにファイルを保存します。

手順

1. Virtualization → Overview に移動します。
2. Settings タブで、Cluster をクリックします。
3. Expand General settings と SSH configuration を展開します。
4. SSH over LoadBalancer service をオンに設定します。

手順

1. 次のコマンドを入力して、特権サービスアカウントを作成します。

   $ oc adm new-project wasp

   Copy to Clipboard Toggle word wrap

   $ oc create sa -n wasp wasp

   Copy to Clipboard Toggle word wrap

   $ oc create clusterrolebinding wasp --clusterrole=cluster-admin --serviceaccount=wasp:wasp

   Copy to Clipboard Toggle word wrap

   $ oc adm policy add-scc-to-user -n wasp privileged -z wasp

   Copy to Clipboard Toggle word wrap
   注記

   wasp-agent コンポーネントは、OCI フックをデプロイして、ノードレベルでコンテナーのスワップ使用を有効にします。低レベルの性質上、DaemonSet オブジェクトには特権が必要です。

2. 次のように DaemonSet オブジェクトを作成して wasp-agent をデプロイします。

   kind: DaemonSet
   apiVersion: apps/v1
   metadata:
     name: wasp-agent
     namespace: wasp
     labels:
       app: wasp
       tier: node
   spec:
     selector:
       matchLabels:
         name: wasp
     template:
       metadata:
         annotations:
           description: >-
             Configures swap for workloads
         labels:
             name: wasp
       spec:
         serviceAccountName: wasp
         hostPID: true
         hostUsers: true
         terminationGracePeriodSeconds: 5
         containers:
           - name: wasp-agent
             image: >-
               registry.redhat.io/container-native-virtualization/wasp-agent-rhel9:v4.16
             imagePullPolicy: Always
             env:
             - name: "FSROOT"
               value: "/host"
             resources:
               requests:
                 cpu: 100m
                 memory: 50M
             securityContext:
               privileged: true
             volumeMounts:
             - name: host
               mountPath: "/host"
         volumes:
         - name: host
           hostPath:
             path: "/"
         priorityClassName: system-node-critical
     updateStrategy:
       type: RollingUpdate
       rollingUpdate:
         maxUnavailable: 10%
         maxSurge: 0
   status: {}

   Copy to Clipboard Toggle word wrap

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

   1. 例に示すように、KubeletConfiguration ファイルを作成します。

      KubeletConfiguration ファイルの例

      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
          evictionSoft:
            memory.available: "1Gi"
          evictionSoftGracePeriod:
            memory.available: "10s"

      Copy to Clipboard Toggle word wrap

      クラスターが既存の KubeletConfiguration ファイルをすでに使用している場合は、spec セクションに以下を追加します。

      apiVersion: machineconfiguration.openshift.io/v1
      kind: KubeletConfig
      metadata:
        name: custom-config
      # ...
      spec
      # ...
          kubeletConfig:
            evictionSoft:
              memory.available: 1Gi
            evictionSoftGracePeriod:
              memory.available: 1m30s
            failSwapOn: false

      Copy to Clipboard Toggle word wrap

   2. 以下のコマンドを実行します。

      $ oc wait mcp worker --for condition=Updated=True

      Copy to Clipboard Toggle word wrap

4. 次のとおり、スワップをプロビジョニングするための MachineConfig オブジェクトを作成します。

   apiVersion: machineconfiguration.openshift.io/v1
   kind: MachineConfig
   metadata:
     labels:
       machineconfiguration.openshift.io/role: worker
     name: 90-worker-swap
   spec:
     config:
       ignition:
         version: 3.4.0
       systemd:
         units:
         - contents: |
             [Unit]
             Description=Provision and enable swap
             ConditionFirstBoot=no
   
             [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 && \
             sudo systemctl set-property --runtime system.slice MemorySwapMax=0 IODeviceLatencyTargetSec=\"/ 50ms\""
   
             [Install]
             RequiredBy=kubelet-dependencies.target
           enabled: true
           name: swap-provision.service

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   以下に例を示します。

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

   Copy to Clipboard Toggle word wrap

5. アラートルールを次のようにデプロイします。

   apiVersion: monitoring.openshift.io/v1
   kind: AlertingRule
   metadata:
     name: wasp-alerts
     namespace: openshift-monitoring
   spec:
     groups:
     - name: wasp.rules
       rules:
       - alert: NodeSwapping
         annotations:
           description: Node {{ $labels.instance }} is swapping at a rate of {{ printf "%.2f" $value }} MB/s
           runbook_url: https://github.com/openshift-virtualization/wasp-agent/tree/main/runbooks/alerts/NodeSwapping.md
           summary: A node is swapping memory pages
         expr: |
           # In MB/s
           irate(node_memory_SwapFree_bytes{job="node-exporter"}[5m]) / 1024^2 > 0
         for: 1m
         labels:
           severity: critical

   Copy to Clipboard Toggle word wrap

6. OpenShift Container Platform Web コンソールを使用するか、次の例のとおり HyperConverged カスタムリソース (CR) ファイルを編集して、メモリーオーバーコミットを使用するように 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 \
         } \
       ]'

       Copy to Clipboard Toggle word wrap

       正常な出力

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

       Copy to Clipboard Toggle word wrap

   注記

   すべての設定を適用すると、すべての MachineConfigPool ロールアウトの完了後にのみスワップ機能が完全に利用可能になります。