mirror of https://github.com/docker/docs.git
build: mention BUILDKIT_SYNTAX arg for custom dockerfile
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
This commit is contained in:
parent
b9ac2c6898
commit
60af24b241
|
@ -25,6 +25,13 @@ For example:
|
|||
# syntax=example.com/user/repo:tag@sha256:abcdef...
|
||||
```
|
||||
|
||||
You can also use the predefined `BUILDKIT_SYNTAX` build argument to set the
|
||||
frontend image reference on the command line:
|
||||
|
||||
```console
|
||||
$ docker build --build-arg BUILDKIT_SYNTAX=docker/dockerfile:1 .
|
||||
```
|
||||
|
||||
This defines the location of the Dockerfile syntax that is used to build the
|
||||
Dockerfile. The BuildKit backend allows seamlessly using external
|
||||
implementations that are distributed as Docker images and execute inside a
|
||||
|
@ -32,17 +39,18 @@ container sandbox environment.
|
|||
|
||||
Custom Dockerfile implementations allow you to:
|
||||
|
||||
- Automatically get bugfixes without updating the Docker daemon
|
||||
- Automatically get bug fixes without updating the Docker daemon
|
||||
- Make sure all users are using the same implementation to build your Dockerfile
|
||||
- Use the latest features without updating the Docker daemon
|
||||
- Try out new features or third-party features before they are integrated in the Docker daemon
|
||||
- Use [alternative build definitions, or create your own](https://github.com/moby/buildkit#exploring-llb)
|
||||
- Build your own Dockerfile frontend with custom features
|
||||
|
||||
> **Note**
|
||||
>
|
||||
> BuildKit also ships with a built-in Dockerfile frontend, but it's recommended
|
||||
> BuildKit ships with a built-in Dockerfile frontend, but it's recommended
|
||||
> to use an external image to make sure that all users use the same version on
|
||||
> the builder and to pick up bugfixes automatically without waiting for a new
|
||||
> the builder and to pick up bug fixes automatically without waiting for a new
|
||||
> version of BuildKit or Docker Engine.
|
||||
|
||||
## Official releases
|
||||
|
|
Loading…
Reference in New Issue