7.7. taint および toleration

7.7.1. taint および toleration について

taint により、ノードは Pod に一致する toleration がない場合に Pod のスケジュールを拒否することができます。

taint は Node 仕様 (NodeSpec) でノードに適用され、toleration は Pod 仕様 (PodSpec) で Pod に適用されます。taint をノードに適用する場合、スケジューラーは Pod が taint を容認しない限り、Pod をそのノードに配置することができません。

ノード仕様の taint の例

apiVersion: v1
kind: Node
metadata:
  name: my-node
#...
spec:
  taints:
  - effect: NoExecute
    key: key1
    value: value1
#...

Pod 仕様での toleration の例

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
#...
spec:
  tolerations:
  - key: "key1"
    operator: "Equal"
    value: "value1"
    effect: "NoExecute"
    tolerationSeconds: 3600
#...

taint および toleration は、key、value、および effect で構成されます。

パラメーター説明

key

key には、253 文字までの文字列を使用できます。キーは文字または数字で開始する必要があり、文字、数字、ハイフン、ドットおよびアンダースコアを含めることができます。

value

value には、63 文字までの文字列を使用できます。値は文字または数字で開始する必要があり、文字、数字、ハイフン、ドットおよびアンダースコアを含めることができます。

effect

effect は以下のいずれかにすることができます。

`NoSchedule` ^[1]	taint に一致しない新規 Pod はノードにスケジュールされません。ノードの既存 Pod はそのままになります。
`PreferNoSchedule`	taint に一致しない新規 Pod はノードにスケジュールされる可能性がありますが、スケジューラーはスケジュールしないようにします。ノードの既存 Pod はそのままになります。
`NoExecute`	taint に一致しない新規 Pod はノードにスケジュールできません。一致する toleration を持たないノードの既存 Pod は削除されます。

operator

`Equal`	`key`/`value`/`effect` パラメーターは一致する必要があります。これはデフォルトになります。
`Exists`	`key`/`effect` パラメーターは一致する必要があります。いずれかに一致する `value` パラメーターを空のままにする必要があります。

NoSchedule taint をコントロールプレーンノードに追加すると、ノードには、デフォルトで追加される node-role.kubernetes.io/master=:NoSchedule taint が必要です。

以下に例を示します。

apiVersion: v1
kind: Node
metadata:
  annotations:
    machine.openshift.io/machine: openshift-machine-api/ci-ln-62s7gtb-f76d1-v8jxv-master-0
    machineconfiguration.openshift.io/currentConfig: rendered-master-cdc1ab7da414629332cc4c3926e6e59c
  name: my-node
#...
spec:
  taints:
  - effect: NoSchedule
    key: node-role.kubernetes.io/master
#...

toleration は taint と一致します。

operator パラメーターが Equal に設定されている場合:
- key パラメーターは同じになります。
- value パラメーターは同じになります。
- effect パラメーターは同じになります。
operator パラメーターが Exists に設定されている場合:
- key パラメーターは同じになります。
- effect パラメーターは同じになります。

以下の taint は OpenShift Container Platform に組み込まれています。

node.kubernetes.io/not-ready: ノードは準備状態にありません。これはノード条件 Ready=False に対応します。
node.kubernetes.io/unreachable: ノードはノードコントローラーから到達不能です。これはノード条件 Ready=Unknown に対応します。
node.kubernetes.io/memory-pressure: ノードにはメモリー不足の問題が発生しています。これはノード条件 MemoryPressure=True に対応します。
node.kubernetes.io/disk-pressure: ノードにはディスク不足の問題が発生しています。これはノード条件 DiskPressure=True に対応します。
node.kubernetes.io/network-unavailable: ノードのネットワークは使用できません。
node.kubernetes.io/unschedulable: ノードはスケジュールが行えません。
node.cloudprovider.kubernetes.io/uninitialized: ノードコントローラーが外部のクラウドプロバイダーを使用して起動すると、この taint はノード上に設定され、使用不可能とマークされます。cloud-controller-manager のコントローラーがこのノードを初期化した後に、kubelet がこの taint を削除します。
node.kubernetes.io/pid-pressure: ノードが pid 不足の状態です。これはノード条件 PIDPressure=True に対応します。
重要
OpenShift Container Platform では、デフォルトの pid.available evictionHard は設定されません。

7.7.2. taint および toleration の追加

toleration を Pod に、taint をノードに追加することで、ノードはノード上でスケジュールする必要のある (またはスケジュールすべきでない) Pod を制御できます。既存の Pod およびノードの場合、最初に toleration を Pod に追加してから taint をノードに追加して、toleration を追加する前に Pod がノードから削除されないようにする必要があります。

