docker node update

説明

ノードを更新します。

【API 1.24+】このコマンドを使うには、クライアントとデーモン API の両方が、少なくとも 1.24 の必要があります。クライアントとデーモン API のバージョンを調べるには、 docker version コマンドを使います。

【Swarm】このコマンドは Swarm オーケストレータで動作します。

使い方

$ docker node update [OPTIONS] NODE

補足説明

ノードに関するメタデータである avaiability、labels、roles を更新します。

注釈

これはクラスタ管理コマンドであり、 swarm manager ノードで実行する必要があります。manager と worker について学ぶには、ドキュメント内の Swarm モードのセクション を参照ください。

コマンドの使用例は、以下の 使用例のセクション をご覧ください。

オプション

名前, 省略形 デフォルト 説明
--availability   ノードの可用性( active | pause | drain
--label-add   ノードラベルの追加や更新( key=value )
--label-rm   ノードのラベルが存在する場合に削除
--role   ノードの役割( worker | manager

使用例

ノードに label メタデータを追加

ノード・ラベルを使い、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 内に所属している場合のみです。 dokcerd 用の docker デーモンのラベルと混同しないでください。

ラベルに関する詳しい情報は カスタム・メタデータの適用 をご覧ください。

親コマンド

コマンド 説明
docker node Swarm ノードを管理

関連コマンド

コマンド 説明
docker node demote swarm 内の manager から1つまたは複数のノードを 降格(demote)
docker node inspect 1つまたは複数ノードの詳細情報を表示
docker node ls swarm 内のノードを一覧表示
docker node promote swarm 内の1つまたは複数のノードを manager に 昇格(promote)
docker node ps 1つまたは複数のノード上で実行しているタスク一覧を表示。デフォルトは現在のノード上
docker node rm swarm 内の1つまたは複数のノードを削除
docker node update ノードを更新