docker image build
Description
Build an image from a Dockerfile
Usage
docker image build [OPTIONS] PATH | URL | -
Options
Name, shorthand | Default | Description |
--add-host |
Add a custom host-to-IP mapping (host:ip) | |
--build-arg |
Set build-time variables | |
--cache-from |
Images to consider as cache sources | |
--cgroup-parent |
Optional parent cgroup for the container | |
--compress |
Compress the build context using gzip | |
--cpu-period |
Limit the CPU CFS (Completely Fair Scheduler) period | |
--cpu-quota |
Limit the CPU CFS (Completely Fair Scheduler) quota | |
--cpu-shares , -c |
CPU shares (relative weight) | |
--cpuset-cpus |
CPUs in which to allow execution (0-3, 0,1) | |
--cpuset-mems |
MEMs in which to allow execution (0-3, 0,1) | |
--disable-content-trust |
true |
Skip image verification |
--file , -f |
Name of the Dockerfile (Default is ‘PATH/Dockerfile’) | |
--force-rm |
Always remove intermediate containers | |
--iidfile |
Write the image ID to the file | |
--isolation |
Container isolation technology | |
--label |
Set metadata for an image | |
--memory , -m |
Memory limit | |
--memory-swap |
Swap limit equal to memory plus swap: ‘-1’ to enable unlimited swap | |
--network |
API 1.25+ Set the networking mode for the RUN instructions during build |
|
--no-cache |
Do not use cache when building the image | |
--platform |
experimental (daemon)API 1.32+ Set platform if server is multi-platform capable |
|
--progress |
auto |
Set type of progress output (auto, plain, tty). Use plain to show container output |
--pull |
Always attempt to pull a newer version of the image | |
--quiet , -q |
Suppress the build output and print image ID on success | |
--rm |
true |
Remove intermediate containers after a successful build |
--secret |
API 1.39+ Secret file to expose to the build (only if BuildKit enabled): id=mysecret,src=/v18.09/local/secret |
|
--security-opt |
Security options | |
--shm-size |
Size of /dev/shm | |
--squash |
experimental (daemon)API 1.25+ Squash newly built layers into a single new layer |
|
--ssh |
API 1.39+ SSH agent socket or keys to expose to the build (only if BuildKit enabled) (format: default| |
|
--stream |
experimental (daemon)API 1.31+ Stream attaches to server to negotiate build context |
|
--tag , -t |
Name and optionally a tag in the ‘name:tag’ format | |
--target |
Set the target build stage to build. | |
--ulimit |
Ulimit options |
Parent command
Command | Description |
---|---|
docker image | Manage images |
Related commands
Command | Description |
docker image build | Build an image from a Dockerfile |
docker image history | Show the history of an image |
docker image import | Import the contents from a tarball to create a filesystem image |
docker image inspect | Display detailed information on one or more images |
docker image load | Load an image from a tar archive or STDIN |
docker image ls | List images |
docker image prune | Remove unused images |
docker image pull | Pull an image or a repository from a registry |
docker image push | Push an image or a repository to a registry |
docker image rm | Remove one or more images |
docker image save | Save one or more images to a tar archive (streamed to STDOUT by default) |
docker image tag | Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE |
© 2019 Docker, Inc.
Licensed under the Apache License, Version 2.0.
Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. in the United States and/or other countries.
Docker, Inc. and other parties may also have trademark rights in other terms used herein.
https://docs.docker.com/v18.09/engine/reference/commandline/image_build/