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
#...

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

Copy to Clipboard

Toggle word wrap

Pod 仕様での toleration の例

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

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

Copy to Clipboard

Toggle word wrap

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

Expand

パラメーター説明

key

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

value

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

effect

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

Expand

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

operator

Expand

`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
#...

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
#...

Copy to Clipboard

Toggle word wrap

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" 
    value: "value1"
    operator: "Equal"
    effect: "NoExecute"
    tolerationSeconds: 3600 
#...

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
#...
spec:
  tolerations:
  - key: "key1"

1


    value: "value1"
    operator: "Equal"
    effect: "NoExecute"
    tolerationSeconds: 3600

2


#...

Copy to Clipboard

Toggle word wrap

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
#...

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
#...
spec:
   tolerations:
    - key: "key1"
      operator: "Exists"

1


      effect: "NoExecute"
      tolerationSeconds: 3600
#...

Copy to Clipboard

Toggle word wrap

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 <node_name> <key>=<value>:<effect>

Copy to Clipboard

Toggle word wrap

以下に例を示します。

oc adm taint nodes node1 key1=value1:NoExecute

$ oc adm taint nodes node1 key1=value1:NoExecute

Copy to Clipboard

Toggle word wrap

このコマンドは、キー 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
#...

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
#...

Copy to Clipboard

Toggle word wrap

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" 
    value: "value1"
    operator: "Equal"
    effect: "NoExecute"
    tolerationSeconds: 3600 
#...

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
#...
spec:
  tolerations:
  - key: "key1"

1


    value: "value1"
    operator: "Equal"
    effect: "NoExecute"
    tolerationSeconds: 3600

2


#...

Copy to Clipboard

Toggle word wrap

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
#...

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

Copy to Clipboard

Toggle word wrap

taint を MachineSet オブジェクトに追加します。
1. taint を付けるノードの MachineSet YAML を編集するか、新規 MachineSet オブジェクトを作成できます。
  $ oc edit machineset <machineset>
  Copy to Clipboard Toggle word wrap
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 #...
  
  Copy to Clipboard Toggle word wrap
  この例では、キー key1、値 value1、および taint effect NoExecute を持つ taint をノードに配置します。
3. コンピュートマシンセットを 0 にスケールダウンします。
  $ oc scale --replicas=0 machineset <machineset> -n openshift-machine-api
  Copy to Clipboard Toggle word wrap
  ヒント
  または、以下の YAML を適用してコンピュートマシンセットをスケーリングすることもできます。
  
  apiVersion: machine.openshift.io/v1beta1 kind: MachineSet metadata: name: <machineset> namespace: openshift-machine-api spec: replicas: 0
  
  Copy to Clipboard Toggle word wrap
  マシンが削除されるまで待機します。
4. コンピュートマシンセットを随時スケールアップします。
  $ oc scale --replicas=2 machineset <machineset> -n openshift-machine-api
  Copy to Clipboard Toggle word wrap
  または、以下を実行します。
  $ oc edit machineset <machineset> -n openshift-machine-api
  Copy to Clipboard Toggle word wrap
  マシンが起動するまで待ちます。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

$ oc adm taint nodes node1 dedicated=groupName:NoSchedule

Copy to Clipboard

Toggle word wrap

ヒント

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

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

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

Copy to Clipboard

Toggle word wrap

カスタム受付コントローラーを作成して 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
#...

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

Copy to Clipboard

Toggle word wrap

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

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

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

Copy to Clipboard

Toggle word wrap

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

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

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

Copy to Clipboard

Toggle word wrap

ヒント

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

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

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

Copy to Clipboard

Toggle word wrap

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 <node-name> <key>-
```
Copy to Clipboard Toggle word wrap
以下に例を示します。
```
oc adm taint nodes ip-10-0-132-248.ec2.internal key1-
```
```
$ oc adm taint nodes ip-10-0-132-248.ec2.internal key1-
```
Copy to Clipboard Toggle word wrap
出力例
```
node/ip-10-0-132-248.ec2.internal untainted
```
```
node/ip-10-0-132-248.ec2.internal untainted
```
Copy to Clipboard Toggle word wrap

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

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

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

Copy to Clipboard

Toggle word wrap

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 ドキュメントについて

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

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

7.7. taint および toleration

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 ドキュメントについて

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

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

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 の削除
リンクのコピー