Merge pull request #3451 from AkhilManoj03/3121-improve-file-flag-docs
Docs: document remote URL support for --file flag in buildx build
This commit is contained in:
@@ -553,13 +553,37 @@ the daemon runs the containers used in the build with the
|
||||
### <a name="file"></a> Specify a Dockerfile (-f, --file)
|
||||
|
||||
```console
|
||||
$ docker buildx build -f <filepath> .
|
||||
$ docker buildx build -f [PATH|URL|-] .
|
||||
```
|
||||
|
||||
Specifies the filepath of the Dockerfile to use.
|
||||
Specifies the location of the Dockerfile to use.
|
||||
If unspecified, a file named `Dockerfile` at the root of the build context is used by default.
|
||||
|
||||
To read a Dockerfile from stdin, you can use `-` as the argument for `--file`.
|
||||
The supported inputs formats are:
|
||||
|
||||
- [`Local file path`](#local-file-path)
|
||||
- [`Remote URL`](#remote-url)
|
||||
- [`Standard input`](#standard-input)
|
||||
|
||||
#### Local file path
|
||||
|
||||
To specify a path to a local Dockerfile:
|
||||
|
||||
```console
|
||||
$ docker buildx build -f path/to/Dockerfile .
|
||||
```
|
||||
|
||||
#### Remote URL
|
||||
|
||||
To specify a URL to a remote Dockerfile:
|
||||
|
||||
```console
|
||||
$ docker buildx build -f https://raw.githubusercontent.com/docker/buildx/refs/tags/v0.29.0/Dockerfile .
|
||||
```
|
||||
|
||||
#### Standard input
|
||||
|
||||
To read a Dockerfile from stdin, use `-` as the argument:
|
||||
|
||||
```console
|
||||
$ cat Dockerfile | docker buildx build -f - .
|
||||
|
||||
Reference in New Issue
Block a user