docker node update

内容説明	ノードを更新します。
利用方法	`docker node update [OPTIONS] NODE`

Swarm このコマンドは Swarm オーケストレーターにおいて動作します。

内容説明

ノードに関するメタデータを更新します。たとえば利用状態 (availability)、ラベル、ロールなどです。

メモ
これはクラスター管理コマンドであるため、Swarm のマネージャーノード上で実行する必要があります。マネージャーノードとワーカーノードについては、本ドキュメントの Swarm モードを参照してください。

オプション	デフォルト	内容説明
`--availability`		ノードの利用状態。 (`active`, `pause`, `drain`)
`--label-add`		ノードラベルを追加または更新します。 (`key=value`)
`--label-rm`		ノードにラベルが存在する場合に削除します。
`--role`		ノードのロール。 (`worker`, `manager`)

ノードラベルを用いてメタデータを Swarm ノードに追加します。ノードラベルは、キーに対して空の値を設定することができます。

$ docker node update --label-add foo worker1

複数ラベルをノードに加えるには --label-add フラグを各ラベル指定に利用します。

$ docker node update --label-add foo --label-add bar worker1

サービスの生成を行う際には、ノードラベルを制約として設定することができます。この制約は、ノードにおけるスケジューラーが、サービスに対するタスクのデプロイを制限します。

たとえば type ラベルを追加し、ノードにおけるスケジューラーが、メッセージキューサービスタスクをデプロイするものとするには、以下のようにします。

$ docker node update --label-add type=queue worker1

docker node update を使ってノードに設定するラベルは、Swarm 内にあるノードエンティティにのみ適用されます。これを dockerd に対する Docker デーモンラベルと混同しないように注意してください。

ラベルに関する詳細は独自メタデータの適用を参照してください。