docker node rm

説明

1 つまたは複数ノードを Swarm から削除します。

API 1.24 以上このコマンドを利用するには、クライアントとデーモンの API はともに、最低でも 1.24 である必要があります。クライアント上においてdocker versionコマンドを実行して、クライアントとデーモンの API バージョンを確認してください。

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

$ docker node rm [オプション] NODE [NODE...]

指定したノードを Swarm から削除します。

メモ

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

本コマンドの利用例については、以下に示す利用例の節を参照してください。

名前／省略形	デフォルト	説明
`--force` , `-f`		Swarm からノードを強制的に削除します。

$ docker node rm swarm-node-02

Node swarm-node-02 removed from swarm

指定されたノードを Swarm から削除するのは、ノードが停止している場合に限ります。アクティブなノードを削除しようとした場合は、エラーになります。

$ 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

ワーカーノードへのアクセスができない、セキュリティ侵害されているとか思ったように動作しないので停止したい、といった場合には、--forceオプションを利用します。このときにはノード上に実行されていたタスクの種類に応じて、一時的なエラーや中断が発生することがあります。

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

Node swarm-node-03 removed from swarm

マネージャーノードは（docker node demoteを使って）ワーカーノードに降格しておかないと、Swarm から削除することはできません。

コマンド	説明
docker node	Swarm ノードを管理します。

コマンド	説明
docker node demote	Swarm 内において 1 つあるいは複数のノードをマネージャーから降格させます。
docker node inspect	1 つまたは複数ノードに関する詳細情報を表示します。
docker node ls	Swarm 内ノードを一覧表示します。
docker node promote	Swarm 内において 1 つまたは複数ノードをマネージャーに昇格させます。
docker node ps	1 つまたは複数ノードにおいて実行中のタスク一覧を表示します。デフォルトはカレントノードのみです。
docker node rm	1 つまたは複数ノードを Swarm から削除します。
docker node update	ノードを更新します。