Support for building Fuel behind a http proxy 17/2817/2
authorStefan K. Berg <stefan.k.berg@ericsson.com>
Mon, 19 Oct 2015 14:52:34 +0000 (16:52 +0200)
committerStefan Berg <stefan.k.berg@ericsson.com>
Tue, 27 Oct 2015 14:17:41 +0000 (14:17 +0000)
commit0f15359fa40d3ec89ee2ca26edece503e0205613
tree71c60720ba05d89ee87f5da4d1a419f9dd44a65d
parentc2a30637d07c9d6690ff24af9e76cab089135850
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>
(cherry picked from commit 0635291a88dd006e15224169524a7fc761ad47ab)
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