6.9. カーネルブートパラメーターを設定することによる、ホストされたクラスターの高度なノードチューニング

手順

1. サイズが 2 MB の 10 個の Huge Page を作成するための Tuned オブジェクトマニフェストを含む ConfigMap オブジェクトを作成します。この ConfigMap マニフェストを tuned-hugepages.yaml という名前のファイルに保存します。

       apiVersion: v1
       kind: ConfigMap
       metadata:
         name: tuned-hugepages
         namespace: clusters
       data:
         tuning: |
           apiVersion: tuned.openshift.io/v1
           kind: Tuned
           metadata:
             name: hugepages
             namespace: openshift-cluster-node-tuning-operator
           spec:
             profile:
             - data: |
                 [main]
                 summary=Boot time configuration for hugepages
                 include=openshift-node
                 [bootloader]
                 cmdline_openshift_node_hugepages=hugepagesz=2M hugepages=50
               name: openshift-node-hugepages
             recommend:
             - priority: 20
               profile: openshift-node-hugepages

   Copy to Clipboard Toggle word wrap
   注記

   .spec.recommend.match フィールドは意図的に空白のままにしています。この場合、この Tuned オブジェクトは、この ConfigMap オブジェクトが参照されているノードプール内のすべてのノードに適用されます。同じハードウェア設定を持つノードを同じノードプールにグループ化します。そうしないと、TuneD オペランドは、同じノードプールを共有する 2 つ以上のノードに対して競合するカーネルパラメーターを計算する可能性があります。

2. 管理クラスターに ConfigMap オブジェクトを作成します。

   $ oc --kubeconfig="<management_cluster_kubeconfig>" create -f tuned-hugepages.yaml 

   1

   Copy to Clipboard Toggle word wrap

   1

   <management_cluster_kubeconfig> を管理クラスターの kubeconfig ファイルの名前に置き換えます。

3. NodePool マニフェスト YAML ファイルを作成し、NodePool のアップグレードタイプをカスタマイズして、spec.tuningConfig セクションで作成した ConfigMap オブジェクトを参照します。hypershift CLI を使用して NodePool マニフェストを作成し、hugepages-nodepool.yaml という名前のファイルに保存します。

   <<<<<<< HEAD
       NODEPOOL_NAME=hugepages-example
       INSTANCE_TYPE=m5.2xlarge
       NODEPOOL_REPLICAS=2
   
       hypershift create nodepool aws \
         --cluster-name $CLUSTER_NAME \
         --name $NODEPOOL_NAME \
         --node-count $NODEPOOL_REPLICAS \
         --instance-type $INSTANCE_TYPE \
         --render > hugepages-nodepool.yaml
   =======
   $ hcp create nodepool aws \
     --cluster-name <hosted_cluster_name> \

   1

   
     --name <nodepool_name> \

   2

   
     --node-count <nodepool_replicas> \

   3

   
     --instance-type <instance_type> \

   4

   
     --render > hugepages-nodepool.yaml
   >>>>>>> e990587823 (OSDOCS#12123: Describe the --render usage)

   Copy to Clipboard Toggle word wrap

   1

   <hosted_cluster_name> は、ホステッドクラスターの名前に置き換えます。

   2

   <nodepool_name> をノードプールの名前に置き換えます。

   3

   <nodepool_replicas> をノードプールのレプリカの数 (例: 2) に置き換えます。

   4

   <instance_type> をインスタンスタイプ (例: m5.2xlarge) に置き換えます。

   注記

   hcp create コマンドの --render フラグはシークレットをレンダリングしません。シークレットをレンダリングするには、hcp create コマンドで --render フラグと --render-sensitive フラグの両方を使用する必要があります。

4. hugepages-nodepool.yaml ファイルで、.spec.management.upgradeType を InPlace に設定し、作成した tuned-hugepages ConfigMap オブジェクトを参照するように .spec.tuningConfig を設定します。

       apiVersion: hypershift.openshift.io/v1alpha1
       kind: NodePool
       metadata:
         name: hugepages-nodepool
         namespace: clusters
         ...
       spec:
         management:
           ...
           upgradeType: InPlace
         ...
         tuningConfig:
         - name: tuned-hugepages

   Copy to Clipboard Toggle word wrap
   注記

   新しい MachineConfig オブジェクトを適用するときに不要なノードの再作成を回避するには、.spec.management.upgradeType を InPlace に設定します。Replace アップグレードタイプを使用する場合、ノードは完全に削除され、TuneD オペランドが計算した新しいカーネルブートパラメーターを適用すると、新しいノードでノードを置き換えることができます。

5. 管理クラスターに NodePool を作成します。

   $ oc --kubeconfig="<management_cluster_kubeconfig>" create -f hugepages-nodepool.yaml

   Copy to Clipboard Toggle word wrap

1. ホステッドクラスター内の Tuned オブジェクトをリスト表示します。

   $ oc --kubeconfig="<hosted_cluster_kubeconfig>" get tuned.tuned.openshift.io -n openshift-cluster-node-tuning-operator

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                 AGE
   default              123m
   hugepages-8dfb1fed   1m23s
   rendered             123m

   Copy to Clipboard Toggle word wrap

2. ホステッドクラスター内の Profile オブジェクトをリスト表示します。

   $ oc --kubeconfig="<hosted_cluster_kubeconfig>" get profile.tuned.openshift.io -n openshift-cluster-node-tuning-operator

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                           TUNED                      APPLIED   DEGRADED   AGE
   nodepool-1-worker-1            openshift-node             True      False      132m
   nodepool-1-worker-2            openshift-node             True      False      131m
   hugepages-nodepool-worker-1    openshift-node-hugepages   True      False      4m8s
   hugepages-nodepool-worker-2    openshift-node-hugepages   True      False      3m57s

   Copy to Clipboard Toggle word wrap

   新しい NodePool の両方のワーカーノードには、openshift-node-hugepages プロファイルが適用されています。

3. チューニングが正しく適用されたことを確認するには、ノードでデバッグシェルを起動し、/proc/cmdline を確認します。

   $ oc --kubeconfig="<hosted_cluster_kubeconfig>" debug node/nodepool-1-worker-1 -- chroot /host cat /proc/cmdline

   Copy to Clipboard Toggle word wrap

   出力例

   BOOT_IMAGE=(hd0,gpt3)/ostree/rhcos-... hugepagesz=2M hugepages=50

   Copy to Clipboard Toggle word wrap