summaryrefslogtreecommitdiff
path: root/docs/reference/commandline/service_scale.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/reference/commandline/service_scale.md')
-rw-r--r--docs/reference/commandline/service_scale.md20
1 files changed, 14 insertions, 6 deletions
diff --git a/docs/reference/commandline/service_scale.md b/docs/reference/commandline/service_scale.md
index 64075ed092..a3aef5fd34 100644
--- a/docs/reference/commandline/service_scale.md
+++ b/docs/reference/commandline/service_scale.md
@@ -24,9 +24,7 @@ Options:
--help Print usage
```
-## Examples
-
-### Scale a service
+## Description
The scale command enables you to scale one or more replicated services either up
or down to the desired number of replicas. This command cannot be applied on
@@ -34,19 +32,27 @@ services which are global mode. The command will return immediately, but the
actual scaling of the service may take some time. To stop all replicas of a
service while keeping the service active in the swarm you can set the scale to 0.
-For example, the following command scales the "frontend" service to 50 tasks.
+## Examples
+
+### Scale a single service
+
+The following command scales the "frontend" service to 50 tasks.
```bash
$ docker service scale frontend=50
+
frontend scaled to 50
```
The following command tries to scale a global service to 10 tasks and returns an error.
-```
+```bash
$ docker service create --mode global --name backend backend:latest
+
b4g08uwuairexjub6ome6usqh
+
$ docker service scale backend=10
+
backend: scale can only be used with replicated mode
```
@@ -76,16 +82,18 @@ backend and frontend services:
```bash
$ docker service scale backend=3 frontend=5
+
backend scaled to 3
frontend scaled to 5
$ docker service ls
+
ID NAME MODE REPLICAS IMAGE
3pr5mlvu3fh9 frontend replicated 5/5 nginx:alpine
74nzcxxjv6fq backend replicated 3/3 redis:3.0.6
```
-## Related information
+## Related commands
* [service create](service_create.md)
* [service inspect](service_inspect.md)