Guest24897
/
DockerCLI
mirror of https://github.com/docker/cli.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Added start period option to health check. 

Signed-off-by: Elias Faxö <elias.faxo@gmail.com>
This commit is contained in:
Elias Faxö 2016-11-29 10:58:47 +01:00 committed by Tibor Vass
parent 4273ca3678
commit c5071b94da
6 changed files with 246 additions and 235 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/reference/builder.md
View File

@ -1591,6 +1591,7 @@ The options that can appear before `CMD` are:
* `--interval=DURATION` (default: `30s`) * `--interval=DURATION` (default: `30s`)
* `--timeout=DURATION` (default: `30s`) * `--timeout=DURATION` (default: `30s`)
* `--start-period=DURATION` (default: `0s`)
* `--retries=N` (default: `3`) * `--retries=N` (default: `3`)
The health check will first run **interval** seconds after the container is The health check will first run **interval** seconds after the container is
@ -1602,6 +1603,11 @@ is considered to have failed.
It takes **retries** consecutive failures of the health check for the container It takes **retries** consecutive failures of the health check for the container
to be considered `unhealthy`. to be considered `unhealthy`.
**start period** provides initialization time for containers that need time to bootstrap.
Probe failure during that period will not be counted towards the maximum number of retries.
However, if a health check succeeds during the start period, the container is considered
started and all consecutive failures will be counted towards the maximum number of retries.
There can only be one `HEALTHCHECK` instruction in a Dockerfile. If you list There can only be one `HEALTHCHECK` instruction in a Dockerfile. If you list
more than one then only the last `HEALTHCHECK` will take effect. more than one then only the last `HEALTHCHECK` will take effect.

223
docs/reference/commandline/create.md
View File

