Build Guide Latest: Tools Repository Name
OpenDev is community-run tools and infrastructure services for collaboratively developing open source software [0]. A new structure has been assigned including the new named "tools" repository which hosts the scripts to build an StarlingX ISO image. [0] http://lists.starlingx.io/pipermail/starlingx-discuss/2018-November/001821.html Change-Id: Ie326347d3f4a0016d1093fc05a2eba61f02a052e Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
This commit is contained in:
Abraham Arce
parent
ade04de812
commit
02fa311224
@ -9,8 +9,6 @@ the "latest" StarlingX software (i.e. the "under development" branch).
|
||||
Requirements
|
||||
------------
|
||||
|
||||
The recommended minimum requirements include:
|
||||
|
||||
*********************
|
||||
Hardware requirements
|
||||
*********************
|
||||
@ -151,23 +149,23 @@ Create a workspace directory
|
||||
|
||||
$ mkdir -p $HOME/starlingx/
|
||||
|
||||
*************************
|
||||
Install stx-tools project
|
||||
*************************
|
||||
*********************
|
||||
Install tools project
|
||||
*********************
|
||||
|
||||
#. Under your $HOME directory, clone the <stx-tools> project:
|
||||
#. Under your $HOME directory, clone the <tools> project:
|
||||
|
||||
.. code:: sh
|
||||
|
||||
$ cd $HOME
|
||||
$ git clone https://git.starlingx.io/stx-tools
|
||||
$ git clone https://opendev.org/starlingx/tools.git
|
||||
|
||||
#. Navigate to the *<$HOME/stx-tools>* project
|
||||
#. Navigate to the *<$HOME/tools>* project
|
||||
directory:
|
||||
|
||||
.. code:: sh
|
||||
|
||||
$ cd $HOME/stx-tools/
|
||||
$ cd $HOME/tools/
|
||||
|
||||
-----------------------------
|
||||
Prepare the base Docker image
|
||||
@ -221,7 +219,7 @@ to build the base Docker image.
|
||||
ENV ftp_proxy " http://your.actual_ftp_proxy.com:your_port "
|
||||
RUN echo " proxy=http://your-proxy.com:port " >> /etc/yum.conf
|
||||
|
||||
#. The ``tb.sh`` script automates the Base Docker image build:
|
||||
#. The ``tb.sh`` script automates the base Docker image build:
|
||||
|
||||
.. code:: sh
|
||||
|
||||
@ -231,8 +229,8 @@ to build the base Docker image.
|
||||
Build the CentOS mirror repository
|
||||
----------------------------------
|
||||
|
||||
The creation of the StarlingX ISO relies on a repository of RPM Binaries,
|
||||
RPM Sources, and Tar Compressed files. This section describes how to build
|
||||
The creation of the StarlingX ISO relies on a repository of RPM binaries,
|
||||
RPM sources, and tar compressed files. This section describes how to build
|
||||
this CentOS mirror repository.
|
||||
|
||||
*******************************
|
||||
@ -241,12 +239,12 @@ Run repository Docker container
|
||||
|
||||
| Run the following commands under a terminal identified as "**One**":
|
||||
|
||||
#. Navigate to the *$HOME/stx-tools/centos-mirror-tool* project
|
||||
#. Navigate to the *$HOME/tools/centos-mirror-tool* project
|
||||
directory:
|
||||
|
||||
.. code:: sh
|
||||
|
||||
$ cd $HOME/stx-tools/centos-mirror-tools/
|
||||
$ cd $HOME/tools/centos-mirror-tools/
|
||||
|
||||
#. Launch the Docker container using the previously created base Docker image
|
||||
*<repository>:<tag>*. As /localdisk is defined as the workdir of the
|
||||
@ -292,7 +290,7 @@ Verify packages
|
||||
::
|
||||
|
||||
# cat logs/*_missing_*.log
|
||||
# cat logs/*_failmove_*.log
|
||||
# cat logs/*_failmoved_*.log
|
||||
|
||||
#. In case missing or failed packages do exist, which is usually caused by
|
||||
network instability (or timeout), you need to download the packages
|
||||
@ -309,7 +307,7 @@ from downloading the packages:
|
||||
|
||||
::
|
||||
|
||||
/home/<user>/stx-tools/centos-mirror-tools/output
|
||||
/home/<user>/tools/centos-mirror-tools/output
|
||||
└── stx-r1
|
||||
└── CentOS
|
||||
└── pike
|
||||
@ -339,13 +337,13 @@ as "**Two**", run the following commands:
|
||||
|
||||
$ mkdir -p $HOME/starlingx/mirror/CentOS/
|
||||
|
||||
#. Copy the built CentOS Mirror Repository built under
|
||||
*$HOME/stx-tools/centos-mirror-tool* to the *$HOME/starlingx/mirror/*
|
||||
#. Copy the built CentOS mirror repository built under
|
||||
*$HOME/tools/centos-mirror-tool* to the *$HOME/starlingx/mirror/*
|
||||
workspace directory:
|
||||
|
||||
.. code:: sh
|
||||
|
||||
$ cp -r $HOME/stx-tools/centos-mirror-tools/output/stx-r1/ $HOME/starlingx/mirror/CentOS/
|
||||
$ cp -r $HOME/tools/centos-mirror-tools/output/stx-r1/ $HOME/starlingx/mirror/CentOS/
|
||||
|
||||
|
||||
-------------------------
|
||||
@ -362,11 +360,11 @@ Run building Docker container
|
||||
|
||||
$ mkdir -p $HOME/starlingx/workspace
|
||||
|
||||
#. Navigate to the *$HOME/stx-tools* project directory:
|
||||
#. Navigate to the *$HOME/tools* project directory:
|
||||
|
||||
.. code:: sh
|
||||
|
||||
$ cd $HOME/stx-tools
|
||||
$ cd $HOME/tools
|
||||
|
||||
#. Verify environment variables:
|
||||
|
||||
@ -391,20 +389,20 @@ Download source code repositories
|
||||
*********************************
|
||||
|
||||
#. From the terminal identified as "**Two**", which is now inside the
|
||||
Building Docker container, start the internal environment:
|
||||
building Docker container, start the internal environment:
|
||||
|
||||
.. code:: sh
|
||||
|
||||
$ eval $(ssh-agent)
|
||||
$ ssh-add
|
||||
|
||||
#. Use the repo tool to create a local clone of the stx-manifest
|
||||
#. Use the repo tool to create a local clone of the manifest
|
||||
Git repository based on the "master" branch:
|
||||
|
||||
.. code:: sh
|
||||
|
||||
$ cd $MY_REPO_ROOT_DIR
|
||||
$ repo init -u https://git.starlingx.io/stx-manifest -m default.xml
|
||||
$ repo init -u https://opendev.org/starlingx/manifest -m default.xml
|
||||
|
||||
#. Synchronize the repository:
|
||||
|
||||
@ -440,7 +438,8 @@ Download source code repositories
|
||||
Build packages
|
||||
**************
|
||||
|
||||
#. Go back to the terminal identified as "**Two**", which is the Building Docker container.
|
||||
#. Go back to the terminal identified as "**Two**", which is the building
|
||||
Docker container.
|
||||
|
||||
#. **Temporal!** Build-Pkgs Errors. Be prepared to have some missing /
|
||||
corrupted rpm and tarball packages generated during
|
||||
@ -586,7 +585,7 @@ Limitations
|
||||
Method (in brief)
|
||||
*****************
|
||||
|
||||
#. Reference Builds
|
||||
#. Reference builds
|
||||
|
||||
- A server in the regional office performs regular (e.g. daily)
|
||||
automated builds using existing methods. These builds are called
|
||||
@ -746,8 +745,8 @@ the last full build. Your build script might look like this ...
|
||||
# update software
|
||||
repo init -u ${BUILD_REPO_URL} -b ${BUILD_BRANCH}
|
||||
repo sync --force-sync
|
||||
$MY_REPO_ROOT_DIR/stx-tools/toCOPY/generate-cgcs-centos-repo.sh
|
||||
$MY_REPO_ROOT_DIR/stx-tools/toCOPY/populate_downloads.sh
|
||||
$MY_REPO_ROOT_DIR/tools/toCOPY/generate-cgcs-centos-repo.sh
|
||||
$MY_REPO_ROOT_DIR/tools/toCOPY/populate_downloads.sh
|
||||
|
||||
# User can optionally define BUILD_METHOD equal to one of 'FULL', 'AVOIDANCE', or 'AUTO'
|
||||
# Sanitize BUILD_METHOD
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user