author | Jesse Butler <jesse.butler@oracle.com> |
Wed, 20 Jul 2016 17:19:20 -0700 | |
changeset 6468 | af5d82385cd7 |
permissions | -rw-r--r-- |
6468
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
1 |
.TH "DOCKER" "1" " Docker User Manuals" "Docker Community" "JUNE 2014" "" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
2 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
3 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
4 |
.SH NAME |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
5 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
6 |
docker\-create \- Create a new container |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
7 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
8 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
9 |
.SH SYNOPSIS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
10 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
11 |
\fBdocker create\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
12 |
[\fB\-a\fP|\fB\-\-attach\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
13 |
[\fB\-\-add\-host\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
14 |
[\fB\-\-blkio\-weight\fP[=\fI[BLKIO\-WEIGHT]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
15 |
[\fB\-\-blkio\-weight\-device\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
16 |
[\fB\-\-cpu\-shares\fP[=\fI0\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
17 |
[\fB\-\-cap\-add\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
18 |
[\fB\-\-cap\-drop\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
19 |
[\fB\-\-cgroup\-parent\fP[=\fICGROUP\-PATH\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
20 |
[\fB\-\-cidfile\fP[=\fICIDFILE\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
21 |
[\fB\-\-cpu\-period\fP[=\fI0\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
22 |
[\fB\-\-cpu\-quota\fP[=\fI0\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
23 |
[\fB\-\-cpuset\-cpus\fP[=\fICPUSET\-CPUS\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
24 |
[\fB\-\-cpuset\-mems\fP[=\fICPUSET\-MEMS\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
25 |
[\fB\-\-device\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
26 |
[\fB\-\-device\-read\-bps\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
27 |
[\fB\-\-device\-read\-iops\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
28 |
[\fB\-\-device\-write\-bps\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
29 |
[\fB\-\-device\-write\-iops\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
30 |
[\fB\-\-dns\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
31 |
[\fB\-\-dns\-search\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
32 |
[\fB\-\-dns\-opt\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
33 |
[\fB\-e\fP|\fB\-\-env\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
34 |
[\fB\-\-entrypoint\fP[=\fIENTRYPOINT\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
35 |
[\fB\-\-env\-file\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
36 |
[\fB\-\-expose\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
37 |
[\fB\-\-group\-add\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
38 |
[\fB\-h\fP|\fB\-\-hostname\fP[=\fIHOSTNAME\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
39 |
[\fB\-\-help\fP] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
40 |
[\fB\-i\fP|\fB\-\-interactive\fP] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
41 |
[\fB\-\-ip\fP[=\fIIPv4\-ADDRESS\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
42 |
[\fB\-\-ip6\fP[=\fIIPv6\-ADDRESS\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
43 |
[\fB\-\-ipc\fP[=\fIIPC\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
44 |
[\fB\-\-isolation\fP[=\fIdefault\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
45 |
[\fB\-\-kernel\-memory\fP[=\fIKERNEL\-MEMORY\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
46 |
[\fB\-l\fP|\fB\-\-label\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
47 |
[\fB\-\-label\-file\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
48 |
[\fB\-\-link\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
49 |
[\fB\-\-log\-driver\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
50 |
[\fB\-\-log\-opt\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
51 |
[\fB\-m\fP|\fB\-\-memory\fP[=\fIMEMORY\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
52 |
[\fB\-\-mac\-address\fP[=\fIMAC\-ADDRESS\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
53 |
[\fB\-\-memory\-reservation\fP[=\fIMEMORY\-RESERVATION\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
54 |
[\fB\-\-memory\-swap\fP[=\fILIMIT\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
55 |
[\fB\-\-memory\-swappiness\fP[=\fIMEMORY\-SWAPPINESS\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
56 |
[\fB\-\-name\fP[=\fINAME\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
57 |
[\fB\-\-net\fP[=\fI"bridge"\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
58 |
[\fB\-\-net\-alias\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
59 |
[\fB\-\-oom\-kill\-disable\fP] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
60 |
[\fB\-\-oom\-score\-adj\fP[=\fI0\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
61 |
[\fB\-P\fP|\fB\-\-publish\-all\fP] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
62 |
[\fB\-p\fP|\fB\-\-publish\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
63 |
[\fB\-\-pid\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
64 |
[\fB\-\-privileged\fP] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
65 |
[\fB\-\-read\-only\fP] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
66 |
[\fB\-\-restart\fP[=\fIRESTART\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
67 |
[\fB\-\-security\-opt\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
68 |
[\fB\-\-stop\-signal\fP[=\fISIGNAL\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
69 |
[\fB\-\-shm\-size\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
70 |
[\fB\-t\fP|\fB\-\-tty\fP] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
71 |
[\fB\-\-tmpfs\fP[=\fI[CONTAINER\-DIR[:<OPTIONS>]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
72 |
[\fB\-u\fP|\fB\-\-user\fP[=\fIUSER\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
73 |
[\fB\-\-ulimit\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
74 |
[\fB\-\-uts\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
75 |
[\fB\-v\fP|\fB\-\-volume\fP[=\fI[[HOST\-DIR:]CONTAINER\-DIR[:OPTIONS]]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
76 |
[\fB\-\-volume\-driver\fP[=\fIDRIVER\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
77 |
[\fB\-\-volumes\-from\fP[=\fI[]\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
78 |
[\fB\-w\fP|\fB\-\-workdir\fP[=\fIWORKDIR\fP]] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
79 |
IMAGE [COMMAND] [ARG...] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
80 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
81 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
82 |
.SH DESCRIPTION |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
83 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
84 |
Creates a writeable container layer over the specified image and prepares it for |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
85 |
running the specified command. The container ID is then printed to STDOUT. This |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
86 |
is similar to \fBdocker run \-d\fP except the container is never started. You can |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
87 |
then use the \fBdocker start <container_id>\fP command to start the container at |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
88 |
any point. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
89 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
90 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
91 |
The initial status of the container created with \fBdocker create\fP is 'created'. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
92 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
93 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
94 |
.SH OPTIONS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
95 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
96 |
\fB\-a\fP, \fB\-\-attach\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
97 |
Attach to STDIN, STDOUT or STDERR. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
98 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
99 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
100 |
\fB\-\-add\-host\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
101 |
Add a custom host\-to\-IP mapping (host:ip) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
102 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
103 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
104 |
\fB\-\-blkio\-weight\fP=\fI0\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
105 |
Block IO weight (relative weight) accepts a weight value between 10 and 1000. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
106 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
107 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
108 |
\fB\-\-blkio\-weight\-device\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
109 |
Block IO weight (relative device weight, format: \fB\fCDEVICE\_NAME:WEIGHT\fR). |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
110 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
111 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
112 |
\fB\-\-cpu\-shares\fP=\fI0\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
113 |
CPU shares (relative weight) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
114 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
115 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
116 |
\fB\-\-cap\-add\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
117 |
Add Linux capabilities |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
118 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
119 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
120 |
\fB\-\-cap\-drop\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
121 |
Drop Linux capabilities |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
122 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
123 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
124 |
\fB\-\-cgroup\-parent\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
125 |
Path to cgroups under which the cgroup for the container will be created. If the path is not absolute, the path is considered to be relative to the cgroups path of the init process. Cgroups will be created if they do not already exist. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
126 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
127 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
128 |
\fB\-\-cidfile\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
129 |
Write the container ID to the file |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
130 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
131 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
132 |
\fB\-\-cpu\-period\fP=\fI0\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
133 |
Limit the CPU CFS (Completely Fair Scheduler) period |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
134 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
135 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
136 |
\fB\-\-cpuset\-cpus\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
137 |
CPUs in which to allow execution (0\-3, 0,1) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
138 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
139 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
140 |
\fB\-\-cpuset\-mems\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
141 |
Memory nodes (MEMs) in which to allow execution (0\-3, 0,1). Only effective on NUMA systems. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
142 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
143 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
144 |
If you have four memory nodes on your system (0\-3), use \fB\fC\-\-cpuset\-mems=0,1\fR |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
145 |
then processes in your Docker container will only use memory from the first |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
146 |
two memory nodes. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
147 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
148 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
149 |
\fB\-\-cpu\-quota\fP=\fI0\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
150 |
Limit the CPU CFS (Completely Fair Scheduler) quota |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
151 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
152 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
153 |
\fB\-\-device\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
154 |
Add a host device to the container (e.g. \-\-device=/dev/sdc:/dev/xvdc:rwm) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
155 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
156 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
157 |
\fB\-\-device\-read\-bps\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
158 |
Limit read rate (bytes per second) from a device (e.g. \-\-device\-read\-bps=/dev/sda:1mb) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
159 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
160 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
161 |
\fB\-\-device\-read\-iops\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
162 |
Limit read rate (IO per second) from a device (e.g. \-\-device\-read\-iops=/dev/sda:1000) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
163 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
164 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
165 |
\fB\-\-device\-write\-bps\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
166 |
Limit write rate (bytes per second) to a device (e.g. \-\-device\-write\-bps=/dev/sda:1mb) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
167 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
168 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
169 |
\fB\-\-device\-write\-iops\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
170 |
Limit write rate (IO per second) to a device (e.g. \-\-device\-write\-iops=/dev/sda:1000) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
171 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
172 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
173 |
\fB\-\-dns\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
174 |
Set custom DNS servers |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
175 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
176 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
177 |
\fB\-\-dns\-opt\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
178 |
Set custom DNS options |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
179 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
180 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
181 |
\fB\-\-dns\-search\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
182 |
Set custom DNS search domains (Use \-\-dns\-search=. if you don't wish to set the search domain) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
183 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
184 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
185 |
\fB\-e\fP, \fB\-\-env\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
186 |
Set environment variables |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
187 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
188 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
189 |
\fB\-\-entrypoint\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
190 |
Overwrite the default ENTRYPOINT of the image |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
191 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
192 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
193 |
\fB\-\-env\-file\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
194 |
Read in a line\-delimited file of environment variables |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
195 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
196 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
197 |
\fB\-\-expose\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
198 |
Expose a port or a range of ports (e.g. \-\-expose=3300\-3310) from the container without publishing it to your host |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
199 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
200 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
201 |
\fB\-\-group\-add\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
202 |
Add additional groups to run as |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
203 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
204 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
205 |
\fB\-h\fP, \fB\-\-hostname\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
206 |
Container host name |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
207 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
208 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
209 |
\fB\-\-help\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
210 |
Print usage statement |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
211 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
212 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
213 |
\fB\-i\fP, \fB\-\-interactive\fP=\fItrue\fP|\fIfalse\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
214 |
Keep STDIN open even if not attached. The default is \fIfalse\fP. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
215 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
216 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
217 |
\fB\-\-ip\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
218 |
Sets the container's interface IPv4 address (e.g. 172.23.0.9) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
219 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
220 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
221 |
It can only be used in conjunction with \fB\-\-net\fP for user\-defined networks |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
222 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
223 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
224 |
\fB\-\-ip6\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
225 |
Sets the container's interface IPv6 address (e.g. 2001:db8::1b99) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
226 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
227 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
228 |
It can only be used in conjunction with \fB\-\-net\fP for user\-defined networks |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
229 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
230 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
231 |
\fB\-\-ipc\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
232 |
Default is to create a private IPC namespace (POSIX SysV IPC) for the container |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
233 |
'container:<name|id>': reuses another container shared memory, semaphores and message queues |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
234 |
'host': use the host shared memory,semaphores and message queues inside the container. Note: the host mode gives the container full access to local shared memory and is therefore considered insecure. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
235 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
236 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
237 |
\fB\-\-isolation\fP="\fIdefault\fP" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
238 |
Isolation specifies the type of isolation technology used by containers. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
239 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
240 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
241 |
\fB\-\-kernel\-memory\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
242 |
Kernel memory limit (format: \fB\fC<number>[<unit>]\fR, where unit = b, k, m or g) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
243 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
244 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
245 |
Constrains the kernel memory available to a container. If a limit of 0 |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
246 |
is specified (not using \fB\fC\-\-kernel\-memory\fR), the container's kernel memory |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
247 |
is not limited. If you specify a limit, it may be rounded up to a multiple |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
248 |
of the operating system's page size and the value can be very large, |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
249 |
millions of trillions. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
250 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
251 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
252 |
\fB\-l\fP, \fB\-\-label\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
253 |
Adds metadata to a container (e.g., \-\-label=com.example.key=value) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
254 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
255 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
256 |
\fB\-\-label\-file\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
257 |
Read labels from a file. Delimit each label with an EOL. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
258 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
259 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
260 |
\fB\-\-link\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
261 |
Add link to another container in the form of <name or id>:alias or just |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
262 |
<name or id> in which case the alias will match the name. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
263 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
264 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
265 |
\fB\-\-log\-driver\fP="\fIjson\-file\fP|\fIsyslog\fP|\fIjournald\fP|\fIgelf\fP|\fIfluentd\fP|\fIawslogs\fP|\fIsplunk\fP|\fInone\fP" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
266 |
Logging driver for container. Default is defined by daemon \fB\fC\-\-log\-driver\fR flag. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
267 |
\fBWarning\fP: the \fB\fCdocker logs\fR command works only for the \fB\fCjson\-file\fR and |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
268 |
\fB\fCjournald\fR logging drivers. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
269 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
270 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
271 |
\fB\-\-log\-opt\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
272 |
Logging driver specific options. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
273 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
274 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
275 |
\fB\-m\fP, \fB\-\-memory\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
276 |
Memory limit (format: <number>[<unit>], where unit = b, k, m or g) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
277 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
278 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
279 |
Allows you to constrain the memory available to a container. If the host |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
280 |
supports swap memory, then the \fB\-m\fP memory setting can be larger than physical |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
281 |
RAM. If a limit of 0 is specified (not using \fB\-m\fP), the container's memory is |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
282 |
not limited. The actual limit may be rounded up to a multiple of the operating |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
283 |
system's page size (the value would be very large, that's millions of trillions). |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
284 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
285 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
286 |
\fB\-\-mac\-address\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
287 |
Container MAC address (e.g. 92:d0:c6:0a:29:33) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
288 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
289 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
290 |
\fB\-\-memory\-reservation\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
291 |
Memory soft limit (format: <number>[<unit>], where unit = b, k, m or g) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
292 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
293 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
294 |
After setting memory reservation, when the system detects memory contention |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
295 |
or low memory, containers are forced to restrict their consumption to their |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
296 |
reservation. So you should always set the value below \fB\-\-memory\fP, otherwise the |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
297 |
hard limit will take precedence. By default, memory reservation will be the same |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
298 |
as memory limit. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
299 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
300 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
301 |
\fB\-\-memory\-swap\fP="LIMIT" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
302 |
A limit value equal to memory plus swap. Must be used with the \fB\-m\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
303 |
(\fB\-\-memory\fP) flag. The swap \fB\fCLIMIT\fR should always be larger than \fB\-m\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
304 |
(\fB\-\-memory\fP) value. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
305 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
306 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
307 |
The format of \fB\fCLIMIT\fR is \fB\fC<number>[<unit>]\fR. Unit can be \fB\fCb\fR (bytes), |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
308 |
\fB\fCk\fR (kilobytes), \fB\fCm\fR (megabytes), or \fB\fCg\fR (gigabytes). If you don't specify a |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
309 |
unit, \fB\fCb\fR is used. Set LIMIT to \fB\fC\-1\fR to enable unlimited swap. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
310 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
311 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
312 |
\fB\-\-memory\-swappiness\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
313 |
Tune a container's memory swappiness behavior. Accepts an integer between 0 and 100. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
314 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
315 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
316 |
\fB\-\-name\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
317 |
Assign a name to the container |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
318 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
319 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
320 |
\fB\-\-net\fP="\fIbridge\fP" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
321 |
Set the Network mode for the container |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
322 |
'bridge': create a network stack on the default Docker bridge |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
323 |
'none': no networking |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
324 |
'container:<name|id>': reuse another container's network stack |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
325 |
'host': use the Docker host network stack. Note: the host mode gives the container full access to local system services such as D\-bus and is therefore considered insecure. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
326 |
'<network-name>|<network-id>': connect to a user\-defined network |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
327 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
328 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
329 |
\fB\-\-net\-alias\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
330 |
Add network\-scoped alias for the container |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
331 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
332 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
333 |
\fB\-\-oom\-kill\-disable\fP=\fItrue\fP|\fIfalse\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
334 |
Whether to disable OOM Killer for the container or not. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
335 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
336 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
337 |
\fB\-\-oom\-score\-adj\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
338 |
Tune the host's OOM preferences for containers (accepts \-1000 to 1000) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
339 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
340 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
341 |
\fB\-P\fP, \fB\-\-publish\-all\fP=\fItrue\fP|\fIfalse\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
342 |
Publish all exposed ports to random ports on the host interfaces. The default is \fIfalse\fP. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
343 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
344 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
345 |
\fB\-p\fP, \fB\-\-publish\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
346 |
Publish a container's port, or a range of ports, to the host |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
347 |
format: ip:hostPort:containerPort | ip::containerPort | hostPort:containerPort | containerPort |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
348 |
Both hostPort and containerPort can be specified as a range of ports. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
349 |
When specifying ranges for both, the number of container ports in the range must match the number of host ports in the range. (e.g., \fB\fC\-p 1234\-1236:1234\-1236/tcp\fR) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
350 |
(use 'docker port' to see the actual mapping) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
351 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
352 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
353 |
\fB\-\-pid\fP=\fIhost\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
354 |
Set the PID mode for the container |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
355 |
\fBhost\fP: use the host's PID namespace inside the container. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
356 |
Note: the host mode gives the container full access to local PID and is therefore considered insecure. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
357 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
358 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
359 |
\fB\-\-privileged\fP=\fItrue\fP|\fIfalse\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
360 |
Give extended privileges to this container. The default is \fIfalse\fP. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
361 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
362 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
363 |
\fB\-\-read\-only\fP=\fItrue\fP|\fIfalse\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
364 |
Mount the container's root filesystem as read only. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
365 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
366 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
367 |
\fB\-\-restart\fP="\fIno\fP" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
368 |
Restart policy to apply when a container exits (no, on\-failure[:max\-retry], always, unless\-stopped). |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
369 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
370 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
371 |
\fB\-\-shm\-size\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
372 |
Size of \fB\fC/dev/shm\fR. The format is \fB\fC<number><unit>\fR. \fB\fCnumber\fR must be greater than \fB\fC0\fR. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
373 |
Unit is optional and can be \fB\fCb\fR (bytes), \fB\fCk\fR (kilobytes), \fB\fCm\fR (megabytes), or \fB\fCg\fR (gigabytes). If you omit the unit, the system uses bytes. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
374 |
If you omit the size entirely, the system uses \fB\fC64m\fR. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
375 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
376 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
377 |
\fB\-\-security\-opt\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
378 |
Security Options |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
379 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
380 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
381 |
\fB\-\-stop\-signal\fP=\fISIGTERM\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
382 |
Signal to stop a container. Default is SIGTERM. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
383 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
384 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
385 |
\fB\-t\fP, \fB\-\-tty\fP=\fItrue\fP|\fIfalse\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
386 |
Allocate a pseudo\-TTY. The default is \fIfalse\fP. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
387 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
388 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
389 |
\fB\-\-tmpfs\fP=[] Create a tmpfs mount |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
390 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
391 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
392 |
Mount a temporary filesystem (\fB\fCtmpfs\fR) mount into a container, for example: |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
393 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
394 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
395 |
$ docker run \-d \-\-tmpfs /tmp:rw,size=787448k,mode=1777 my\_image |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
396 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
397 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
398 |
This command mounts a \fB\fCtmpfs\fR at \fB\fC/tmp\fR within the container. The supported mount |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
399 |
options are the same as the Linux default \fB\fCmount\fR flags. If you do not specify |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
400 |
any options, the systems uses the following options: |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
401 |
\fB\fCrw,noexec,nosuid,nodev,size=65536k\fR. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
402 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
403 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
404 |
\fB\-u\fP, \fB\-\-user\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
405 |
Username or UID |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
406 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
407 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
408 |
\fB\-\-ulimit\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
409 |
Ulimit options |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
410 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
411 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
412 |
\fB\-\-uts\fP=\fIhost\fP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
413 |
Set the UTS mode for the container |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
414 |
\fBhost\fP: use the host's UTS namespace inside the container. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
415 |
Note: the host mode gives the container access to changing the host's hostname and is therefore considered insecure. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
416 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
417 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
418 |
\fB\-v\fP|\fB\-\-volume\fP[=\fI[[HOST\-DIR:]CONTAINER\-DIR[:OPTIONS]]\fP] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
419 |
Create a bind mount. If you specify, \fB\fC\-v /HOST\-DIR:/CONTAINER\-DIR\fR, Docker |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
420 |
bind mounts \fB\fC/HOST\-DIR\fR in the host to \fB\fC/CONTAINER\-DIR\fR in the Docker |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
421 |
container. If 'HOST\-DIR' is omitted, Docker automatically creates the new |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
422 |
volume on the host. The \fB\fCOPTIONS\fR are a comma delimited list and can be: |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
423 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
424 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
425 |
\item [rw|ro] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
426 |
\item [z|Z] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
427 |
\item [\fB\fC[r]shared\fR|\fB\fC[r]slave\fR|\fB\fC[r]private\fR] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
428 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
429 |
The \fB\fCCONTAINER\-DIR\fR must be an absolute path such as \fB\fC/src/docs\fR. The \fB\fCHOST\-DIR\fR |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
430 |
can be an absolute path or a \fB\fCname\fR value. A \fB\fCname\fR value must start with an |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
431 |
alphanumeric character, followed by \fB\fCa\-z0\-9\fR, \fB\fC\_\fR (underscore), \fB\fC.\fR (period) or |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
432 |
\fB\fC\-\fR (hyphen). An absolute path starts with a \fB\fC/\fR (forward slash). |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
433 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
434 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
435 |
If you supply a \fB\fCHOST\-DIR\fR that is an absolute path, Docker bind\-mounts to the |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
436 |
path you specify. If you supply a \fB\fCname\fR, Docker creates a named volume by that |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
437 |
\fB\fCname\fR. For example, you can specify either \fB\fC/foo\fR or \fB\fCfoo\fR for a \fB\fCHOST\-DIR\fR |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
438 |
value. If you supply the \fB\fC/foo\fR value, Docker creates a bind\-mount. If you |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
439 |
supply the \fB\fCfoo\fR specification, Docker creates a named volume. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
440 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
441 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
442 |
You can specify multiple \fB\-v\fP options to mount one or more mounts to a |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
443 |
container. To use these same mounts in other containers, specify the |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
444 |
\fB\-\-volumes\-from\fP option also. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
445 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
446 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
447 |
You can add \fB\fC:ro\fR or \fB\fC:rw\fR suffix to a volume to mount it read\-only or |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
448 |
read\-write mode, respectively. By default, the volumes are mounted read\-write. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
449 |
See examples. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
450 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
451 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
452 |
Labeling systems like SELinux require that proper labels are placed on volume |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
453 |
content mounted into a container. Without a label, the security system might |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
454 |
prevent the processes running inside the container from using the content. By |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
455 |
default, Docker does not change the labels set by the OS. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
456 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
457 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
458 |
To change a label in the container context, you can add either of two suffixes |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
459 |
\fB\fC:z\fR or \fB\fC:Z\fR to the volume mount. These suffixes tell Docker to relabel file |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
460 |
objects on the shared volumes. The \fB\fCz\fR option tells Docker that two containers |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
461 |
share the volume content. As a result, Docker labels the content with a shared |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
462 |
content label. Shared volume labels allow all containers to read/write content. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
463 |
The \fB\fCZ\fR option tells Docker to label the content with a private unshared label. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
464 |
Only the current container can use a private volume. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
465 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
466 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
467 |
By default bind mounted volumes are \fB\fCprivate\fR. That means any mounts done |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
468 |
inside container will not be visible on host and vice\-a\-versa. One can change |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
469 |
this behavior by specifying a volume mount propagation property. Making a |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
470 |
volume \fB\fCshared\fR mounts done under that volume inside container will be |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
471 |
visible on host and vice\-a\-versa. Making a volume \fB\fCslave\fR enables only one |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
472 |
way mount propagation and that is mounts done on host under that volume |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
473 |
will be visible inside container but not the other way around. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
474 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
475 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
476 |
To control mount propagation property of volume one can use \fB\fC:[r]shared\fR, |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
477 |
\fB\fC:[r]slave\fR or \fB\fC:[r]private\fR propagation flag. Propagation property can |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
478 |
be specified only for bind mounted volumes and not for internal volumes or |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
479 |
named volumes. For mount propagation to work source mount point (mount point |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
480 |
where source dir is mounted on) has to have right propagation properties. For |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
481 |
shared volumes, source mount point has to be shared. And for slave volumes, |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
482 |
source mount has to be either shared or slave. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
483 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
484 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
485 |
Use \fB\fCdf <source\-dir>\fR to figure out the source mount and then use |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
486 |
\fB\fCfindmnt \-o TARGET,PROPAGATION <source\-mount\-dir>\fR to figure out propagation |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
487 |
properties of source mount. If \fB\fCfindmnt\fR utility is not available, then one |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
488 |
can look at mount entry for source mount point in \fB\fC/proc/self/mountinfo\fR. Look |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
489 |
at \fB\fCoptional fields\fR and see if any propagaion properties are specified. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
490 |
\fB\fCshared:X\fR means mount is \fB\fCshared\fR, \fB\fCmaster:X\fR means mount is \fB\fCslave\fR and if |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
491 |
nothing is there that means mount is \fB\fCprivate\fR. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
492 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
493 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
494 |
To change propagation properties of a mount point use \fB\fCmount\fR command. For |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
495 |
example, if one wants to bind mount source directory \fB\fC/foo\fR one can do |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
496 |
\fB\fCmount \-\-bind /foo /foo\fR and \fB\fCmount \-\-make\-private \-\-make\-shared /foo\fR. This |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
497 |
will convert /foo into a \fB\fCshared\fR mount point. Alternatively one can directly |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
498 |
change propagation properties of source mount. Say \fB\fC/\fR is source mount for |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
499 |
\fB\fC/foo\fR, then use \fB\fCmount \-\-make\-shared /\fR to convert \fB\fC/\fR into a \fB\fCshared\fR mount. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
500 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
501 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
502 |
.RS |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
503 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
504 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
505 |
\fBNote\fP: |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
506 |
When using systemd to manage the Docker daemon's start and stop, in the systemd |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
507 |
unit file there is an option to control mount propagation for the Docker daemon |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
508 |
itself, called \fB\fCMountFlags\fR. The value of this setting may cause Docker to not |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
509 |
see mount propagation changes made on the mount point. For example, if this value |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
510 |
is \fB\fCslave\fR, you may not be able to use the \fB\fCshared\fR or \fB\fCrshared\fR propagation on |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
511 |
a volume. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
512 |
.RE |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
513 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
514 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
515 |
\fB\-\-volume\-driver\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
516 |
Container's volume driver. This driver creates volumes specified either from |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
517 |
a Dockerfile's \fB\fCVOLUME\fR instruction or from the \fB\fCdocker run \-v\fR flag. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
518 |
See \fBdocker\-volume\-create(1)\fP for full details. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
519 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
520 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
521 |
\fB\-\-volumes\-from\fP=[] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
522 |
Mount volumes from the specified container(s) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
523 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
524 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
525 |
\fB\-w\fP, \fB\-\-workdir\fP="" |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
526 |
Working directory inside the container |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
527 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
528 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
529 |
.SH EXAMPLES |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
530 |
.SH Specify isolation technology for container (\-\-isolation) |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
531 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
532 |
This option is useful in situations where you are running Docker containers on |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
533 |
Windows. The \fB\fC\-\-isolation=<value>\fR option sets a container's isolation |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
534 |
technology. On Linux, the only supported is the \fB\fCdefault\fR option which uses |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
535 |
Linux namespaces. On Microsoft Windows, you can specify these values: |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
536 |
.IP \n+[step] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
537 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
538 |
\item \fB\fCdefault\fR: Use the value specified by the Docker daemon's \fB\fC\-\-exec\-opt\fR . If the \fB\fCdaemon\fR does not specify an isolation technology, Microsoft Windows uses \fB\fCprocess\fR as its default value. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
539 |
\item \fB\fCprocess\fR: Namespace isolation only. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
540 |
\item \fB\fChyperv\fR: Hyper\-V hypervisor partition\-based isolation. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
541 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
542 |
Specifying the \fB\fC\-\-isolation\fR flag without a value is the same as setting \fB\fC\-\-isolation="default"\fR. |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
543 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
544 |
|
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
545 |
.SH HISTORY |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
546 |
.PP |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
547 |
August 2014, updated by Sven Dowideit |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
548 |
\[la][email protected]\[ra] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
549 |
September 2014, updated by Sven Dowideit |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
550 |
\[la][email protected]\[ra] |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
551 |
November 2014, updated by Sven Dowideit |
af5d82385cd7
PSARC/2016/354 Docker Engine 1.10.3
Jesse Butler <jesse.butler@oracle.com>
parents:
diff
changeset
|
552 |
\[la][email protected]\[ra] |