From 12f5496f88b150bf0ca64c1f3cf01ca115a98c10 Mon Sep 17 00:00:00 2001 From: Jonas Bjurel Date: Thu, 16 Apr 2015 21:23:57 +0200 Subject: Documentation templates for: LICENCE Installation Build Release-notes JIRA: Change-Id: Ia0ed1ef2042c2ee84ae0b9db78bd117e3ca8de6a Signed-off-by: Jonas Bjurel --- docs/templates/LICENSE.rst | 41 ++++++ docs/templates/build-instructions.rst | 198 +++++++++++++++++++++++++++ docs/templates/installation-instructions.rst | 4 +- docs/templates/release-notes.rst | 2 +- 4 files changed, 241 insertions(+), 4 deletions(-) create mode 100644 docs/templates/LICENSE.rst create mode 100644 docs/templates/build-instructions.rst (limited to 'docs/templates') diff --git a/docs/templates/LICENSE.rst b/docs/templates/LICENSE.rst new file mode 100644 index 000000000..774645389 --- /dev/null +++ b/docs/templates/LICENSE.rst @@ -0,0 +1,41 @@ +Copyright 2015 Open Platform for NFV Project, Inc. and its contributors + +Open Platform for NFV Project Software Licence +============================================== +Any software developed by the "Open Platform for NFV" Project is licenced under the +Apache License, Version 2.0 (the "License"); +you may not use the content of this software bundle except in compliance with the License. +You may obtain a copy of the License at + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + +Open Platform for NFV Project Documentation Licence +=================================================== +Any documentation developed by the "Open Platform for NFV Project" +is licensed under a Creative Commons Attribution 4.0 International License. +You should have received a copy of the license along with this. If not, +see . + +Unless required by applicable law or agreed to in writing, documentation +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. + +Other applicable upstream project Licenses relevant for +=================================================================== +You may not use the content of this software bundle except in compliance with the +Licenses as listed below: ++----------------+----------------------------+ +| **Component** | **Licence** | ++----------------+----------------------------+ +| OpenStack | Apache License 2.0 | ++----------------+----------------------------+ +| OpenDaylight | Eclipse Public License 1.0 | ++----------------+----------------------------+ +| ++ | | ++----------------+----------------------------+ diff --git a/docs/templates/build-instructions.rst b/docs/templates/build-instructions.rst new file mode 100644 index 000000000..3f348333c --- /dev/null +++ b/docs/templates/build-instructions.rst @@ -0,0 +1,198 @@ +:Authors: Jonas Bjurel (Ericsson) +:Version: 0.1 + +================================================================ +OPNFV Build instructions for - < Component denomination > +================================================================ + +Abstract +======== + +This document describes how to build , build system dependencies and required system resources. + +License +======= + (c) by + + is licensed under a Creative Commons Attribution 4.0 International License. You should have received a copy of the license along with this. If not, see . + + +**Contents** + +1 Version history + +2 Introduction + +3 Requirements + +4 Building + +5 Artifacts + + +1 Version history +=================== + ++--------------------+--------------------+--------------------+--------------------+ +| **Date** | **Ver.** | **Author** | **Comment** | +| | | | | ++--------------------+--------------------+--------------------+--------------------+ +| 2015-04-14 | 0.1.0 | Jonas Bjurel | First draft | +| | | | | ++--------------------+--------------------+--------------------+--------------------+ +| | 0.1.1 | | | +| | | | | ++--------------------+--------------------+--------------------+--------------------+ +| | 1.0 | | | +| | | | | +| | | | | ++--------------------+--------------------+--------------------+--------------------+ + +2 Introduction +================ + + +: + +This document describes build system used to build Fuel@OPNFV, required dependencies and minimum requirements on the host to be used for the buildsystem. + +The Fuel build system is desigened around Docker containers such that dependencies outside of the build system can be kept to a minimum. It also shields the host from any potential dangerous operations performed by the build system. + +The audience of this document is assumed to have good knowledge in network and Unix/Linux administration. + +3 Requirements +================ + + +3.1 Minimum Hardware Requirements +--------------------------------- +: + +- An x86_64 host (Bare-metal or VM) with Ubuntu 14.04 LTS installed + +- ~30 GB available disc + +- 4 GB RAM + +3.2 Minimum Software Requirements +--------------------------------- +: +The build host should run Ubuntu 14.04 operating system. + +On the host, the following packages must be installed: + +- docker - see https://docs.docker.com/installation/ubuntulinux/ for installation notes for Ubuntu 14.04. Note: only use the Ubuntu stock distro of Docker (docker.io) + +- git (simply available through sudo apt-get install git) + +- make (simply available through sudo apt-get install make) + +- curl (simply available through sudo apt-get install curl) + +3.3 Preparations +---------------- +: + +3.3.1 Setting up the Docker build container +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +After having installed Docker, add yourself to the docker group: + + + +Also make sure to define relevant DNS servers part of the global dns chain in +in your configuration file, eg. + + + +Then restart docker: + + + +3.3.2 Setting up OPNFV Gerrit in order to being able to clone the code +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +- Start setting up OPNFV gerrit by creating a SSH key (unless you don't already have one), create one with ssh-keygen + +- Add your generated public key in OPNFV Gerrit + (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. + +3.3.3 Clone the OPNFV code git repository +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Now it is time to clone the code repository: + + + +Now you should have the OPNFV genesis repository with Fuel@OPNFV stored locally on your build host. + +4 Building +============ + + +: + +There are two methods available for building Fuel@OPNFV: + +- A low level method using Make + +- An abstracted method using build.sh + +4.1 Configure your build environment +------------------------------------- + +Select the versions of the components you want to build by editing the fuel/build/config.mk file. +Note if you want to build with OpenDaylight SDN controller you need to uncomment the lines starting +with odl-main and java-main + +4.2 Low level build method using make +-------------------------------------- + +The low level method is based on Make: + +From the invoke + +Following targets exist: + +- none/all - this will: + + - If not allready existing, initialize the docker build environment + + - If not already done, build OpenDaylight from upstream (as defined by fuel-build config-spec) + + - If not already done, build fuel from upstream (as defined by fuel-build/config-spec) + + - Build the defined additions to fuel (as defined by the structure of this framework) + + - Apply changes and patches to fuel (as defined by the structure of this framework) + + - Reconstruct a fuel .iso image + +- clean - this will remove all artifacts from earlier builds. + +If the build is successful, you will find the generated ISO file in the subdirectory! + +4.3 Abstracted build method using build.sh +=========================================== +The abstracted build method useses the script which allows you to: + +- Create and use a build cache - significantly speeding up the buildtime if upstream repositories have not changed. + +- push/pull cache and artifacts to an arbitrary URI (http(s):, file:, ftp:) + +For more info type . + +5 Artifacts +============= + + +: + +The artifacts produced are: + +- - Which represents the bootable Fuel@OPNFV image, XXXX is replaced with the build identity provided to the build system + +- - Which holds version metadata. + +6 References +============= + diff --git a/docs/templates/installation-instructions.rst b/docs/templates/installation-instructions.rst index 166452df7..58972c1f1 100644 --- a/docs/templates/installation-instructions.rst +++ b/docs/templates/installation-instructions.rst @@ -19,7 +19,7 @@ License ======= (c) by - is licensed under a Creative Commons Attribution 4.0 Unported License. You should have received a copy of the license along with this. If not, see . + is licensed under a Creative Commons Attribution 4.0 International License. You should have received a copy of the license along with this. If not, see . **Contents** @@ -222,5 +222,3 @@ Change the Host OS password by...... 9.4 Fuel ------------ - - diff --git a/docs/templates/release-notes.rst b/docs/templates/release-notes.rst index 9104d37e3..1c08d092f 100644 --- a/docs/templates/release-notes.rst +++ b/docs/templates/release-notes.rst @@ -19,7 +19,7 @@ License ======= (c) by - is licensed under a Creative Commons Attribution 4.0 Unported License. You should have received a copy of the license along with this. If not, see . + is licensed under a Creative Commons Attribution 4.0 International License. You should have received a copy of the license along with this. If not, see . **Contents** -- cgit 1.2.3-korg