Guest24897
/
DockerCLI
mirror of https://github.com/docker/cli.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Convert Unused ARG error to warning 

Signed-off-by: Addam Hardy <addam.hardy@gmail.com>
This commit is contained in:
Addam Hardy 2016-10-15 22:37:15 -05:00 committed by Tibor Vass
parent 49a282eb1c
commit 44edbbdbc2
2 changed files with 18 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/reference/builder.md
View File

@ -1286,12 +1286,12 @@ to create the directory in the Dockerfile. For example:
ARG <name>[=<default value>] ARG <name>[=<default value>]
The `ARG` instruction defines a variable that users can pass at build-time to The `ARG` instruction defines a variable that users can pass at build-time to
the builder with the `docker build` command using the the builder with the `docker build` command using the `--build-arg
`--build-arg <varname>=<value>` flag. If a user specifies a build argument <varname>=<value>` flag. If a user specifies a build argument that was not
that was not defined in the Dockerfile, the build outputs an error. defined in the Dockerfile, the build outputs a warning.
``` ```
One or more build-args were not consumed, failing build. [Warning] One or more build-args [foo] were not consumed.
``` ```
The Dockerfile author can define a single variable by specifying `ARG` once or many The Dockerfile author can define a single variable by specifying `ARG` once or many

27
man/Dockerfile.5.md
View File

@ -26,7 +26,7 @@ For example:
# DESCRIPTION # DESCRIPTION
A Dockerfile is a file that automates the steps of creating a Docker image. A Dockerfile is a file that automates the steps of creating a Docker image.
A Dockerfile is similar to a Makefile. A Dockerfile is similar to a Makefile.
# USAGE # USAGE
@ -71,10 +71,10 @@ A Dockerfile is similar to a Makefile.
multiple images. Make a note of the last image ID output by the commit before multiple images. Make a note of the last image ID output by the commit before
each new **FROM** command. each new **FROM** command.
-- If no tag is given to the **FROM** instruction, Docker applies the -- If no tag is given to the **FROM** instruction, Docker applies the
`latest` tag. If the used tag does not exist, an error is returned. `latest` tag. If the used tag does not exist, an error is returned.
-- If no digest is given to the **FROM** instruction, Docker applies the -- If no digest is given to the **FROM** instruction, Docker applies the
`latest` tag. If the used tag does not exist, an error is returned. `latest` tag. If the used tag does not exist, an error is returned.
**MAINTAINER** **MAINTAINER**
@ -148,7 +148,7 @@ A Dockerfile is similar to a Makefile.
``` ```
-- To make the container run the same executable every time, use **ENTRYPOINT** in -- To make the container run the same executable every time, use **ENTRYPOINT** in
combination with **CMD**. combination with **CMD**.
If the user specifies arguments to `docker run`, the specified commands If the user specifies arguments to `docker run`, the specified commands
override the default in **CMD**. override the default in **CMD**.
Do not confuse **RUN** with **CMD**. **RUN** runs a command and commits the result. Do not confuse **RUN** with **CMD**. **RUN** runs a command and commits the result.
@ -156,7 +156,7 @@ A Dockerfile is similar to a Makefile.
the image. the image.
**LABEL** **LABEL**
-- `LABEL <key>=<value> [<key>=<value> ...]`or -- `LABEL <key>=<value> [<key>=<value> ...]`or
``` ```
LABEL <key>[ <value>] LABEL <key>[ <value>]
LABEL <key>[ <value>] LABEL <key>[ <value>]
@ -176,8 +176,8 @@ A Dockerfile is similar to a Makefile.
``` ```
An image can have more than one label. To specify multiple labels, separate An image can have more than one label. To specify multiple labels, separate
each key-value pair by a space. each key-value pair by a space.
Labels are additive including `LABEL`s in `FROM` images. As the system Labels are additive including `LABEL`s in `FROM` images. As the system
encounters and then applies a new label, new `key`s override any previous encounters and then applies a new label, new `key`s override any previous
labels with identical keys. labels with identical keys.
@ -194,7 +194,7 @@ A Dockerfile is similar to a Makefile.
**ENV** **ENV**
-- `ENV <key> <value>` -- `ENV <key> <value>`
The **ENV** instruction sets the environment variable <key> to The **ENV** instruction sets the environment variable <key> to
the value `<value>`. This value is passed to all future the value `<value>`. This value is passed to all future
**RUN**, **ENTRYPOINT**, and **CMD** instructions. This is **RUN**, **ENTRYPOINT**, and **CMD** instructions. This is
functionally equivalent to prefixing the command with `<key>=<value>`. The functionally equivalent to prefixing the command with `<key>=<value>`. The
environment variables that are set with **ENV** persist when a container is run environment variables that are set with **ENV** persist when a container is run
@ -243,7 +243,7 @@ A Dockerfile is similar to a Makefile.
being built (the context of the build) or a remote file URL. The `<dest>` is an being built (the context of the build) or a remote file URL. The `<dest>` is an
absolute path, or a path relative to **WORKDIR**, into which the source will absolute path, or a path relative to **WORKDIR**, into which the source will
be copied inside the target container. If you **COPY** an archive file it will be copied inside the target container. If you **COPY** an archive file it will
land in the container exactly as it appears in the build context without any land in the container exactly as it appears in the build context without any
attempt to unpack it. All new files and directories are created with mode **0755** attempt to unpack it. All new files and directories are created with mode **0755**
and with the uid and gid of **0**. and with the uid and gid of **0**.
@ -326,10 +326,10 @@ A Dockerfile is similar to a Makefile.
The `ARG` instruction defines a variable that users can pass at build-time to The `ARG` instruction defines a variable that users can pass at build-time to
the builder with the `docker build` command using the `--build-arg the builder with the `docker build` command using the `--build-arg
<varname>=<value>` flag. If a user specifies a build argument that was not <varname>=<value>` flag. If a user specifies a build argument that was not
defined in the Dockerfile, the build outputs an error. defined in the Dockerfile, the build outputs a warning.
``` ```
One or more build-args were not consumed, failing build. [Warning] One or more build-args [foo] were not consumed
``` ```
The Dockerfile author can define a single variable by specifying `ARG` once or many The Dockerfile author can define a single variable by specifying `ARG` once or many
@ -454,7 +454,7 @@ A Dockerfile is similar to a Makefile.
you are defining an image to use as a base for building other images. For you are defining an image to use as a base for building other images. For
example, if you are defining an application build environment or a daemon that example, if you are defining an application build environment or a daemon that
is customized with a user-specific configuration. is customized with a user-specific configuration.
Consider an image intended as a reusable python application builder. It must Consider an image intended as a reusable python application builder. It must
add application source code to a particular directory, and might need a build add application source code to a particular directory, and might need a build
script called after that. You can't just call **ADD** and **RUN** now, because script called after that. You can't just call **ADD** and **RUN** now, because
@ -470,4 +470,5 @@ A Dockerfile is similar to a Makefile.
# HISTORY # HISTORY
*May 2014, Compiled by Zac Dover (zdover at redhat dot com) based on docker.com Dockerfile documentation. *May 2014, Compiled by Zac Dover (zdover at redhat dot com) based on docker.com Dockerfile documentation.
*Feb 2015, updated by Brian Goff (cpuguy83@gmail.com) for readability *Feb 2015, updated by Brian Goff (cpuguy83@gmail.com) for readability
*Sept 2015, updated by Sally O'Malley (somalley@redhat.com) *Sept 2015, updated by Sally O'Malley (somalley@redhat.com)
*Oct 2016, updated by Addam Hardy (addam.hardy@gmail.com)