Man page - docker-service-create(1)

Packages contains this manual

Manual

DOCKER

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO

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)

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

--oom-score-adj =0

Tune host’s OOM preferences (-1000 to 1000)

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

SEE ALSO

docker-service(1)