docker-service-update(1)



DOCKER(1)                                                            DOCKER(1)

NAME
       docker-service-update - Update a service

SYNOPSIS
       docker service update [OPTIONS] SERVICE

DESCRIPTION
       Update a service

OPTIONS
       --args=
           Service command args

       --config-add=
           Add or update a config file on a service

       --config-rm=
           Remove a configuration file

       --constraint-add=
           Add or update a placement constraint

       --constraint-rm=
           Remove a constraint

       --container-label-add=
           Add or update a container label

       --container-label-rm=
           Remove a container label by its key

       --credential-spec=
           Credential spec for managed service account (Windows only)

       -d, --detach[=true]
           Exit immediately instead of waiting for the service to converge

       --dns-add=
           Add or update a custom DNS server

       --dns-option-add=
           Add or update a DNS option

       --dns-option-rm=
           Remove a DNS option

       --dns-rm=
           Remove a custom DNS server

       --dns-search-add=
           Add or update a custom DNS search domain

       --dns-search-rm=
           Remove a DNS search domain

       --endpoint-mode=""
           Endpoint mode (vip or dnsrr)

       --entrypoint=
           Overwrite the default ENTRYPOINT of the image

       --env-add=
           Add or update an environment variable

       --env-rm=
           Remove an environment variable

       --force[=false]
           Force update even if no changes require it

       --group-add=
           Add an additional supplementary user group to the container

       --group-rm=
           Remove a previously added supplementary user group from the
       container

       --health-cmd=""
           Command to run to check health

       --health-interval=
           Time between running the check (ms|s|m|h)

       --health-retries=0
           Consecutive failures needed to report unhealthy

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

       --health-timeout=
           Maximum time to allow one check to run (ms|s|m|h)

       --host-add=
           Add or update a custom host-to-IP mapping (host:ip)

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

       --hostname=""
           Container hostname

       --image=""
           Service image tag

       --label-add=
           Add or update a service label

       --label-rm=
           Remove a label by its key

       --limit-cpu=
           Limit CPUs

       --limit-memory=0
           Limit Memory

       --log-driver=""
           Logging driver for service

       --log-opt=
           Logging driver options

       --mount-add=
           Add or update a mount on a service

       --mount-rm=
           Remove a mount by its target path

       --network-add=
           Add a network

       --network-rm=
           Remove a network

       --no-healthcheck[=false]
           Disable any container-specified HEALTHCHECK

       --no-resolve-image[=false]
           Do not query the registry to resolve image digest and supported
       platforms

       --placement-pref-add=
           Add a placement preference

       --placement-pref-rm=
           Remove a placement preference

       --publish-add=
           Add or update a published port

       --publish-rm=
           Remove a published port by its target port

       -q, --quiet[=false]
           Suppress progress output

       --read-only[=false]
           Mount the container's root filesystem as read only

       --replicas=
           Number of tasks

       --reserve-cpu=
           Reserve CPUs

       --reserve-memory=0
           Reserve Memory

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

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

       --restart-max-attempts=
           Maximum number of restarts before giving up

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

       --rollback[=false]
           Rollback to previous specification

       --rollback-delay=0s
           Delay between task rollbacks (ns|us|ms|s|m|h)

       --rollback-failure-action=""
           Action on rollback failure ("pause"|"continue")

       --rollback-max-failure-ratio=0
           Failure rate to tolerate during a rollback

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

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

       --rollback-parallelism=0
           Maximum number of tasks rolled back simultaneously (0 to roll back
       all at once)

       --secret-add=
           Add or update a secret on a service

       --secret-rm=
           Remove a secret

       --stop-grace-period=
           Time to wait before force killing a container (ns|us|ms|s|m|h)

       --stop-signal=""
           Signal to stop the container

       -t, --tty[=false]
           Allocate a pseudo-TTY

       --update-delay=0s
           Delay between updates (ns|us|ms|s|m|h)

       --update-failure-action=""
           Action on update failure ("pause"|"continue"|"rollback")

       --update-max-failure-ratio=0
           Failure rate to tolerate during an update

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

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

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

       -u, --user=""
           Username or UID (format: <name|uid>[:<group|gid>])

       --with-registry-auth[=false]
           Send registry authentication details to swarm agents

       -w, --workdir=""
           Working directory inside the container

SEE ALSO
       docker-service(1)

Docker Community                   Sep 2017                          DOCKER(1)

Man(1) output converted with man2html
list of all man pages