Update CI docs to reflect deletion of install and check
Change-Id: I368e622b0e913a9f7cc3dc0066a12fdaf28f4eb9
This commit is contained in:
parent
6447f0c474
commit
26c7d1d0ed
@ -4,15 +4,11 @@ Table of Contents
|
|||||||
- `CI Structure <#ci-structure>`__
|
- `CI Structure <#ci-structure>`__
|
||||||
- `Script Documentation <#script-documentation>`__
|
- `Script Documentation <#script-documentation>`__
|
||||||
|
|
||||||
- `Install and Check <#install-and-check>`__
|
|
||||||
- `Invoking Locally <#invoking-locally>`__
|
|
||||||
- `Browbeat as a Quickstart Extra <#browbeat-as-a-quickstart-extra>`__
|
- `Browbeat as a Quickstart Extra <#browbeat-as-a-quickstart-extra>`__
|
||||||
- `Invoking Locally <#invoking-locally>`__
|
- `Invoking Locally <#invoking-locally>`__
|
||||||
|
|
||||||
CI Structure
|
CI Structure
|
||||||
============
|
============
|
||||||
For an example Jenkins configuration see `this job
|
|
||||||
<https://ci.centos.org/view/rdo/view/POC/job/poc-browbeat-tripleo-quickstart-mitaka-delorean-full-deploy-minimal/>`_
|
|
||||||
|
|
||||||
If you would like to make your own CI job add your CI script to this directory
|
If you would like to make your own CI job add your CI script to this directory
|
||||||
and invoke it as minimally as possible on the Jenkins end, this will help us
|
and invoke it as minimally as possible on the Jenkins end, this will help us
|
||||||
@ -21,88 +17,6 @@ keep script changes in the repository and better test them before merging.
|
|||||||
Script Documentation
|
Script Documentation
|
||||||
====================
|
====================
|
||||||
|
|
||||||
Install and Check
|
|
||||||
-----------------
|
|
||||||
Currently the main CI script that is run against every commit submitted to the
|
|
||||||
Openstack Gerrit. For each test a fresh Openstack instance is deployed using
|
|
||||||
`TripleO Quickstart <https:github.com/openstack/tripleo-quickstart>`_, Browbeat
|
|
||||||
is then installed. Both of these happen regardless of what was included in the
|
|
||||||
commit. Workload tests are run only if a file diff between the commit and
|
|
||||||
Browbeat master contains the workload name. Success is defined as all processes
|
|
||||||
in the script exiting with exit code 0, note Browbeat will return zero if a
|
|
||||||
test fails its SLA or otherwise fails in a manner that's not total.
|
|
||||||
|
|
||||||
To add an additional workload to the script add the workload name to the tools
|
|
||||||
loop near the bottom of the file.
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
for tool in rally perfkit shaker <tool name>; do
|
|
||||||
|
|
||||||
|
|
||||||
Then add configuration details that run all functions of the added task or
|
|
||||||
plugin to the ``browbeat-ci.yaml`` file in ``ci-scripts/config``.
|
|
||||||
|
|
||||||
You can view the output of this job `here
|
|
||||||
<https://ci.centos.org/view/rdo/view/POC/job/poc-browbeat-tripleo-quickstart-mitaka-delorean-full-deploy-minimal/>`_
|
|
||||||
|
|
||||||
Invoking Locally
|
|
||||||
~~~~~~~~~~~~~~~~
|
|
||||||
|
|
||||||
To run ``tripleo/install-and-check.sh`` using your local machine as the driver
|
|
||||||
for a TripleO Quickstart / Browbeat deployment create an empty directory to use
|
|
||||||
as your workspace and point virthost at a machine running CentOS 7+ or RHEL 7+
|
|
||||||
with at least 32GB of RAM.
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
$ export WORKSPACE=<your empty directory>
|
|
||||||
$ export VIRTHOST=<deployment machine hostname>
|
|
||||||
|
|
||||||
Navigate to the workspace directory
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
$ cd $WORKSPACE
|
|
||||||
|
|
||||||
Clone the required repositories
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
$ git clone https://github.com/openstack/browbeat
|
|
||||||
$ git clone https://github.com/openstack/tripleo-quickstart/
|
|
||||||
$ git clone https://github.com/redhat-openstack/ansible-role-tripleo-inventory
|
|
||||||
|
|
||||||
Install the Ansible roles from Github into the virtual environment, as well as
|
|
||||||
a few Python packages
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
$ virtualenv --no-site-packages $WORKSPACE
|
|
||||||
$ source $WORKSPACE/bin/activate
|
|
||||||
$ cd $WORKSPACE/ansible-role-tripleo-inventory/
|
|
||||||
$ python setup.py install
|
|
||||||
$ cd $WORKSPACE/tripleo-quickstart
|
|
||||||
$ python setup.py install
|
|
||||||
$ pip install --upgrade ansible netaddr
|
|
||||||
|
|
||||||
Install the package dependencies, if you're nervous about using root just look
|
|
||||||
inside of ``quickstart.sh``, these are very generic and you might already have
|
|
||||||
all of them installed.
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
$ sudo bash $WORKSPACE/tripleo-quickstart/quickstart.sh --install-deps
|
|
||||||
|
|
||||||
Finally invoke the script and settle in, as this command will take about two
|
|
||||||
hours to complete and will place all the relevant ssh credentials and other
|
|
||||||
information to access your instance once the run is complete in the workspace
|
|
||||||
directory.
|
|
||||||
|
|
||||||
::
|
|
||||||
|
|
||||||
$ bash $WORKSPACE/browbeat/ci-scripts/tripleo/install-and-check.sh mitaka delorean minimal periodic
|
|
||||||
|
|
||||||
Browbeat as a Quickstart Extra
|
Browbeat as a Quickstart Extra
|
||||||
------------------------------
|
------------------------------
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user