@@ -57,6 +57,7 @@ Options:

                                 or `g` (gigabytes). If you omit the unit, the system uses bytes.

       --squash                  Squash newly built layers into a single new layer (**Experimental Only**)

   -t, --tag value               Name and optionally a tag in the 'name:tag' format (default [])

+      --target string           Set the target build stage to build.

       --ulimit value            Ulimit options (default [])

 ```

@@ -454,6 +455,24 @@ more `--add-host` flags. This example adds a static address for a host named

     $ docker build --add-host=docker:10.180.0.1 .

+### Specifying target build stage (--target)

+

+When building a Dockerfile with multiple build stages, `--target` can be used to

+specify an intermediate build stage by name as a final stage for the resulting

+image. Commands after the target stage will be skipped.

+

+```Dockerfile

+FROM debian AS build-env

+...

+

+FROM alpine AS production-env

+...

+```

+

+```bash

+$ docker build -t mybuildimage --target build-env .

+```

+

 ### Squash an image's layers (--squash) **Experimental Only**

 #### Overview

@@ -8,6 +8,7 @@ docker-build - Build an image from a Dockerfile

 **docker build**

 [**--add-host**[=*[]*]]

 [**--build-arg**[=*[]*]]

+[**--cache-from**[=*[]*]]

 [**--cpu-shares**[=*0*]]

 [**--cgroup-parent**[=*CGROUP-PARENT*]]

 [**--help**]

@@ -31,6 +32,7 @@ docker-build - Build an image from a Dockerfile

 [**--cpu-quota**[=*0*]]

 [**--cpuset-cpus**[=*CPUSET-CPUS*]]

 [**--cpuset-mems**[=*CPUSET-MEMS*]]

+[**--target**[=*[]*]]

 [**--ulimit**[=*[]*]]

 PATH | URL | -

@@ -93,6 +95,9 @@ option can be set multiple times.

    or for variable expansion in other Dockerfile instructions. This is not meant

    for passing secret values. [Read more about the buildargs instruction](https://docs.docker.com/engine/reference/builder/#arg)

+**--cache-from**=""

+   Set image that will be used as a build cache source.

+

 **--force-rm**=*true*|*false*

    Always remove intermediate containers, even after unsuccessful builds. The default is *false*.

@@ -233,6 +238,9 @@ two memory nodes.

   If the path is not absolute, the path is considered relative to the `cgroups` path of the init process.

 Cgroups are created if they do not already exist.

+**--target**=""

+   Set the target build stage name.

+

 **--ulimit**=[]

   Ulimit options