make docker build -rm=true default #4292
Docker-DCO-1.1-Signed-off-by: Brian Goff <cpuguy83@gmail.com> (github: cpuguy83)master
parent
9d1894a44c
commit
730417f46f
|
@ -185,11 +185,11 @@ Examples:
|
||||||
|
|
||||||
Usage: docker build [OPTIONS] PATH | URL | -
|
Usage: docker build [OPTIONS] PATH | URL | -
|
||||||
Build a new container image from the source code at PATH
|
Build a new container image from the source code at PATH
|
||||||
-t, --time="": Repository name (and optionally a tag) to be applied
|
-t, --time="": Repository name (and optionally a tag) to be applied
|
||||||
to the resulting image in case of success.
|
to the resulting image in case of success.
|
||||||
-q, --quiet=false: Suppress the verbose output generated by the containers.
|
-q, --quiet=false: Suppress the verbose output generated by the containers.
|
||||||
--no-cache: Do not use the cache when building the image.
|
--no-cache: Do not use the cache when building the image.
|
||||||
--rm: Remove intermediate containers after a successful build
|
--rm=true: Remove intermediate containers after a successful build
|
||||||
|
|
||||||
The files at ``PATH`` or ``URL`` are called the "context" of the build. The
|
The files at ``PATH`` or ``URL`` are called the "context" of the build. The
|
||||||
build process may refer to any of the files in the context, for example when
|
build process may refer to any of the files in the context, for example when
|
||||||
|
@ -198,8 +198,6 @@ is given as ``URL``, then no context is set. When a Git repository is set as
|
||||||
``URL``, then the repository is used as the context. Git repositories are
|
``URL``, then the repository is used as the context. Git repositories are
|
||||||
cloned with their submodules (`git clone --recursive`).
|
cloned with their submodules (`git clone --recursive`).
|
||||||
|
|
||||||
.. note:: ``docker build --rm`` does not affect the image cache which is used to accelerate builds, it only removes the duplicate writeable container layers.
|
|
||||||
|
|
||||||
.. _cli_build_examples:
|
.. _cli_build_examples:
|
||||||
|
|
||||||
.. seealso:: :ref:`dockerbuilder`.
|
.. seealso:: :ref:`dockerbuilder`.
|
||||||
|
@ -209,7 +207,7 @@ Examples:
|
||||||
|
|
||||||
.. code-block:: bash
|
.. code-block:: bash
|
||||||
|
|
||||||
$ sudo docker build --rm .
|
$ sudo docker build .
|
||||||
Uploading context 10240 bytes
|
Uploading context 10240 bytes
|
||||||
Step 1 : FROM busybox
|
Step 1 : FROM busybox
|
||||||
Pulling repository busybox
|
Pulling repository busybox
|
||||||
|
@ -249,9 +247,8 @@ The transfer of context from the local machine to the Docker daemon is
|
||||||
what the ``docker`` client means when you see the "Uploading context"
|
what the ``docker`` client means when you see the "Uploading context"
|
||||||
message.
|
message.
|
||||||
|
|
||||||
The ``--rm`` option tells Docker to remove the intermediate containers and
|
If you wish to keep the intermediate containers after the build is complete,
|
||||||
layers that were used to create each image layer. Doing so has no impact on
|
you must use ``--rm=false``. This does not affect the build cache.
|
||||||
the image build cache.
|
|
||||||
|
|
||||||
|
|
||||||
.. code-block:: bash
|
.. code-block:: bash
|
||||||
|
|
Loading…
Reference in New Issue