mirror of
https://github.com/docker/cli.git
synced 2025-08-31 23:02:07 +03:00
e91f0ded9c
Move common flag descriptions to the buildx build reference, and make that page the canonical page in docs. Also rewrite some content in image_build to make clear that this page is only for the legacy builder. Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
48 lines
8.0 KiB
Markdown
48 lines
8.0 KiB
Markdown
# docker build
|
|
|
|
<!---MARKER_GEN_START-->
|
|
Build an image from a Dockerfile
|
|
|
|
### Aliases
|
|
|
|
`docker image build`, `docker build`, `docker builder build`
|
|
|
|
### Options
|
|
|
|
| Name | Type | Default | Description |
|
|
|:-----------------------------------------------------------------------------------------------------------------------------------------------------|:--------------|:----------|:------------------------------------------------------------------|
|
|
| [`--add-host`](https://docs.docker.com/reference/cli/docker/buildx/build/#add-host) | `list` | | Add a custom host-to-IP mapping (`host:ip`) |
|
|
| [`--build-arg`](https://docs.docker.com/reference/cli/docker/buildx/build/#build-arg) | `list` | | Set build-time variables |
|
|
| `--cache-from` | `stringSlice` | | Images to consider as cache sources |
|
|
| [`--cgroup-parent`](https://docs.docker.com/reference/cli/docker/buildx/build/#cgroup-parent) | `string` | | Set the parent cgroup for the `RUN` instructions during build |
|
|
| `--compress` | | | Compress the build context using gzip |
|
|
| `--cpu-period` | `int64` | `0` | Limit the CPU CFS (Completely Fair Scheduler) period |
|
|
| `--cpu-quota` | `int64` | `0` | Limit the CPU CFS (Completely Fair Scheduler) quota |
|
|
| `-c`, `--cpu-shares` | `int64` | `0` | CPU shares (relative weight) |
|
|
| `--cpuset-cpus` | `string` | | CPUs in which to allow execution (0-3, 0,1) |
|
|
| `--cpuset-mems` | `string` | | MEMs in which to allow execution (0-3, 0,1) |
|
|
| `--disable-content-trust` | `bool` | `true` | Skip image verification |
|
|
| [`-f`](https://docs.docker.com/reference/cli/docker/buildx/build/#file), [`--file`](https://docs.docker.com/reference/cli/docker/buildx/build/#file) | `string` | | Name of the Dockerfile (Default is `PATH/Dockerfile`) |
|
|
| `--force-rm` | | | Always remove intermediate containers |
|
|
| `--iidfile` | `string` | | Write the image ID to the file |
|
|
| `--isolation` | `string` | | Container isolation technology |
|
|
| `--label` | `list` | | Set metadata for an image |
|
|
| `-m`, `--memory` | `bytes` | `0` | Memory limit |
|
|
| `--memory-swap` | `bytes` | `0` | Swap limit equal to memory plus swap: -1 to enable unlimited swap |
|
|
| [`--network`](https://docs.docker.com/reference/cli/docker/buildx/build/#network) | `string` | `default` | Set the networking mode for the RUN instructions during build |
|
|
| `--no-cache` | | | Do not use cache when building the image |
|
|
| `--platform` | `string` | | Set platform if server is multi-platform capable |
|
|
| `--pull` | | | Always attempt to pull a newer version of the image |
|
|
| `-q`, `--quiet` | | | Suppress the build output and print image ID on success |
|
|
| `--rm` | `bool` | `true` | Remove intermediate containers after a successful build |
|
|
| `--security-opt` | `stringSlice` | | Security options |
|
|
| `--shm-size` | `bytes` | `0` | Size of `/dev/shm` |
|
|
| `--squash` | | | Squash newly built layers into a single new layer |
|
|
| [`-t`](https://docs.docker.com/reference/cli/docker/buildx/build/#tag), [`--tag`](https://docs.docker.com/reference/cli/docker/buildx/build/#tag) | `list` | | Name and optionally a tag in the `name:tag` format |
|
|
| [`--target`](https://docs.docker.com/reference/cli/docker/buildx/build/#target) | `string` | | Set the target build stage to build. |
|
|
| `--ulimit` | `ulimit` | | Ulimit options |
|
|
|
|
|
|
<!---MARKER_GEN_END-->
|
|
|