@ -23,117 +23,118 @@ Usage: docker create [OPTIONS] IMAGE [COMMAND] [ARG...]
Create a new container Create a new container
Options: Options:
--add-host value Add a custom host-to-IP mapping (host:ip) (default []) --add-host value Add a custom host-to-IP mapping (host:ip) (default [])
-a, --attach value Attach to STDIN, STDOUT or STDERR (default []) -a, --attach value Attach to STDIN, STDOUT or STDERR (default [])
--blkio-weight value Block IO (relative weight), between 10 and 1000 --blkio-weight value Block IO (relative weight), between 10 and 1000
--blkio-weight-device value Block IO weight (relative device weight) (default []) --blkio-weight-device value Block IO weight (relative device weight) (default [])
--cap-add value Add Linux capabilities (default []) --cap-add value Add Linux capabilities (default [])
--cap-drop value Drop Linux capabilities (default []) --cap-drop value Drop Linux capabilities (default [])
--cgroup-parent string Optional parent cgroup for the container --cgroup-parent string Optional parent cgroup for the container
--cidfile string Write the container ID to the file --cidfile string Write the container ID to the file
--cpu-count int The number of CPUs available for execution by the container. --cpu-count int The number of CPUs available for execution by the container.
Windows daemon only. On Windows Server containers, this is Windows daemon only. On Windows Server containers, this is
approximated as a percentage of total CPU usage. approximated as a percentage of total CPU usage.
--cpu-percent int CPU percent (Windows only) --cpu-percent int CPU percent (Windows only)
--cpu-period int Limit CPU CFS (Completely Fair Scheduler) period --cpu-period int Limit CPU CFS (Completely Fair Scheduler) period
--cpu-quota int Limit CPU CFS (Completely Fair Scheduler) quota --cpu-quota int Limit CPU CFS (Completely Fair Scheduler) quota
-c, --cpu-shares int CPU shares (relative weight) -c, --cpu-shares int CPU shares (relative weight)
--cpus NanoCPUs Number of CPUs (default 0.000) --cpus NanoCPUs Number of CPUs (default 0.000)
--cpu-rt-period int Limit the CPU real-time period in microseconds --cpu-rt-period int Limit the CPU real-time period in microseconds
--cpu-rt-runtime int Limit the CPU real-time runtime in microseconds --cpu-rt-runtime int Limit the CPU real-time runtime in microseconds
--cpuset-cpus string CPUs in which to allow execution (0-3, 0,1) --cpuset-cpus string CPUs in which to allow execution (0-3, 0,1)
--cpuset-mems string MEMs in which to allow execution (0-3, 0,1) --cpuset-mems string MEMs in which to allow execution (0-3, 0,1)
--device value Add a host device to the container (default []) --device value Add a host device to the container (default [])
--device-cgroup-rule value Add a rule to the cgroup allowed devices list --device-cgroup-rule value Add a rule to the cgroup allowed devices list
--device-read-bps value Limit read rate (bytes per second) from a device (default []) --device-read-bps value Limit read rate (bytes per second) from a device (default [])
--device-read-iops value Limit read rate (IO per second) from a device (default []) --device-read-iops value Limit read rate (IO per second) from a device (default [])
--device-write-bps value Limit write rate (bytes per second) to a device (default []) --device-write-bps value Limit write rate (bytes per second) to a device (default [])
--device-write-iops value Limit write rate (IO per second) to a device (default []) --device-write-iops value Limit write rate (IO per second) to a device (default [])
--disable-content-trust Skip image verification (default true) --disable-content-trust Skip image verification (default true)
--dns value Set custom DNS servers (default []) --dns value Set custom DNS servers (default [])
--dns-option value Set DNS options (default []) --dns-option value Set DNS options (default [])
--dns-search value Set custom DNS search domains (default []) --dns-search value Set custom DNS search domains (default [])
--entrypoint string Overwrite the default ENTRYPOINT of the image --entrypoint string Overwrite the default ENTRYPOINT of the image
-e, --env value Set environment variables (default []) -e, --env value Set environment variables (default [])
--env-file value Read in a file of environment variables (default []) --env-file value Read in a file of environment variables (default [])
--expose value Expose a port or a range of ports (default []) --expose value Expose a port or a range of ports (default [])
--group-add value Add additional groups to join (default []) --group-add value Add additional groups to join (default [])
--health-cmd string Command to run to check health --health-cmd string Command to run to check health
--health-interval duration Time between running the check (ns|us|ms|s|m|h) (default 0s) --health-interval duration Time between running the check (ns|us|ms|s|m|h) (default 0s)
--health-retries int Consecutive failures needed to report unhealthy --health-retries int Consecutive failures needed to report unhealthy
--health-timeout duration Maximum time to allow one check to run (ns|us|ms|s|m|h) (default 0s) --health-timeout duration Maximum time to allow one check to run (ns|us|ms|s|m|h) (default 0s)
--help Print usage --health-start-period duration Start period for the container to initialize before counting retries towards unstable (ns|us|ms|s|m|h) (default 0s)
-h, --hostname string Container host name --help Print usage
--init Run an init inside the container that forwards signals and reaps processes -h, --hostname string Container host name
--init-path string Path to the docker-init binary --init Run an init inside the container that forwards signals and reaps processes
-i, --interactive Keep STDIN open even if not attached --init-path string Path to the docker-init binary
--io-maxbandwidth string Maximum IO bandwidth limit for the system drive (Windows only) -i, --interactive Keep STDIN open even if not attached
--io-maxiops uint Maximum IOps limit for the system drive (Windows only) --io-maxbandwidth string Maximum IO bandwidth limit for the system drive (Windows only)
--ip string IPv4 address (e.g., 172.30.100.104) --io-maxiops uint Maximum IOps limit for the system drive (Windows only)
--ip6 string IPv6 address (e.g., 2001:db8::33) --ip string IPv4 address (e.g., 172.30.100.104)
--ipc string IPC namespace to use --ip6 string IPv6 address (e.g., 2001:db8::33)
--isolation string Container isolation technology --ipc string IPC namespace to use
--kernel-memory string Kernel memory limit --isolation string Container isolation technology
-l, --label value Set meta data on a container (default []) --kernel-memory string Kernel memory limit
--label-file value Read in a line delimited file of labels (default []) -l, --label value Set meta data on a container (default [])
--link value Add link to another container (default []) --label-file value Read in a line delimited file of labels (default [])
--link-local-ip value Container IPv4/IPv6 link-local addresses (default []) --link value Add link to another container (default [])
--log-driver string Logging driver for the container --link-local-ip value Container IPv4/IPv6 link-local addresses (default [])
--log-opt value Log driver options (default []) --log-driver string Logging driver for the container
--mac-address string Container MAC address (e.g., 92:d0:c6:0a:29:33) --log-opt value Log driver options (default [])
-m, --memory string Memory limit --mac-address string Container MAC address (e.g., 92:d0:c6:0a:29:33)
--memory-reservation string Memory soft limit -m, --memory string Memory limit
--memory-swap string Swap limit equal to memory plus swap: '-1' to enable unlimited swap --memory-reservation string Memory soft limit
--memory-swappiness int Tune container memory swappiness (0 to 100) (default -1) --memory-swap string Swap limit equal to memory plus swap: '-1' to enable unlimited swap
--mount value Attach a filesytem mount to the container (default []) --memory-swappiness int Tune container memory swappiness (0 to 100) (default -1)
--name string Assign a name to the container --mount value Attach a filesytem mount to the container (default [])
--network-alias value Add network-scoped alias for the container (default []) --name string Assign a name to the container
--network string Connect a container to a network (default "default") --network-alias value Add network-scoped alias for the container (default [])
'bridge': create a network stack on the default Docker bridge --network string Connect a container to a network (default "default")
'none': no networking 'bridge': create a network stack on the default Docker bridge
'container:<name|id>': reuse another container's network stack 'none': no networking
'host': use the Docker host network stack 'container:<name|id>': reuse another container's network stack
'<network-name>|<network-id>': connect to a user-defined network 'host': use the Docker host network stack
--no-healthcheck Disable any container-specified HEALTHCHECK '<network-name>|<network-id>': connect to a user-defined network
--oom-kill-disable Disable OOM Killer --no-healthcheck Disable any container-specified HEALTHCHECK
--oom-score-adj int Tune host's OOM preferences (-1000 to 1000) --oom-kill-disable Disable OOM Killer
--pid string PID namespace to use --oom-score-adj int Tune host's OOM preferences (-1000 to 1000)
--pids-limit int Tune container pids limit (set -1 for unlimited), kernel >= 4.3 --pid string PID namespace to use
--privileged Give extended privileges to this container --pids-limit int Tune container pids limit (set -1 for unlimited), kernel >= 4.3
-p, --publish value Publish a container's port(s) to the host (default []) --privileged Give extended privileges to this container
-P, --publish-all Publish all exposed ports to random ports -p, --publish value Publish a container's port(s) to the host (default [])
--read-only Mount the container's root filesystem as read only -P, --publish-all Publish all exposed ports to random ports
--restart string Restart policy to apply when a container exits (default "no") --read-only Mount the container's root filesystem as read only
Possible values are: no, on-failure[:max-retry], always, unless-stopped --restart string Restart policy to apply when a container exits (default "no")
--rm Automatically remove the container when it exits Possible values are: no, on-failure[:max-retry], always, unless-stopped
--runtime string Runtime to use for this container --rm Automatically remove the container when it exits
--security-opt value Security Options (default []) --runtime string Runtime to use for this container
--shm-size bytes Size of /dev/shm --security-opt value Security Options (default [])
The format is `<number><unit>`. `number` must be greater than `0`. --shm-size bytes Size of /dev/shm
Unit is optional and can be `b` (bytes), `k` (kilobytes), `m` (megabytes), The format is `<number><unit>`. `number` must be greater than `0`.
or `g` (gigabytes). If you omit the unit, the system uses bytes. Unit is optional and can be `b` (bytes), `k` (kilobytes), `m` (megabytes),
--stop-signal string Signal to stop a container (default "SIGTERM") or `g` (gigabytes). If you omit the unit, the system uses bytes.
--stop-timeout=10 Timeout (in seconds) to stop a container --stop-signal string Signal to stop a container (default "SIGTERM")
--storage-opt value Storage driver options for the container (default []) --stop-timeout=10 Timeout (in seconds) to stop a container
--sysctl value Sysctl options (default map[]) --storage-opt value Storage driver options for the container (default [])
--tmpfs value Mount a tmpfs directory (default []) --sysctl value Sysctl options (default map[])
-t, --tty Allocate a pseudo-TTY --tmpfs value Mount a tmpfs directory (default [])
--ulimit value Ulimit options (default []) -t, --tty Allocate a pseudo-TTY
-u, --user string Username or UID (format: <name|uid>[:<group|gid>]) --ulimit value Ulimit options (default [])
--userns string User namespace to use -u, --user string Username or UID (format: <name|uid>[:<group|gid>])
'host': Use the Docker host user namespace --userns string User namespace to use
'': Use the Docker daemon user namespace specified by `--userns-remap` option. 'host': Use the Docker host user namespace
--uts string UTS namespace to use '': Use the Docker daemon user namespace specified by `--userns-remap` option.
-v, --volume value Bind mount a volume (default []). The format --uts string UTS namespace to use
is `[host-src:]container-dest[:<options>]`. -v, --volume value Bind mount a volume (default []). The format
The comma-delimited `options` are [rw|ro], is `[host-src:]container-dest[:<options>]`.
[z|Z], [[r]shared|[r]slave|[r]private], The comma-delimited `options` are [rw|ro],
[delegated|cached|consistent], and [z|Z], [[r]shared|[r]slave|[r]private],
[nocopy]. The 'host-src' is an absolute path [delegated|cached|consistent], and
or a name value. [nocopy]. The 'host-src' is an absolute path
--volume-driver string Optional volume driver for the container or a name value.
--volumes-from value Mount volumes from the specified container(s) (default []) --volume-driver string Optional volume driver for the container
-w, --workdir string Working directory inside the container --volumes-from value Mount volumes from the specified container(s) (default [])
-w, --workdir string Working directory inside the container
``` ```
## Description ## Description

