DOCKER(1) | Docker User Manuals | DOCKER(1) |
docker-service-update - Update a service
docker service update [OPTIONS] SERVICE
Update a service
--args= Service command args
--cap-add= Add Linux capabilities
--cap-drop= Drop Linux capabilities
--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[=false] 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
--generic-resource-add= Add a Generic resource
--generic-resource-rm= Remove a Generic resource
--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)
-h, --help[=false] help for update
--host-add= Add 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
--init[=false] Use an init inside each service container to forward signals and reap processes
--isolation="" Service container isolation mode
--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
--limit-pids=0 Limit maximum number of processes (default 0 = unlimited)
--log-driver="" Logging driver for service
--log-opt= Logging driver options
--max-concurrent= Number of job tasks to run concurrently (default equal to --replicas)
--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
--replicas-max-per-node=0 Maximum number of tasks per node (default 0 = unlimited)
--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
--sysctl-add= Add or update a Sysctl option
--sysctl-rm= Remove a Sysctl option
-t, --tty[=false] Allocate a pseudo-TTY
--ulimit-add=[] Add or update a ulimit option
--ulimit-rm= Remove a ulimit option
--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: [:])
--with-registry-auth[=false] Send registry authentication details to swarm agents
-w, --workdir="" Working directory inside the container
May 2023 | Docker Community |