![]() - The build-time variables are passed as environment-context for command(s) run as part of the RUN primitve. These variables are not persisted in environment of intermediate and final images when passed as context for RUN. The build environment is prepended to the intermediate continer's command string for aiding cache lookups. It also helps with build traceability. But this also makes the feature less secure from point of view of passing build time secrets. - The build-time variables also get used to expand the symbols used in certain Dockerfile primitves like ADD, COPY, USER etc, without an explicit prior definiton using a ENV primitive. These variables get persisted in the intermediate and final images whenever they are expanded. - The build-time variables are only expanded or passed to the RUN primtive if they are defined in Dockerfile using the ARG primitive or belong to list of built-in variables. HTTP_PROXY, HTTPS_PROXY, http_proxy, https_proxy, FTP_PROXY and NO_PROXY are built-in variables that needn't be explicitly defined in Dockerfile to use this feature. Signed-off-by: Madhav Puri <madhav.puri@gmail.com> |
||
---|---|---|
.. | ||
_static | ||
images | ||
docker-io_api.md | ||
docker_io_accounts_api.md | ||
docker_remote_api.md | ||
docker_remote_api_v1.0.md | ||
docker_remote_api_v1.1.md | ||
docker_remote_api_v1.2.md | ||
docker_remote_api_v1.3.md | ||
docker_remote_api_v1.4.md | ||
docker_remote_api_v1.5.md | ||
docker_remote_api_v1.6.md | ||
docker_remote_api_v1.7.md | ||
docker_remote_api_v1.8.md | ||
docker_remote_api_v1.9.md | ||
docker_remote_api_v1.10.md | ||
docker_remote_api_v1.11.md | ||
docker_remote_api_v1.12.md | ||
docker_remote_api_v1.13.md | ||
docker_remote_api_v1.14.md | ||
docker_remote_api_v1.15.md | ||
docker_remote_api_v1.16.md | ||
docker_remote_api_v1.17.md | ||
docker_remote_api_v1.18.md | ||
docker_remote_api_v1.19.md | ||
docker_remote_api_v1.20.md | ||
docker_remote_api_v1.21.md | ||
hub_registry_spec.md | ||
README.md | ||
registry_api.md | ||
registry_api_client_libraries.md | ||
remote_api_client_libraries.md |
This directory holds the authoritative specifications of APIs defined and implemented by Docker. Currently this includes:
- The remote API by which a docker node can be queried over HTTP
- The registry API by which a docker node can download and upload images for storage and sharing
- The index search API by which a docker node can search the public index for images to download
- The docker.io OAuth and accounts API which 3rd party services can use to access account information