docker-service-update - Man Page

Update a service


docker service update [Options] SERVICE


Update a service



Service command args


Add or update a config file on a service


Remove a configuration file


Add or update a placement constraint


Remove a constraint


Add or update a container label


Remove a container label by its key


Credential spec for managed service account (Windows only)

-d,  --detach[=false]

Exit immediately instead of waiting for the service to converge


Add or update a custom DNS server


Add or update a DNS option


Remove a DNS option


Remove a custom DNS server


Add or update a custom DNS search domain


Remove a DNS search domain


Endpoint mode (vip or dnsrr)


Overwrite the default ENTRYPOINT of the image


Add or update an environment variable


Remove an environment variable


Force update even if no changes require it


Add a Generic resource


Remove a Generic resource


Add an additional supplementary user group to the container


Remove a previously added supplementary user group from the container


Command to run to check health


Time between running the check (ms|s|m|h)


Consecutive failures needed to report unhealthy


Start period for the container to initialize before counting retries towards unstable (ms|s|m|h)


Maximum time to allow one check to run (ms|s|m|h)

-h,  --help[=false]

help for update


Add a custom host-to-IP mapping (host:ip)


Remove a custom host-to-IP mapping (host:ip)


Container hostname


Service image tag


Use an init inside each service container to forward signals and reap processes


Service container isolation mode


Add or update a service label


Remove a label by its key


Limit CPUs


Limit Memory


Logging driver for service


Logging driver options


Add or update a mount on a service


Remove a mount by its target path


Add a network


Remove a network


Disable any container-specified HEALTHCHECK


Do not query the registry to resolve image digest and supported platforms


Add a placement preference


Remove a placement preference


Add or update a published port


Remove a published port by its target port

-q,  --quiet[=false]

Suppress progress output


Mount the container's root filesystem as read only


Number of tasks


Maximum number of tasks per node (default 0 = unlimited)


Reserve CPUs


Reserve Memory


Restart when condition is met ("none"|"on-failure"|"any")


Delay between restart attempts (ns|us|ms|s|m|h)


Maximum number of restarts before giving up


Window used to evaluate the restart policy (ns|us|ms|s|m|h)


Rollback to previous specification


Delay between task rollbacks (ns|us|ms|s|m|h)


Action on rollback failure ("pause"|"continue")


Failure rate to tolerate during a rollback


Duration after each task rollback to monitor for failure (ns|us|ms|s|m|h)


Rollback order ("start-first"|"stop-first")


Maximum number of tasks rolled back simultaneously (0 to roll back all at once)


Add or update a secret on a service


Remove a secret


Time to wait before force killing a container (ns|us|ms|s|m|h)


Signal to stop the container


Add or update a Sysctl option


Remove a Sysctl option

-t,  --tty[=false]

Allocate a pseudo-TTY


Delay between updates (ns|us|ms|s|m|h)


Action on update failure ("pause"|"continue"|"rollback")


Failure rate to tolerate during an update


Duration after each task update to monitor for failure (ns|us|ms|s|m|h)


Update order ("start-first"|"stop-first")


Maximum number of tasks updated simultaneously (0 to update all at once)

-u,  --user=""

Username or UID (format: <name|uid>[:<group|gid>])


Send registry authentication details to swarm agents

-w,  --workdir=""

Working directory inside the container

See Also


Referenced By


May 2020 Docker Community