手順

Pod 仕様を tolerations スタンザを含めるように編集して、toleration を Pod に追加します。
Equal 演算子を含む Pod 設定ファイルのサンプル
```
apiVersion: v1
kind: Pod
metadata:
  name: my-pod
#...
spec:
  tolerations:
  - key: "key1" 1
    value: "value1"
    operator: "Equal"
    effect: "NoExecute"
    tolerationSeconds: 3600 2
#...
```
1
taint および toleration コンポーネント の表で説明されている toleration パラメーターです。
2
tolerationSeconds パラメーターは、エビクトする前に Pod をどの程度の期間ノードにバインドさせるかを指定します。
以下に例を示します。
Exists 演算子を含む Pod 設定ファイルのサンプル
```
apiVersion: v1
kind: Pod
metadata:
  name: my-pod
#...
spec:
   tolerations:
    - key: "key1"
      operator: "Exists" 1
      effect: "NoExecute"
      tolerationSeconds: 3600
#...
```
1
Exists Operator は value を取りません。
この例では、taint を、キー key1、値 value1、および taint effect NoExecute を持つ node1 に taint を配置します。
taint および toleration コンポーネント の表で説明されているパラメーターと共に以下のコマンドを使用して taint をノードに追加します。
```
$ oc adm taint nodes <node_name> <key>=<value>:<effect>
```
以下に例を示します。
```
$ oc adm taint nodes node1 key1=value1:NoExecute
```
このコマンドは、キー key1、値 value1、および effect NoExecute を持つ taint を node1 に配置します。
注記
NoSchedule taint をコントロールプレーンノードに追加すると、ノードには、デフォルトで追加される node-role.kubernetes.io/master=:NoSchedule taint が必要です。
以下に例を示します。
```
apiVersion: v1
kind: Node
metadata:
  annotations:
    machine.openshift.io/machine: openshift-machine-api/ci-ln-62s7gtb-f76d1-v8jxv-master-0
    machineconfiguration.openshift.io/currentConfig: rendered-master-cdc1ab7da414629332cc4c3926e6e59c
  name: my-node
#...
spec:
  taints:
  - effect: NoSchedule
    key: node-role.kubernetes.io/master
#...
```
Pod の toleration はノードの taint に一致します。いずれかの toleration のある Pod は node1 にスケジュールできます。

7.7.3. コンピュートマシンセットを使用した taint および toleration の追加

コンピュートマシンセットを使用して taint をノードに追加できます。MachineSet オブジェクトに関連付けられるすべてのノードが taint で更新されます。toleration は、ノードに直接追加された taint と同様に、コンピュートマシンセットによって追加される taint に応答します。

手順

Pod 仕様を tolerations スタンザを含めるように編集して、toleration を Pod に追加します。
Equal 演算子を含む Pod 設定ファイルのサンプル
```
apiVersion: v1
kind: Pod
metadata:
  name: my-pod
#...
spec:
  tolerations:
  - key: "key1" 1
    value: "value1"
    operator: "Equal"
    effect: "NoExecute"
    tolerationSeconds: 3600 2
#...
```
1
taint および toleration コンポーネント の表で説明されている toleration パラメーターです。
2
tolerationSeconds パラメーターは、エビクトする前に Pod をどの程度の期間ノードにバインドさせるかを指定します。
以下に例を示します。
Exists 演算子を含む Pod 設定ファイルのサンプル
```
apiVersion: v1
kind: Pod
metadata:
  name: my-pod
#...
spec:
  tolerations:
  - key: "key1"
    operator: "Exists"
    effect: "NoExecute"
    tolerationSeconds: 3600
#...
```
taint を MachineSet オブジェクトに追加します。
1. taint を付けるノードの MachineSet YAML を編集するか、新規 MachineSet オブジェクトを作成できます。
```
$ oc edit machineset <machineset>
```
2. taint を spec.template.spec セクションに追加します。
  コンピュートマシンセット仕様の taint の例
```
apiVersion: machine.openshift.io/v1beta1
kind: MachineSet
metadata:
  name: my-machineset
#...
spec:
#...
  template:
#...
    spec:
      taints:
      - effect: NoExecute
        key: key1
        value: value1
#...
```
  この例では、キー key1、値 value1、および taint effect NoExecute を持つ taint をノードに配置します。
