diff options
| author | Misty Stanley-Jones <misty@apache.org> | 2017-04-03 16:54:34 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2017-04-03 16:54:34 -0700 |
| commit | 473c5701cb66403b0535a5c01845cb0f27fbeb47 (patch) | |
| tree | 9a40326ad4b426655abca7377dc30da003847d4d /docs/reference/commandline/build.md | |
| parent | ce07fb6b0f1b8765b92022e45f96bd4349812e06 (diff) | |
| parent | 71e6babfa2598669218177b5b429e873b7f35e8f (diff) | |
| download | docker-1.13.x.tar.gz | |
Merge pull request #32332 from mstanleyjones/1.13.x1.13.x
Cherry-pick command-line ref improvements
Diffstat (limited to 'docs/reference/commandline/build.md')
| -rw-r--r-- | docs/reference/commandline/build.md | 10 |
1 files changed, 6 insertions, 4 deletions
diff --git a/docs/reference/commandline/build.md b/docs/reference/commandline/build.md index 42c3ecf65f..b141e7422e 100644 --- a/docs/reference/commandline/build.md +++ b/docs/reference/commandline/build.md @@ -58,6 +58,8 @@ Options: --ulimit value Ulimit options (default []) ``` +## Description + Builds Docker images from a Dockerfile and a "context". A build's context is the files located in the specified `PATH` or `URL`. The build process can refer to any of the files in the context. For example, your build can use an @@ -285,7 +287,7 @@ $ docker build - < context.tar.gz This will build an image for a compressed context read from `STDIN`. Supported formats are: bzip2, gzip and xz. -### Usage of .dockerignore +### Use a .dockerignore file ```bash $ docker build . @@ -315,7 +317,7 @@ directory from the context. Its effect can be seen in the changed size of the uploaded context. The builder reference contains detailed information on [creating a .dockerignore file](../builder.md#dockerignore-file) -### Tag image (-t) +### Tag an image (-t) ```bash $ docker build -t vieux/apache:2.0 . @@ -334,7 +336,7 @@ For example, to tag an image both as `whenry/fedora-jboss:latest` and ```bash $ docker build -t whenry/fedora-jboss:latest -t whenry/fedora-jboss:v2.1 . ``` -### Specify Dockerfile (-f) +### Specify a Dockerfile (-f) ```bash $ docker build -f Dockerfile.debug . @@ -373,7 +375,7 @@ the command line. > repeatable builds on remote Docker hosts. This is also the reason why > `ADD ../file` will not work. -### Optional parent cgroup (--cgroup-parent) +### Use a custom parent cgroup (--cgroup-parent) When `docker build` is run with the `--cgroup-parent` option the containers used in the build will be run with the [corresponding `docker run` |