openstack/kolla-ansible
Code Issues Proposed changes

Add documentation around how to build behind a proxy

Browse Source 
Change-Id: Ie0e69f72a9f4c4c1eee897d2b48b4318c3b94638
This commit is contained in:
Paul Bourke 2015-10-20 15:09:38 +01:00
parent 7b73bc95ac
commit 61f9f407c4
1 changed files with 36 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
doc/image-building.rst
View File

@ -190,4 +190,40 @@ images from insecure registry. See
`Docker Insecure Registry Config`_.
Building behind a proxy
+++++++++++++++++++++++
The build script supports augmenting the Dockerfiles under build via so called
`header` and `footer` files. Statements in the `header` file are included at
the top of the `base` image, while those in `footer` are included at the bottom
of every Dockerfile in the build.
A common use case for this is to insert http_proxy settings into the images to
fetch packages during build, and then unset them at the end to avoid having
them carry through to the environment of the final images. Note however, it's
not possible to drop the info completely using this method; it will still be
visible in the layers of the image.
To use this feature, create a file called ``.header``, with the following
content for example:
::
ENV http_proxy=https://evil.corp.proxy:80
ENV https_proxy=https://evil.corp.proxy:80
Then create another file called ``.footer``, with the following content:
::
ENV http_proxy=""
ENV https_proxy=""
Finally, pass them to the build script using the ``-i`` and ``-I`` flags:
::
tools/build.py -i .header -I .footer
.. _DockerBug: https://github.com/docker/docker/issues/6980