第6章 モニタリングのための Pod トポロジー分散制約の使用

前提条件

• OpenShift Container Platform コアモニタリング用に Pod を設定する場合:

  • cluster-admin クラスターロールを持つユーザーとしてクラスターにアクセスできる。
  • cluster-monitoring-config ConfigMap オブジェクトを作成している。

• ユーザー定義のモニタリング用に Pod を設定する場合:

  • cluster-admin クラスターロールを持つユーザーとして、または openshift-user-workload-monitoring プロジェクトの user-workload-monitoring-config-edit ロールを持つユーザーとして、クラスターにアクセスできる。
  • クラスター管理者は、ユーザー定義プロジェクトのモニタリングを有効にしている。
• OpenShift CLI (oc) がインストールされている。

手順

• OpenShift Container Platform コアモニタリングの Pod トポロジースプレッド制約を設定するには:

  1. openshift-monitoring プロジェクトで cluster-monitoring-config config map を編集します。

     $ oc -n openshift-monitoring edit configmap cluster-monitoring-config

  2. Pod トポロジーの分散制約を設定するには、data/config.yaml フィールドの下に次の設定を追加します。

     apiVersion: v1
     kind: ConfigMap
     metadata:
       name: cluster-monitoring-config
       namespace: openshift-monitoring
     data:
       config.yaml: |
         <component>: 

     1

     
           topologySpreadConstraints:
           - maxSkew: <n> 

     2

     
             topologyKey: <key> 

     3

     
             whenUnsatisfiable: <value> 

     4

     
             labelSelector: 

     5

     
               <match_option>

     1

     Pod トポロジーの分散制約を設定するコンポーネントの名前を指定します。

     2

     maxSkew の数値を指定します。これは、どの程度まで Pod が不均等に分散されることを許可するか定義します。

     3

     topologyKey にノードラベルのキーを指定します。このキーと同じ値のラベルを持つノードは、同じトポロジーにあると見なされます。スケジューラーは、各ドメインにバランスの取れた数の Pod を配置しようとします。

     4

     whenUnsatisfiable の値を指定します。利用可能なオプションは DoNotSchedule と ScheduleAnyway です。maxSkew 値で、ターゲットトポロジー内の一致する Pod の数とグローバル最小値との間で許容される最大差を定義する場合は、DoNotSchedule を指定します。スケジューラーが引き続き Pod をスケジュールするが、スキューを減らす可能性のあるノードにより高い優先度を与える場合は、ScheduleAnyway を指定します。

     5

     一致する Pod を見つけるには、labelSelector を指定します。このラベルセレクターに一致する Pod は、対応するトポロジードメイン内の Pod の数を決定するためにカウントされます。

     Prometheus の設定例

     apiVersion: v1
     kind: ConfigMap
     metadata:
       name: cluster-monitoring-config
       namespace: openshift-monitoring
     data:
       config.yaml: |
         prometheusK8s:
           topologySpreadConstraints:
           - maxSkew: 1
             topologyKey: monitoring
             whenUnsatisfiable: DoNotSchedule
             labelSelector:
               matchLabels:
                 app.kubernetes.io/name: prometheus

  3. 変更を適用するためにファイルを保存します。新しい設定の影響を受ける Pod は自動的に再デプロイされます。

• ユーザー定義のモニタリングの Pod トポロジー拡散制約を設定するには:

  1. openshift-user-workload-monitoring プロジェクトで user-workload-monitoring-config config map を編集します。

     $ oc -n openshift-user-workload-monitoring edit configmap user-workload-monitoring-config

  2. Pod トポロジーの分散制約を設定するには、data/config.yaml フィールドの下に次の設定を追加します。

     apiVersion: v1
     kind: ConfigMap
     metadata:
       name: user-workload-monitoring-config
       namespace: openshift-user-workload-monitoring
     data:
       config.yaml: |
         <component>: 

     1

     
           topologySpreadConstraints:
           - maxSkew: <n> 

     2

     
             topologyKey: <key> 

     3

     
             whenUnsatisfiable: <value> 

     4

     
             labelSelector: 

     5

     
               <match_option>

     1

     Pod トポロジーの分散制約を設定するコンポーネントの名前を指定します。

     2

     maxSkew の数値を指定します。これは、どの程度まで Pod が不均等に分散されることを許可するか定義します。

     3

     topologyKey にノードラベルのキーを指定します。このキーと同じ値のラベルを持つノードは、同じトポロジーにあると見なされます。スケジューラーは、各ドメインにバランスの取れた数の Pod を配置しようとします。

     4

     whenUnsatisfiable の値を指定します。利用可能なオプションは DoNotSchedule と ScheduleAnyway です。maxSkew 値で、ターゲットトポロジー内の一致する Pod の数とグローバル最小値との間で許容される最大差を定義する場合は、DoNotSchedule を指定します。スケジューラーが引き続き Pod をスケジュールするが、スキューを減らす可能性のあるノードにより高い優先度を与える場合は、ScheduleAnyway を指定します。

     5

     一致する Pod を見つけるには、labelSelector を指定します。このラベルセレクターに一致する Pod は、対応するトポロジードメイン内の Pod の数を決定するためにカウントされます。

     Thanos Ruler の設定例

     apiVersion: v1
     kind: ConfigMap
     metadata:
       name: user-workload-monitoring-config
       namespace: openshift-user-workload-monitoring
     data:
       config.yaml: |
         thanosRuler:
           topologySpreadConstraints:
           - maxSkew: 1
             topologyKey: monitoring
             whenUnsatisfiable: ScheduleAnyway
             labelSelector:
               matchLabels:
                 app.kubernetes.io/name: thanos-ruler

  3. 変更を適用するためにファイルを保存します。新しい設定の影響を受ける Pod は自動的に再デプロイされます。