docker node rm
内容説明 | 1 つまたは複数ノードを Swarm から削除します。 |
---|---|
利用方法 | docker node rm [OPTIONS] NODE [NODE...] |
エイリアス | docker node remove |
Swarm このコマンドは Swarm オーケストレーターにおいて動作します。
内容説明
指定したノードを Swarm から削除します。
メモ
これはクラスター管理コマンドであるため、Swarm のマネージャーノード上で実行する必要があります。 マネージャーノードとワーカーノードについては、本ドキュメントの Swarm モード を参照してください。
オプション
オプション | デフォルト | 内容説明 |
---|---|---|
-f, --force | Swarm からノードを強制的に削除します。 |
利用例
停止中ノードの Swarm からの削除
$ docker node rm swarm-node-02
Node swarm-node-02 removed from swarm
実行中ノードの 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
アクセス不能ノードの Swarm からの強制削除 (--force)
ワーカーノードへのアクセスができない、セキュリティ侵害されているとか思ったように動作しないので停止したいといった場合には --force
オプションを利用します。
このときにはノード上に実行されていたタスクの種類に応じて、一時的なエラーや中断が発生することがあります。
$ docker node rm --force swarm-node-03
Node swarm-node-03 removed from swarm
マネージャーノードは(docker node demote
を使って)ワーカーノードに降格しておかないと、Swarm から削除することはできません。