mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
Merge pull request #27979 from allencloud/more-specific-in-service-scale-description
add replicated in service scale command description
This commit is contained in:
commit
d83f56ee5f
3 changed files with 15 additions and 5 deletions
|
@ -16,7 +16,7 @@ import (
|
||||||
func newScaleCommand(dockerCli *command.DockerCli) *cobra.Command {
|
func newScaleCommand(dockerCli *command.DockerCli) *cobra.Command {
|
||||||
return &cobra.Command{
|
return &cobra.Command{
|
||||||
Use: "scale SERVICE=REPLICAS [SERVICE=REPLICAS...]",
|
Use: "scale SERVICE=REPLICAS [SERVICE=REPLICAS...]",
|
||||||
Short: "Scale one or multiple services",
|
Short: "Scale one or multiple replicated services",
|
||||||
Args: scaleArgs,
|
Args: scaleArgs,
|
||||||
RunE: func(cmd *cobra.Command, args []string) error {
|
RunE: func(cmd *cobra.Command, args []string) error {
|
||||||
return runScale(dockerCli, args)
|
return runScale(dockerCli, args)
|
||||||
|
|
|
@ -1075,7 +1075,7 @@ __docker_service_commands() {
|
||||||
"inspect:Display detailed information on one or more services"
|
"inspect:Display detailed information on one or more services"
|
||||||
"ls:List services"
|
"ls:List services"
|
||||||
"rm:Remove one or more services"
|
"rm:Remove one or more services"
|
||||||
"scale:Scale one or multiple services"
|
"scale:Scale one or multiple replicated services"
|
||||||
"ps:List the tasks of a service"
|
"ps:List the tasks of a service"
|
||||||
"update:Update a service"
|
"update:Update a service"
|
||||||
)
|
)
|
||||||
|
|
|
@ -18,7 +18,7 @@ keywords: ["service, scale"]
|
||||||
```markdown
|
```markdown
|
||||||
Usage: docker service scale SERVICE=REPLICAS [SERVICE=REPLICAS...]
|
Usage: docker service scale SERVICE=REPLICAS [SERVICE=REPLICAS...]
|
||||||
|
|
||||||
Scale one or multiple services
|
Scale one or multiple replicated services
|
||||||
|
|
||||||
Options:
|
Options:
|
||||||
--help Print usage
|
--help Print usage
|
||||||
|
@ -28,8 +28,9 @@ Options:
|
||||||
|
|
||||||
### Scale a service
|
### Scale a service
|
||||||
|
|
||||||
The scale command enables you to scale one or more services either up or down to
|
The scale command enables you to scale one or more replicated services either up
|
||||||
the desired number of replicas. The command will return immediately, but the
|
or down to the desired number of replicas. This command cannot be applied on
|
||||||
|
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
|
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.
|
service while keeping the service active in the swarm you can set the scale to 0.
|
||||||
|
|
||||||
|
@ -40,6 +41,15 @@ $ docker service scale frontend=50
|
||||||
frontend scaled to 50
|
frontend scaled to 50
|
||||||
```
|
```
|
||||||
|
|
||||||
|
The following command tries to scale a global service to 10 tasks and returns an error.
|
||||||
|
|
||||||
|
```
|
||||||
|
$ docker service create --mode global --name backend backend:latest
|
||||||
|
b4g08uwuairexjub6ome6usqh
|
||||||
|
$ docker service scale backend=10
|
||||||
|
backend: scale can only be used with replicated mode
|
||||||
|
```
|
||||||
|
|
||||||
Directly afterwards, run `docker service ls`, to see the actual number of
|
Directly afterwards, run `docker service ls`, to see the actual number of
|
||||||
replicas.
|
replicas.
|
||||||
|
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue