From d29df40fd66d6a90fde858e8a0bc0d0e98a01794 Mon Sep 17 00:00:00 2001 From: Jonas Bjurel Date: Fri, 30 Jan 2015 22:22:43 +0100 Subject: Version 0.0.1 of /fuel-bild This is a build system that rebases the result from fuel.org such that you can add or change packages/puppet manifests any way you like, and reliably produce a installable which can be reproduced any time. See README for more information. Signed-off-by: Jonas Bjurel --- fuel-build/DOC/BUILD/README.build | 85 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 fuel-build/DOC/BUILD/README.build (limited to 'fuel-build/DOC/BUILD/README.build') diff --git a/fuel-build/DOC/BUILD/README.build b/fuel-build/DOC/BUILD/README.build new file mode 100644 index 0000000..6cd87e7 --- /dev/null +++ b/fuel-build/DOC/BUILD/README.build @@ -0,0 +1,85 @@ +############################################################################## +# Copyright (c) 2015 Ericsson AB and others. +# stefan.k.berg@ericsson.com +# jonas.bjurel@ericsson.com +# All rights reserved. This program and the accompanying materials +# are made available under the terms of the Apache License, Version 2.0 +# which accompanies this distribution, and is available at +# http://www.apache.org/licenses/LICENSE-2.0 +############################################################################## + +How to setup and use the OPNFV/BGS/FUEL build system - work in progress + +1. Build system requirements +---------------------------- +1.1 Host HW/VM requirements +--------------------------- +- A x86_64 host (real iron or VM) with Ubuntu 12.04/14.04 LTS installed +- 100 GB storage +- 8 GB RAM + +1.2 Host SW dependencies +------------------------ +On the host, the following packages must be installed: +- debootstrap (simply available through apt-get install debootstrap) +- docker - see https://docs.docker.com/installation/ubuntulinux/ for installation notes for 12.04 and 14.04 +- git (simply available through apt-get install git) + +2 Setting up the Docker build container +---------------------------------------- +When having installed Docker, add yourself to the docker group: +usermod -a -G docker + +Also make sure to define rellevant dns servers part of the global dns chain in +in your /etc/default/docker config file, eg. +DOCKER_OPTS=" --dns=8.8.8.8 --dns=8.8.8.4" + +Then restart docker with "service docker restart".: + +3. Setting up OPNFV Gerrit in order to being able to clone the code +------------------------------------------------------------------- +- Start by creating a SSH key, if you don't already have one, create one with ssh-keygen + +- Add your generated public key in OPNFV Gerrit -https://gerrit.opnfv.org/ + (this requires a linuxfoundation account, create one if you do not already have one) + +- Select "SSH Public Keys" to the left and then "Add Key" and paste your public key in. + +4. Clone the OPNFV code git repository +-------------------------------------- + So now we're coming to the fun part! Let's clone the code repository: + git clone ssh://@gerrit.opnfv.org:29418/genesis + + Change the directory to "fuel-build" + cd fuel-build/ + +5. Set up (build) your build environment +---------------------------------------- +YOU DO NOT NEED TO SET UP YOUR BUILD ENVIRONMENT, THE TOP MAKE ALL TARGET WILL DO THAT FOR YOU IF NOT ALREADY DONE, +THE BELOW ACTIONS IN THIS SECTION ARE NOT NEEDED! + +Note and TODO: +The build system will for now partly run as sudo as that is needed for the debootstrap procedure to create the root file +system for the Ubuntu 12.04 Docker image - BUT NOTE, NONE OF THE MAKEFILES OR SCRIPTS SHALL BE EXECUTED WITH SUDO/ROOT PRIVILEDGES! +(TODO: Change the scripts so that no root priviledges will be needed) + +With your ordinary user-, run the following commands from your git root: +cd docker +make (and you will be prompted for your password by sudo) +cd .. + +6. Build your fuel .iso image +----------------------------- +That's it, time to build! +make [all] + +This will: +- If not allready existing, initialize the docker build environment +- If not already done, build fuel from upstream +- Build the defined derivate of fuel (as defined by the structure of this framework) + +If the build is successful, you will find the generated ISO file in the release subdirectory! + +7. Install your stack +--------------------- +Please see DOC/INSTALL/README -- cgit 1.2.3-korg