docker node rm

説明

swarm 内の1つまたは複数のノードを削除します。

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

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

使い方

$ docker node rm [OPTIONS] NODE [NODE...]

補足説明

swarm 内の1つまたは複数のノードを削除します。

注釈

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

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

オプション

名前, 省略形

デフォルト

説明

--force , -f

swarm からノードを強制削除

使用例

swarm から停止したノードを削除

$ docker node rm swarm-node-02

Node swarm-node-02 removed from swarm

swarm から実行中ノードの削除を試みる

swarm から指定したノードを削除できるのは、ノードが 停止状態(down) の場合のみです。アクティブなノードの削除を試みても、次のようにエラーが戻ります。

$ docker node rm swarm-node-03

Error response from daemon: rpc error: code = 9 desc = node swarm-node-03 is not
down and can't be removed

swarm から到達できないノードを強制削除

worker ノードとの通信が失われた場合、あるいは、障害や予期しない挙動の発生によって worker ノードを停止する必要が出てきた場合には、 --force オプションが使えます。これにより、一時的なエラーや中断が発生するかもしれませんが、ノード上で実行しているタスクの種類に依存します。

$ docker node rm --force swarm-node-03

Node swarm-node-03 removed from swarm

manager ノードを swarm から削除する前に、 worker ノードに 降格する(demote) 必要があります( docker node demote を使用)。

親コマンド

コマンド

説明

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

ノードを更新