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 からノードを強制削除

$ docker node rm swarm-node-02

Node swarm-node-02 removed from 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

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	ノードを更新

参考

docker node rm: https://docs.docker.com/engine/reference/commandline/node_rm/