3. コンピュートマシンセットを 0 にスケールダウンします。
```
$ oc scale --replicas=0 machineset <machineset> -n openshift-machine-api
```
  ヒント
  または、以下の YAML を適用してコンピュートマシンセットをスケーリングすることもできます。
  apiVersion: machine.openshift.io/v1beta1 kind: MachineSet metadata: name: <machineset> namespace: openshift-machine-api spec: replicas: 0
  マシンが削除されるまで待機します。
4. コンピュートマシンセットを随時スケールアップします。
```
$ oc scale --replicas=2 machineset <machineset> -n openshift-machine-api
```
  または、以下を実行します。
```
$ oc edit machineset <machineset> -n openshift-machine-api
```
  マシンが起動するまで待ちます。taint は MachineSet オブジェクトに関連付けられたノードに追加されます。

7.7.4. taint および toleration 使用してユーザーをノードにバインドする

ノードのセットを特定のユーザーセットによる排他的な使用のために割り当てる必要がある場合、toleration をそれらの Pod に追加します。次に、対応する taint をそれらのノードに追加します。toleration が設定された Pod は、taint が付けられたノードまたはクラスター内の他のノードを使用できます。

Pod が taint が付けられたノードのみにスケジュールされるようにするには、ラベルを同じノードセットに追加し、ノードのアフィニティーを Pod に追加し、Pod がそのラベルの付いたノードのみにスケジュールできるようにします。

手順

ノードをユーザーの使用可能な唯一のノードとして設定するには、以下を実行します。

対応する taint をそれらのノードに追加します。

以下に例を示します。

$ oc adm taint nodes node1 dedicated=groupName:NoSchedule

ヒント

または、以下の YAML を適用して taint を追加できます。

kind: Node
apiVersion: v1
metadata:
  name: my-node
#...
spec:
  taints:
    - key: dedicated
      value: groupName
      effect: NoSchedule
#...

カスタム受付コントローラーを作成して toleration を Pod に追加します。

7.7.5. taint および toleration を使用して特殊ハードウェアを持つノードを制御する

ノードの小規模なサブセットが特殊ハードウェアを持つクラスターでは、taint および toleration を使用して、特殊ハードウェアを必要としない Pod をそれらのノードから切り離し、特殊ハードウェアを必要とする Pod をそのままにすることができます。また、特殊ハードウェアを必要とする Pod に対して特定のノードを使用することを要求することもできます。

これは、特殊ハードウェアを必要とする Pod に toleration を追加し、特殊ハードウェアを持つノードに taint を付けることで実行できます。

手順

特殊ハードウェアを持つノードが特定の Pod 用に予約されるようにするには、以下を実行します。

toleration を特別なハードウェアを必要とする Pod に追加します。

以下に例を示します。

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
#...
spec:
  tolerations:
    - key: "disktype"
      value: "ssd"
      operator: "Equal"
      effect: "NoSchedule"
      tolerationSeconds: 3600
#...

以下のコマンドのいずれかを使用して、特殊ハードウェアを持つノードに taint を設定します。

$ oc adm taint nodes <node-name> disktype=ssd:NoSchedule

または、以下を実行します。

$ oc adm taint nodes <node-name> disktype=ssd:PreferNoSchedule

ヒント

または、以下の YAML を適用して taint を追加できます。

kind: Node
apiVersion: v1
metadata:
  name: my_node
#...
spec:
  taints:
    - key: disktype
      value: ssd
      effect: PreferNoSchedule
#...

7.7.6. taint および toleration の削除

必要に応じてノードから taint を、Pod から toleration をそれぞれ削除できます。最初に toleration を Pod に追加してから taint をノードに追加して、toleration を追加する前に Pod がノードから削除されないようにする必要があります。

手順

taint および toleration を削除するには、以下を実行します。

ノードから taint を削除するには、以下を実行します。

$ oc adm taint nodes <node-name> <key>-

以下に例を示します。

$ oc adm taint nodes ip-10-0-132-248.ec2.internal key1-

出力例

node/ip-10-0-132-248.ec2.internal untainted

Pod から toleration を削除するには、toleration を削除するための Pod 仕様を編集します。

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
#...
spec:
  tolerations:
  - key: "key2"
    operator: "Exists"
    effect: "NoExecute"
    tolerationSeconds: 3600
#...

7.7.1. taint および toleration について

7.7.2. taint および toleration の追加

7.7.3. コンピュートマシンセットを使用した taint および toleration の追加

7.7.4. taint および toleration 使用してユーザーをノードにバインドする

7.7.5. taint および toleration を使用して特殊ハードウェアを持つノードを制御する

7.7.6. taint および toleration の削除

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Red Hat legal and privacy links

Red Hat legal and privacy links