249
docs/reference/commandline/run.md
View File

@ -21,130 +21,131 @@ Usage: docker run [OPTIONS] IMAGE [COMMAND] [ARG...]
Run a command in a new container Run a command in a new container
Options: Options:
--add-host value Add a custom host-to-IP mapping (host:ip) (default []) --add-host value Add a custom host-to-IP mapping (host:ip) (default [])
-a, --attach value Attach to STDIN, STDOUT or STDERR (default []) -a, --attach value Attach to STDIN, STDOUT or STDERR (default [])
--blkio-weight value Block IO (relative weight), between 10 and 1000 --blkio-weight value Block IO (relative weight), between 10 and 1000
--blkio-weight-device value Block IO weight (relative device weight) (default []) --blkio-weight-device value Block IO weight (relative device weight) (default [])
--cap-add value Add Linux capabilities (default []) --cap-add value Add Linux capabilities (default [])
--cap-drop value Drop Linux capabilities (default []) --cap-drop value Drop Linux capabilities (default [])
--cgroup-parent string Optional parent cgroup for the container --cgroup-parent string Optional parent cgroup for the container
--cidfile string Write the container ID to the file --cidfile string Write the container ID to the file
--cpu-count int The number of CPUs available for execution by the container. --cpu-count int The number of CPUs available for execution by the container.
Windows daemon only. On Windows Server containers, this is Windows daemon only. On Windows Server containers, this is
approximated as a percentage of total CPU usage. approximated as a percentage of total CPU usage.
--cpu-percent int Limit percentage of CPU available for execution --cpu-percent int Limit percentage of CPU available for execution
by the container. Windows daemon only. by the container. Windows daemon only.
The processor resource controls are mutually The processor resource controls are mutually
exclusive, the order of precedence is CPUCount exclusive, the order of precedence is CPUCount
first, then CPUShares, and CPUPercent last. first, then CPUShares, and CPUPercent last.
--cpu-period int Limit CPU CFS (Completely Fair Scheduler) period --cpu-period int Limit CPU CFS (Completely Fair Scheduler) period
--cpu-quota int Limit CPU CFS (Completely Fair Scheduler) quota --cpu-quota int Limit CPU CFS (Completely Fair Scheduler) quota
-c, --cpu-shares int CPU shares (relative weight) -c, --cpu-shares int CPU shares (relative weight)
--cpus NanoCPUs Number of CPUs (default 0.000) --cpus NanoCPUs Number of CPUs (default 0.000)
--cpu-rt-period int Limit the CPU real-time period in microseconds --cpu-rt-period int Limit the CPU real-time period in microseconds
--cpu-rt-runtime int Limit the CPU real-time runtime in microseconds --cpu-rt-runtime int Limit the CPU real-time runtime in microseconds
--cpuset-cpus string CPUs in which to allow execution (0-3, 0,1) --cpuset-cpus string CPUs in which to allow execution (0-3, 0,1)
--cpuset-mems string MEMs in which to allow execution (0-3, 0,1) --cpuset-mems string MEMs in which to allow execution (0-3, 0,1)
-d, --detach Run container in background and print container ID -d, --detach Run container in background and print container ID
--detach-keys string Override the key sequence for detaching a container --detach-keys string Override the key sequence for detaching a container
--device value Add a host device to the container (default []) --device value Add a host device to the container (default [])
--device-cgroup-rule value Add a rule to the cgroup allowed devices list --device-cgroup-rule value Add a rule to the cgroup allowed devices list
--device-read-bps value Limit read rate (bytes per second) from a device (default []) --device-read-bps value Limit read rate (bytes per second) from a device (default [])
--device-read-iops value Limit read rate (IO per second) from a device (default []) --device-read-iops value Limit read rate (IO per second) from a device (default [])
--device-write-bps value Limit write rate (bytes per second) to a device (default []) --device-write-bps value Limit write rate (bytes per second) to a device (default [])
--device-write-iops value Limit write rate (IO per second) to a device (default []) --device-write-iops value Limit write rate (IO per second) to a device (default [])
--disable-content-trust Skip image verification (default true) --disable-content-trust Skip image verification (default true)
--dns value Set custom DNS servers (default []) --dns value Set custom DNS servers (default [])
--dns-option value Set DNS options (default []) --dns-option value Set DNS options (default [])
--dns-search value Set custom DNS search domains (default []) --dns-search value Set custom DNS search domains (default [])
--entrypoint string Overwrite the default ENTRYPOINT of the image --entrypoint string Overwrite the default ENTRYPOINT of the image
-e, --env value Set environment variables (default []) -e, --env value Set environment variables (default [])
--env-file value Read in a file of environment variables (default []) --env-file value Read in a file of environment variables (default [])
--expose value Expose a port or a range of ports (default []) --expose value Expose a port or a range of ports (default [])
--group-add value Add additional groups to join (default []) --group-add value Add additional groups to join (default [])
--health-cmd string Command to run to check health --health-cmd string Command to run to check health
--health-interval duration Time between running the check (ns|us|ms|s|m|h) (default 0s) --health-interval duration Time between running the check (ns|us|ms|s|m|h) (default 0s)
--health-retries int Consecutive failures needed to report unhealthy --health-retries int Consecutive failures needed to report unhealthy
--health-timeout duration Maximum time to allow one check to run (ns|us|ms|s|m|h) (default 0s) --health-timeout duration Maximum time to allow one check to run (ns|us|ms|s|m|h) (default 0s)
--help Print usage --health-start-period duration Start period for the container to initialize before counting retries towards unstable (ns|us|ms|s|m|h) (default 0s)
-h, --hostname string Container host name --help Print usage
--init Run an init inside the container that forwards signals and reaps processes -h, --hostname string Container host name
--init-path string Path to the docker-init binary --init Run an init inside the container that forwards signals and reaps processes
-i, --interactive Keep STDIN open even if not attached --init-path string Path to the docker-init binary
--io-maxbandwidth string Maximum IO bandwidth limit for the system drive (Windows only) -i, --interactive Keep STDIN open even if not attached
(Windows only). The format is `<number><unit>`. --io-maxbandwidth string Maximum IO bandwidth limit for the system drive (Windows only)
Unit is optional and can be `b` (bytes per second), (Windows only). The format is `<number><unit>`.
`k` (kilobytes per second), `m` (megabytes per second), Unit is optional and can be `b` (bytes per second),
or `g` (gigabytes per second). If you omit the unit, `k` (kilobytes per second), `m` (megabytes per second),
the system uses bytes per second. or `g` (gigabytes per second). If you omit the unit,
--io-maxbandwidth and --io-maxiops are mutually exclusive options. the system uses bytes per second.
--io-maxiops uint Maximum IOps limit for the system drive (Windows only) --io-maxbandwidth and --io-maxiops are mutually exclusive options.
--ip string IPv4 address (e.g., 172.30.100.104) --io-maxiops uint Maximum IOps limit for the system drive (Windows only)
--ip6 string IPv6 address (e.g., 2001:db8::33) --ip string IPv4 address (e.g., 172.30.100.104)
--ipc string IPC namespace to use --ip6 string IPv6 address (e.g., 2001:db8::33)
--isolation string Container isolation technology --ipc string IPC namespace to use
--kernel-memory string Kernel memory limit --isolation string Container isolation technology
-l, --label value Set meta data on a container (default []) --kernel-memory string Kernel memory limit
--label-file value Read in a line delimited file of labels (default []) -l, --label value Set meta data on a container (default [])
--link value Add link to another container (default []) --label-file value Read in a line delimited file of labels (default [])
--link-local-ip value Container IPv4/IPv6 link-local addresses (default []) --link value Add link to another container (default [])
--log-driver string Logging driver for the container --link-local-ip value Container IPv4/IPv6 link-local addresses (default [])
--log-opt value Log driver options (default []) --log-driver string Logging driver for the container
--mac-address string Container MAC address (e.g., 92:d0:c6:0a:29:33) --log-opt value Log driver options (default [])
-m, --memory string Memory limit --mac-address string Container MAC address (e.g., 92:d0:c6:0a:29:33)
--memory-reservation string Memory soft limit -m, --memory string Memory limit
--memory-swap string Swap limit equal to memory plus swap: '-1' to enable unlimited swap --memory-reservation string Memory soft limit
--memory-swappiness int Tune container memory swappiness (0 to 100) (default -1) --memory-swap string Swap limit equal to memory plus swap: '-1' to enable unlimited swap
--mount value Attach a filesystem mount to the container (default []) --memory-swappiness int Tune container memory swappiness (0 to 100) (default -1)
--name string Assign a name to the container --mount value Attach a filesystem mount to the container (default [])
--network-alias value Add network-scoped alias for the container (default []) --name string Assign a name to the container
--network string Connect a container to a network --network-alias value Add network-scoped alias for the container (default [])
'bridge': create a network stack on the default Docker bridge --network string Connect a container to a network
'none': no networking 'bridge': create a network stack on the default Docker bridge
'container:<name|id>': reuse another container's network stack 'none': no networking
'host': use the Docker host network stack 'container:<name|id>': reuse another container's network stack
'<network-name>|<network-id>': connect to a user-defined network 'host': use the Docker host network stack
--no-healthcheck Disable any container-specified HEALTHCHECK '<network-name>|<network-id>': connect to a user-defined network
--oom-kill-disable Disable OOM Killer --no-healthcheck Disable any container-specified HEALTHCHECK
--oom-score-adj int Tune host's OOM preferences (-1000 to 1000) --oom-kill-disable Disable OOM Killer
--pid string PID namespace to use --oom-score-adj int Tune host's OOM preferences (-1000 to 1000)
--pids-limit int Tune container pids limit (set -1 for unlimited) --pid string PID namespace to use
--privileged Give extended privileges to this container --pids-limit int Tune container pids limit (set -1 for unlimited)
-p, --publish value Publish a container's port(s) to the host (default []) --privileged Give extended privileges to this container
-P, --publish-all Publish all exposed ports to random ports -p, --publish value Publish a container's port(s) to the host (default [])
--read-only Mount the container's root filesystem as read only -P, --publish-all Publish all exposed ports to random ports
--restart string Restart policy to apply when a container exits (default "no") --read-only Mount the container's root filesystem as read only
Possible values are : no, on-failure[:max-retry], always, unless-stopped --restart string Restart policy to apply when a container exits (default "no")
--rm Automatically remove the container when it exits Possible values are : no, on-failure[:max-retry], always, unless-stopped
--runtime string Runtime to use for this container --rm Automatically remove the container when it exits
--security-opt value Security Options (default []) --runtime string Runtime to use for this container
--shm-size bytes Size of /dev/shm --security-opt value Security Options (default [])
The format is `<number><unit>`. `number` must be greater than `0`. --shm-size bytes Size of /dev/shm
Unit is optional and can be `b` (bytes), `k` (kilobytes), `m` (megabytes), The format is `<number><unit>`. `number` must be greater than `0`.
or `g` (gigabytes). If you omit the unit, the system uses bytes. Unit is optional and can be `b` (bytes), `k` (kilobytes), `m` (megabytes),
--sig-proxy Proxy received signals to the process (default true) or `g` (gigabytes). If you omit the unit, the system uses bytes.
--stop-signal string Signal to stop a container (default "SIGTERM") --sig-proxy Proxy received signals to the process (default true)
--stop-timeout=10 Timeout (in seconds) to stop a container --stop-signal string Signal to stop a container (default "SIGTERM")
--storage-opt value Storage driver options for the container (default []) --stop-timeout=10 Timeout (in seconds) to stop a container
--sysctl value Sysctl options (default map[]) --storage-opt value Storage driver options for the container (default [])
--tmpfs value Mount a tmpfs directory (default []) --sysctl value Sysctl options (default map[])
-t, --tty Allocate a pseudo-TTY --tmpfs value Mount a tmpfs directory (default [])
--ulimit value Ulimit options (default []) -t, --tty Allocate a pseudo-TTY
-u, --user string Username or UID (format: <name|uid>[:<group|gid>]) --ulimit value Ulimit options (default [])
--userns string User namespace to use -u, --user string Username or UID (format: <name|uid>[:<group|gid>])
'host': Use the Docker host user namespace --userns string User namespace to use
'': Use the Docker daemon user namespace specified by `--userns-remap` option. 'host': Use the Docker host user namespace
--uts string UTS namespace to use '': Use the Docker daemon user namespace specified by `--userns-remap` option.
-v, --volume value Bind mount a volume (default []). The format --uts string UTS namespace to use
is `[host-src:]container-dest[:<options>]`. -v, --volume value Bind mount a volume (default []). The format
The comma-delimited `options` are [rw|ro], is `[host-src:]container-dest[:<options>]`.
[z|Z], [[r]shared|[r]slave|[r]private], The comma-delimited `options` are [rw|ro],
[delegated|cached|consistent], and [z|Z], [[r]shared|[r]slave|[r]private],
[nocopy]. The 'host-src' is an absolute path [delegated|cached|consistent], and
or a name value. [nocopy]. The 'host-src' is an absolute path
--volume-driver string Optional volume driver for the container or a name value.
--volumes-from value Mount volumes from the specified container(s) (default []) --volume-driver string Optional volume driver for the container
-w, --workdir string Working directory inside the container --volumes-from value Mount volumes from the specified container(s) (default [])
-w, --workdir string Working directory inside the container
``` ```
## Description ## Description

