Support for building Fuel behind a http proxy 33/2633/15
authorStefan K. Berg <stefan.k.berg@ericsson.com>
Mon, 19 Oct 2015 14:52:34 +0000 (16:52 +0200)
committerStefan K. Berg <stefan.k.berg@ericsson.com>
Mon, 26 Oct 2015 15:24:10 +0000 (16:24 +0100)
commit0635291a88dd006e15224169524a7fc761ad47ab
tree05109743abecf67648fccd8ac3ce06029520828d
parenta890c03a1bf0ebdd19cf8c2dfdf3bc19a2391fc7
Support for building Fuel behind a http proxy

The build system is now able to work also behind a traditional web
proxy setup if the http_proxy, https_proxy and (if needed) no_proxy
environment variables has been set prior to invoking make.

This is a joint work by Gillian Dunne <gillian.dunne@intel.com> and
Stefan Berg <stefan.k.berg@ericsson.com>.

Verification so far has been with a mock setup, placing the build
machine behind a Squid proxy and blocking outgoing traffic not going
through the proxy by firewall rules. The following environment
variables was set in the host for these tests:

RSYNC_PROXY=10.0.0.1:8888
http_proxy=http://10.0.0.1:8888
https_proxy=http://10.0.0.1:8888
no_proxy=localhost,127.0.0.1,.consultron.com,.sock

*** IMPORTANT NOTE ABOUT THE HOST PROXY SETTINGS ***

The build system will make use the following proxy environment
variables:

http_proxy:
https_proxy
no_proxy
RSYNC_PROXY
RSYNC_CONNECT_PROG

During the build phase, a local Ubuntu package repository is fetched
from upstream in order to be added to the OPNFV Fuel ISO and for parts
of this process rsync is used.

This will require that either RSYNC_PROXY is set according to the
format "<proxy host>:<proxy port>" and that the proxy indicated indeed
allows rsync traffic *or* that RSYNC_CONNECT_PROG is set to use an
alternative transport. For a detailed explanation of these settings,
see the rsync manual page.

*** IMPORTANT NOTE ABOUT THE HOST DOCKER DAEMON SETTINGS ***

The Docker daemon on the host must be configured to use the http proxy
for it to be able to pull the base Ubuntu 14.04 image from the Docker
registry before invoking make! In Ubuntu this is done by adding a line
like:

export http_proxy="http://10.0.0.1:8888/"

to /etc/default/docker and restarting the Docker daemon.

Change-Id: Ieed2269af295d90a4b33d834f723889bdf9c7dc6
Signed-off-by: Stefan K. Berg <stefan.k.berg@ericsson.com>
fuel/build/Makefile
fuel/build/docker/Dockerfile [moved from fuel/build/docker/ubuntu-builder/Dockerfile with 71% similarity]
fuel/build/docker/Makefile
fuel/build/docker/runcontext
fuel/build/f_isoroot/f_odlpluginbuild/Makefile
fuel/build/f_isoroot/f_repobuild/Makefile
fuel/build/fuel-main_6.patch [new file with mode: 0644]
fuel/docs/src/build-instructions.rst