
Rather than conflict with the unexposed task model, change the names of
the object-oriented task display to `docker <object> ps`. The command
works identically to `docker service tasks`. This change is superficial.
This provides a more sensical docker experience while not trampling on
the task model that may be introduced as a top-level command at a later
date.
The following is an example of the display using `docker service ps`
with a service named `condescending_cori`:
```
$ docker service ps condescending_cori
ID NAME SERVICE IMAGE LAST STATE DESIRED STATE NODE
e2cd9vqb62qjk38lw65uoffd2 condescending_cori.1 condescending_cori alpine Running 13 minutes ago Running 6c6d232a5d0e
```
The following shows the output for the node on which the command is
running:
```console
$ docker node ps self
ID NAME SERVICE IMAGE LAST STATE DESIRED STATE NODE
b1tpbi43k1ibevg2e94bmqo0s mad_kalam.1 mad_kalam apline Accepted 2 seconds ago Accepted 6c6d232a5d0e
e2cd9vqb62qjk38lw65uoffd2 condescending_cori.1 condescending_cori alpine Running 12 minutes ago Running 6c6d232a5d0e
4x609m5o0qyn0kgpzvf0ad8x5 furious_davinci.1 furious_davinci redis Running 32 minutes ago Running 6c6d232a5d0e
```
Signed-off-by: Stephen J Day <stephen.day@docker.com>
(cherry picked from commit 0aa4e1e689
)
51 lines
1.1 KiB
Markdown
51 lines
1.1 KiB
Markdown
<!--[metadata]>
|
|
+++
|
|
title = "service rm"
|
|
description = "The service rm command description and usage"
|
|
keywords = ["service, rm"]
|
|
[menu.main]
|
|
parent = "smn_cli"
|
|
+++
|
|
<![end-metadata]-->
|
|
|
|
**Warning:** this command is part of the Swarm management feature introduced in Docker 1.12, and might be subject to non backward-compatible changes.
|
|
|
|
# service rm
|
|
|
|
```Markdown
|
|
Usage: docker service rm [OPTIONS] SERVICE
|
|
|
|
Remove a service
|
|
|
|
Aliases:
|
|
rm, remove
|
|
|
|
Options:
|
|
--help Print usage
|
|
```
|
|
|
|
Removes the specified services from the swarm. This command has to be run
|
|
targeting a manager node.
|
|
|
|
For example, to remove the redis service:
|
|
|
|
```bash
|
|
$ docker service rm redis
|
|
redis
|
|
$ docker service ls
|
|
ID NAME SCALE IMAGE COMMAND
|
|
```
|
|
|
|
> **Warning**: Unlike `docker rm`, this command does not ask for confirmation
|
|
> before removing a running service.
|
|
|
|
|
|
|
|
## Related information
|
|
|
|
* [service create](service_create.md)
|
|
* [service inspect](service_inspect.md)
|
|
* [service ls](service_ls.md)
|
|
* [service scale](service_scale.md)
|
|
* [service ps](service_ps.md)
|
|
* [service update](service_update.md)
|