Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: add docs for build —target #33185

Merged
merged 2 commits into from May 15, 2017
Merged
Changes from all commits
Commits
File filter...
Filter file types
Jump to…
Jump to file or symbol
Failed to load files and symbols.

Always

Just for now

@@ -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

ProTip! Use n and p to navigate between commits in a pull request.
You can’t perform that action at this time.