Browse code
add 'docker create' man page
Docker-DCO-1.1-Signed-off-by: SvenDowideit <SvenDowideit@home.org.au> (github: SvenDowideit)
SvenDowideit authored on 2014/08/20 10:10:42Showing 2 changed files
| 1 | 1 |
new file mode 100644 |
| ... | ... |
@@ -0,0 +1,131 @@ |
| 0 |
+% DOCKER(1) Docker User Manuals |
|
| 1 |
+% Docker Community |
|
| 2 |
+% JUNE 2014 |
|
| 3 |
+# NAME |
|
| 4 |
+docker-create - Create a new container |
|
| 5 |
+ |
|
| 6 |
+# SYNOPSIS |
|
| 7 |
+**docker create** |
|
| 8 |
+[**-a**|**--attach**[=*[]*]] |
|
| 9 |
+[**-c**|**--cpu-shares**[=*0*]] |
|
| 10 |
+[**--cap-add**[=*[]*]] |
|
| 11 |
+[**--cap-drop**[=*[]*]] |
|
| 12 |
+[**--cidfile**[=*CIDFILE*]] |
|
| 13 |
+[**--cpuset**[=*CPUSET*]] |
|
| 14 |
+[**--device**[=*[]*]] |
|
| 15 |
+[**--dns-search**[=*[]*]] |
|
| 16 |
+[**--dns**[=*[]*]] |
|
| 17 |
+[**-e**|**--env**[=*[]*]] |
|
| 18 |
+[**--entrypoint**[=*ENTRYPOINT*]] |
|
| 19 |
+[**--env-file**[=*[]*]] |
|
| 20 |
+[**--expose**[=*[]*]] |
|
| 21 |
+[**-h**|**--hostname**[=*HOSTNAME*]] |
|
| 22 |
+[**-i**|**--interactive**[=*false*]] |
|
| 23 |
+[**--link**[=*[]*]] |
|
| 24 |
+[**--lxc-conf**[=*[]*]] |
|
| 25 |
+[**-m**|**--memory**[=*MEMORY*]] |
|
| 26 |
+[**--name**[=*NAME*]] |
|
| 27 |
+[**--net**[=*"bridge"*]] |
|
| 28 |
+[**-P**|**--publish-all**[=*false*]] |
|
| 29 |
+[**-p**|**--publish**[=*[]*]] |
|
| 30 |
+[**--privileged**[=*false*]] |
|
| 31 |
+[**-t**|**--tty**[=*false*]] |
|
| 32 |
+[**-u**|**--user**[=*USER*]] |
|
| 33 |
+[**-v**|**--volume**[=*[]*]] |
|
| 34 |
+[**--volumes-from**[=*[]*]] |
|
| 35 |
+[**-w**|**--workdir**[=*WORKDIR*]] |
|
| 36 |
+ IMAGE [COMMAND] [ARG...] |
|
| 37 |
+ |
|
| 38 |
+# OPTIONS |
|
| 39 |
+**-a**, **--attach**=[] |
|
| 40 |
+ Attach to STDIN, STDOUT or STDERR. |
|
| 41 |
+ |
|
| 42 |
+**-c**, **--cpu-shares**=0 |
|
| 43 |
+ CPU shares (relative weight) |
|
| 44 |
+ |
|
| 45 |
+**--cap-add**=[] |
|
| 46 |
+ Add Linux capabilities |
|
| 47 |
+ |
|
| 48 |
+**--cap-drop**=[] |
|
| 49 |
+ Drop Linux capabilities |
|
| 50 |
+ |
|
| 51 |
+**--cidfile**="" |
|
| 52 |
+ Write the container ID to the file |
|
| 53 |
+ |
|
| 54 |
+**--cpuset**="" |
|
| 55 |
+ CPUs in which to allow execution (0-3, 0,1) |
|
| 56 |
+ |
|
| 57 |
+**--device**=[] |
|
| 58 |
+ Add a host device to the container (e.g. --device=/dev/sdc:/dev/xvdc) |
|
| 59 |
+ |
|
| 60 |
+**--dns-search**=[] |
|
| 61 |
+ Set custom DNS search domains |
|
| 62 |
+ |
|
| 63 |
+**--dns**=[] |
|
| 64 |
+ Set custom DNS servers |
|
| 65 |
+ |
|
| 66 |
+**-e**, **--env**=[] |
|
| 67 |
+ Set environment variables |
|
| 68 |
+ |
|
| 69 |
+**--entrypoint**="" |
|
| 70 |
+ Overwrite the default ENTRYPOINT of the image |
|
| 71 |
+ |
|
| 72 |
+**--env-file**=[] |
|
| 73 |
+ Read in a line delimited file of environment variables |
|
| 74 |
+ |
|
| 75 |
+**--expose**=[] |
|
| 76 |
+ Expose a port from the container without publishing it to your host |
|
| 77 |
+ |
|
| 78 |
+**-h**, **--hostname**="" |
|
| 79 |
+ Container host name |
|
| 80 |
+ |
|
| 81 |
+**-i**, **--interactive**=*true*|*false* |
|
| 82 |
+ Keep STDIN open even if not attached. The default is *false*. |
|
| 83 |
+ |
|
| 84 |
+**--link**=[] |
|
| 85 |
+ Add link to another container in the form of name:alias |
|
| 86 |
+ |
|
| 87 |
+**--lxc-conf**=[] |
|
| 88 |
+ (lxc exec-driver only) Add custom lxc options --lxc-conf="lxc.cgroup.cpuset.cpus = 0,1" |
|
| 89 |
+ |
|
| 90 |
+**-m**, **--memory**="" |
|
| 91 |
+ Memory limit (format: <number><optional unit>, where unit = b, k, m or g) |
|
| 92 |
+ |
|
| 93 |
+**--name**="" |
|
| 94 |
+ Assign a name to the container |
|
| 95 |
+ |
|
| 96 |
+**--net**="bridge" |
|
| 97 |
+ Set the Network mode for the container |
|
| 98 |
+ 'bridge': creates a new network stack for the container on the docker bridge |
|
| 99 |
+ 'none': no networking for this container |
|
| 100 |
+ 'container:<name|id>': reuses another container network stack |
|
| 101 |
+ 'host': use the host network stack inside the container. Note: the host mode gives the container full access to local system services such as D-bus and is therefore considered insecure. |
|
| 102 |
+ |
|
| 103 |
+**-P**, **--publish-all**=*true*|*false* |
|
| 104 |
+ Publish all exposed ports to the host interfaces. The default is *false*. |
|
| 105 |
+ |
|
| 106 |
+**-p**, **--publish**=[] |
|
| 107 |
+ Publish a container's port to the host |
|
| 108 |
+ format: ip:hostPort:containerPort | ip::containerPort | hostPort:containerPort |
|
| 109 |
+ (use 'docker port' to see the actual mapping) |
|
| 110 |
+ |
|
| 111 |
+**--privileged**=*true*|*false* |
|
| 112 |
+ Give extended privileges to this container. The default is *false*. |
|
| 113 |
+ |
|
| 114 |
+**-t**, **--tty**=*true*|*false* |
|
| 115 |
+ Allocate a pseudo-TTY. The default is *false*. |
|
| 116 |
+ |
|
| 117 |
+**-u**, **--user**="" |
|
| 118 |
+ Username or UID |
|
| 119 |
+ |
|
| 120 |
+**-v**, **--volume**=[] |
|
| 121 |
+ Bind mount a volume (e.g., from the host: -v /host:/container, from Docker: -v /container) |
|
| 122 |
+ |
|
| 123 |
+**--volumes-from**=[] |
|
| 124 |
+ Mount volumes from the specified container(s) |
|
| 125 |
+ |
|
| 126 |
+**-w**, **--workdir**="" |
|
| 127 |
+ Working directory inside the container |
|
| 128 |
+ |
|
| 129 |
+# HISTORY |
|
| 130 |
+August 2014, updated by Sven Dowideit <SvenDowideit@home.org.au> |
| ... | ... |
@@ -89,10 +89,12 @@ unix://[/path/to/socket] to use. |
| 89 | 89 |
**docker-cp(1)** |
| 90 | 90 |
Copy files/folders from a container's filesystem to the host at path |
| 91 | 91 |
|
| 92 |
+**docker-create(1)** |
|
| 93 |
+ Create a new container |
|
| 94 |
+ |
|
| 92 | 95 |
**docker-diff(1)** |
| 93 | 96 |
Inspect changes on a container's filesystem |
| 94 | 97 |
|
| 95 |
- |
|
| 96 | 98 |
**docker-events(1)** |
| 97 | 99 |
Get real time events from the server |
| 98 | 100 |
|