1
docs/reference/commandline/service_create.md
View File

@ -36,6 +36,7 @@ Options:
--health-interval duration Time between running the check (ns|us|ms|s|m|h) --health-interval duration Time between running the check (ns|us|ms|s|m|h)
--health-retries int Consecutive failures needed to report unhealthy --health-retries int Consecutive failures needed to report unhealthy
--health-timeout duration Maximum time to allow one check to run (ns|us|ms|s|m|h) --health-timeout duration Maximum time to allow one check to run (ns|us|ms|s|m|h)
--health-start-period duration Start period for the container to initialize before counting retries towards unstable (ns|us|ms|s|m|h) (default 0s)
--help Print usage --help Print usage
--host list Set one or more custom host-to-IP mappings (host:ip) (default []) --host list Set one or more custom host-to-IP mappings (host:ip) (default [])
--hostname string Container hostname --hostname string Container hostname

1
docs/reference/commandline/service_update.md
View File

@ -44,6 +44,7 @@ Options:
--health-interval duration Time between running the check (ns|us|ms|s|m|h) --health-interval duration Time between running the check (ns|us|ms|s|m|h)
--health-retries int Consecutive failures needed to report unhealthy --health-retries int Consecutive failures needed to report unhealthy
--health-timeout duration Maximum time to allow one check to run (ns|us|ms|s|m|h) --health-timeout duration Maximum time to allow one check to run (ns|us|ms|s|m|h)
--health-start-period duration Start period for the container to initialize before counting retries towards unstable (ns|us|ms|s|m|h) (default 0s)
--help Print usage --help Print usage
--host-add list Add or update a custom host-to-IP mapping (host:ip) (default []) --host-add list Add or update a custom host-to-IP mapping (host:ip) (default [])
--host-rm list Remove a custom host-to-IP mapping (host:ip) (default []) --host-rm list Remove a custom host-to-IP mapping (host:ip) (default [])

1
docs/reference/run.md
View File

@ -1462,6 +1462,7 @@ Similarly the operator can set the **HOSTNAME** (Linux) or **COMPUTERNAME** (Win
--health-interval Time between running the check --health-interval Time between running the check
--health-retries Consecutive failures needed to report unhealthy --health-retries Consecutive failures needed to report unhealthy
--health-timeout Maximum time to allow one check to run --health-timeout Maximum time to allow one check to run
--health-start-period Start period for the container to initialize before starting health-retries countdown
--no-healthcheck Disable any container-specified HEALTHCHECK --no-healthcheck Disable any container-specified HEALTHCHECK
``` ```