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 から指定したノードを削除できるのは、ノードが :ruby:`停止状態 <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 ノードに :ruby:`降格する <demote>` 必要があります（ docker node demote を使用）。

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

コマンド	説明
docker node demote	swarm 内の manager から1つまたは複数のノードを :ruby:`降格 <demote>`
docker node inspect	1つまたは複数ノードの詳細情報を表示
docker node ls	swarm 内のノードを一覧表示
docker node promote	swarm 内の1つまたは複数のノードを manager に :ruby:`昇格 <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/