mirror of https://github.com/docker/cli.git
docs: fix links, and minor markdown touch-ups
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
This commit is contained in:
parent
904e4f4db9
commit
116c9a1f59
|
@ -54,6 +54,7 @@ Dockerfile.
|
||||||
>
|
>
|
||||||
> Do not use your root directory, `/`, as the `PATH` as it causes the build to
|
> Do not use your root directory, `/`, as the `PATH` as it causes the build to
|
||||||
> transfer the entire contents of your hard drive to the Docker daemon.
|
> transfer the entire contents of your hard drive to the Docker daemon.
|
||||||
|
{:.warning}
|
||||||
|
|
||||||
To use a file in the build context, the `Dockerfile` refers to the file specified
|
To use a file in the build context, the `Dockerfile` refers to the file specified
|
||||||
in an instruction, for example, a `COPY` instruction. To increase the build's
|
in an instruction, for example, a `COPY` instruction. To increase the build's
|
||||||
|
@ -175,9 +176,9 @@ Docker runs instructions in a `Dockerfile` in order. A `Dockerfile` **must
|
||||||
begin with a \`FROM\` instruction**. This may be after [parser
|
begin with a \`FROM\` instruction**. This may be after [parser
|
||||||
directives](#parser-directives), [comments](#format), and globally scoped
|
directives](#parser-directives), [comments](#format), and globally scoped
|
||||||
[ARGs](#arg). The `FROM` instruction specifies the [*Parent
|
[ARGs](#arg). The `FROM` instruction specifies the [*Parent
|
||||||
Image*](glossary.md#parent-image) from which you are building. `FROM`
|
Image*](https://docs.docker.com/glossary/#parent_image) from which you are
|
||||||
may only be preceded by one or more `ARG` instructions, which declare arguments
|
building. `FROM` may only be preceded by one or more `ARG` instructions, which
|
||||||
that are used in `FROM` lines in the `Dockerfile`.
|
declare arguments that are used in `FROM` lines in the `Dockerfile`.
|
||||||
|
|
||||||
Docker treats lines that *begin* with `#` as a comment, unless the line is
|
Docker treats lines that *begin* with `#` as a comment, unless the line is
|
||||||
a valid [parser directive](#parser-directives). A `#` marker anywhere
|
a valid [parser directive](#parser-directives). A `#` marker anywhere
|
||||||
|
@ -1758,6 +1759,7 @@ ARG buildno
|
||||||
>
|
>
|
||||||
> Refer to the ["build images with BuildKit"](https://docs.docker.com/develop/develop-images/build_enhancements/#new-docker-build-secret-information)
|
> Refer to the ["build images with BuildKit"](https://docs.docker.com/develop/develop-images/build_enhancements/#new-docker-build-secret-information)
|
||||||
> section to learn about secure ways to use secrets when building images.
|
> section to learn about secure ways to use secrets when building images.
|
||||||
|
{:.warning}
|
||||||
|
|
||||||
### Default values
|
### Default values
|
||||||
|
|
||||||
|
@ -2277,7 +2279,8 @@ This feature is only available when using the [BuildKit](#buildkit) backend.
|
||||||
|
|
||||||
Docker build supports experimental features like cache mounts, build secrets and
|
Docker build supports experimental features like cache mounts, build secrets and
|
||||||
ssh forwarding that are enabled by using an external implementation of the
|
ssh forwarding that are enabled by using an external implementation of the
|
||||||
builder with a syntax directive. To learn about these features, [refer to the documentation in BuildKit repository](https://github.com/moby/buildkit/blob/master/frontend/dockerfile/docs/experimental.md).
|
builder with a syntax directive. To learn about these features,
|
||||||
|
[refer to the documentation in BuildKit repository](https://github.com/moby/buildkit/blob/master/frontend/dockerfile/docs/experimental.md).
|
||||||
|
|
||||||
## Dockerfile examples
|
## Dockerfile examples
|
||||||
|
|
||||||
|
|
|
@ -29,7 +29,7 @@ The basic `docker run` command takes this form:
|
||||||
|
|
||||||
$ docker run [OPTIONS] IMAGE[:TAG|@DIGEST] [COMMAND] [ARG...]
|
$ docker run [OPTIONS] IMAGE[:TAG|@DIGEST] [COMMAND] [ARG...]
|
||||||
|
|
||||||
The `docker run` command must specify an [*IMAGE*](glossary.md#image)
|
The `docker run` command must specify an [*IMAGE*](https://docs.docker.com/glossary/#image)
|
||||||
to derive the container from. An image developer can define image
|
to derive the container from. An image developer can define image
|
||||||
defaults related to:
|
defaults related to:
|
||||||
|
|
||||||
|
@ -45,8 +45,8 @@ operator's ability to override image and Docker runtime defaults is why
|
||||||
[*run*](commandline/run.md) has more options than any
|
[*run*](commandline/run.md) has more options than any
|
||||||
other `docker` command.
|
other `docker` command.
|
||||||
|
|
||||||
To learn how to interpret the types of `[OPTIONS]`, see [*Option
|
To learn how to interpret the types of `[OPTIONS]`, see
|
||||||
types*](commandline/cli.md#option-types).
|
[*Option types*](commandline/cli.md#option-types).
|
||||||
|
|
||||||
> **Note**
|
> **Note**
|
||||||
>
|
>
|
||||||
|
|
Loading…
Reference in New Issue