From 01fd095f0696dfef2e909ff28b710b062c30030a Mon Sep 17 00:00:00 2001 From: Denis Kasanic Date: Tue, 5 Nov 2019 09:50:00 +0100 Subject: Update build documentation Add note for using root shell Add example for populate local nexus Use absolute path in package.py script Remove Appendix Add clone oom with all submodules Fix example for pulling images in list Signed-off-by: Denis Kasanic Change-Id: I8859ba42420d351ce12347cd63bf11f95a4b528d Issue-ID: OOM-2158 Issue-ID: OOM-2160 --- docs/BuildGuide.rst | 54 +++++++++++++++-------------------------------------- 1 file changed, 15 insertions(+), 39 deletions(-) (limited to 'docs') diff --git a/docs/BuildGuide.rst b/docs/BuildGuide.rst index a654a4ce..27c0835e 100644 --- a/docs/BuildGuide.rst +++ b/docs/BuildGuide.rst @@ -20,6 +20,9 @@ following repos has to be configured for RHEL 7.6 platform. +.. note:: + All commands stated in this guide are meant to be run in root shell. + :: ############ @@ -92,7 +95,7 @@ Part 2. Download artifacts for offline installer :: # clone the OOM repository - git clone https://gerrit.onap.org/r/oom -b master /tmp/oom + git clone https://gerrit.onap.org/r/oom -b master --recurse-submodules /tmp/oom # enable subsystems in oom/kubernetes/onap/values.yaml as required @@ -127,12 +130,11 @@ so one might try following command to download most of the required artifacts in # following arguments are provided # all data lists are taken in ./build/data_lists/ folder # all resources will be stored in expected folder structure within ../resources folder - # for more details refer to Appendix 1. ./build/download/download.py --docker ./build/data_lists/infra_docker_images.list ../resources/offline_data/docker_images_infra \ - --docker ./build/data_lists/rke_docker_images.list ../resources/offline_data/docker_images_for_nexus \ - --docker ./build/data_lists/k8s_docker_images.list ../resources/offline_data/docker_images_for_nexus \ - --docker ./build/data_lists/onap_docker_images.list ../resources/offline_data/docker_images_for_nexus \ + --docker ./build/data_lists/rke_docker_images.list \ + --docker ./build/data_lists/k8s_docker_images.list \ + --docker ./build/data_lists/onap_docker_images.list \ --http ./build/data_lists/infra_bin_utils.list ../resources/downloads @@ -149,21 +151,18 @@ Prerequisites: - Following ports are not occupied buy another service: 80, 8081, 8082, 10001 - There's no docker container called "nexus" -.. note:: In case you skipped the Part 2 for the artifacts download, please ensure that the copy of resources data are untarred in *./onap-offline/../resources/* +.. note:: In case you skipped the Part 2 for the artifacts download, please ensure that the onap docker images are cached and copy of resources data are untarred in *./onap-offline/../resources/* + +:: + + #Whole nexus blob data will be created by running script build_nexus_blob.sh. + ./onap-offline/build/build_nexus_blob.sh -Whole nexus blob data will be created by running script build_nexus_blob.sh. It will load the listed docker images, run the Nexus, configure it as npm, pypi and docker repositories. Then it will push all listed docker images to the repositories. After all is done the repository container is stopped. .. note:: In the current release scope we aim to maintain just single example data lists set, tags used in previous releases are not needed. Datalists are also covering latest versions verified by us despite user is allowed to build data lists on his own. -Once the Nexus data blob is created, the docker images can be deleted to reduce the package size as they won't be needed in the installation time: - -E.g. - -:: - - rm -f /tmp/resources/offline_data/docker_images_for_nexus/* Part 4. Packages preparation -------------------------------------------------------- @@ -186,13 +185,13 @@ From onap-offline directory run: :: - ./build/package.py --application-repository_reference --output-dir --resources-directory + ./build/package.py --build_version "" --application-repository_reference --output-dir --resources-directory For example: :: - ./build/package.py https://gerrit.onap.org/r/oom --application-repository_reference master --output-dir ../packages --resources-directory ../resources + ./build/package.py https://gerrit.onap.org/r/oom --build_version "" --application-repository_reference master --output-dir /tmp/packages --resources-directory /tmp/resources In the target directory you should find tar files: @@ -203,26 +202,3 @@ In the target directory you should find tar files: resources_package.tar aux_package.tar - -Appendix 1. Step-by-step download procedure -------------------------------------------- - -**Step 1 - docker images** - -:: - - # This step will parse all 3 docker datalists (offline infrastructure images, rke k8s images & onap images) - # and start building onap offline platform in /tmp/resources folder - - ./build/download/download.py --docker ./build/data_lists/infra_docker_images.list ../resources/offline_data/docker_images_infra \ - --docker ./build/data_lists/rke_docker_images.list ../resources/offline_data/docker_images_for_nexus \ - --docker ./build/data_lists/k8s_docker_images.list ../resources/offline_data/docker_images_for_nexus \ - --docker ./build/data_lists/onap_docker_images.list ../resources/offline_data/docker_images_for_nexus - - -**Step 2 - binaries** - -:: - - # Following step will download rke, kubectl and helm binaries - ./build/download/download.py --http ./build/data_lists/infra_bin_utils.sh ../resources/downloads -- cgit 1.2.3-korg