docker-service-create

DOCKER(1) Docker User Manuals DOCKER(1)

NAME

   docker-service-create - Create a new service

SYNOPSIS

   docker service create [OPTIONS] IMAGE [COMMAND] [ARG...]

DESCRIPTION

   Create a new service

OPTIONS

   --cap-add=      Add Linux capabilities

   --cap-drop=      Drop Linux capabilities

   --config=      Specify configurations to expose to the service

   --constraint=      Placement constraints

   --container-label=      Container labels

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

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

   --dns=      Set custom DNS servers

   --dns-option=      Set DNS options

   --dns-search=      Set custom DNS search domains

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

   --entrypoint=      Overwrite the default ENTRYPOINT of the image

   -e, --env=      Set environment variables

   --env-file=      Read in a file of environment variables

   --generic-resource=      User defined resources

   --group=      Set one or more supplementary user groups for 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-interval=      Time between running the check during the start period (ms|s|m|h)

   --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 create

   --host=      Set one or more custom host-to-IP mappings (host:ip)

   --hostname=""      Container hostname

   --init[=false]      Use an init inside each service container to forward signals and reap processes

   --isolation=""      Service container isolation mode

   -l, --label=      Service labels

   --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)

   --mode="replicated"      Service mode ("replicated", "global", "replicated-job", "global-job")

   --mount=      Attach a filesystem mount to the service

   --name=""      Service name

   --network=      Network attachments

   --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 a placement preference

   -p, --publish=      Publish a port as a node 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") (default "any")

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

   --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-delay=0s      Delay between task rollbacks (ns|us|ms|s|m|h) (default 0s)

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

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

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

   --rollback-order=""      Rollback order ("start-first", "stop-first") (default "stop-first")

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

   --secret=      Specify secrets to expose to the service

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

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

   --sysctl=      Sysctl options

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

   --ulimit=[]      Ulimit options

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

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

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

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

   --update-order=""      Update order ("start-first", "stop-first") (default "stop-first")

   --update-parallelism=1      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