How to reproduce a job result using the reproducer-quickstart.sh script

Check the top-level logs directory for a file reproducer-quickstart.sh. Running this file will set up a stack on a personal tenant where the job run can be reproduced. If no reproducer-quickstart.sh file is found, that usually means an infra failure before Quickstart could start or a problem in collecting logs. Check on IRC Freenode channel #tripleo to see if there's an ongoing infra issue.

What is the reproducer-quickstart.sh script?

A reproducer-quickstart.sh script is generated at the top-level log directory for jobs that run TripleO-Quickstart and toci_gate_test-oooq.sh. Running the script from a host machine will set up a stack to the point where the user can ssh to the undercloud, source a variable file, and run toci_gate_test-oooq.sh. As such, reproducing the complete jobs result requires some manual interaction.

The reproducer-quickstart.sh script is generated to be specific to that job and reproducer-quickstart.sh scripts from other jobs will be different.

Running the reproducer-quickstart.sh script

Use cURL, wget or a similar tool to copy the reproducer-quickstart.sh to a clean working directory on a host from where you can access the cloud tenant you want to run the reproducer on. Make sure that the copied script is executable (has +x permissions) before you attempt to run it. Source the tenant credentials before running the script. Also, it is a good idea to check that the tenant has enough capacity and resources to reproduce the job before you begin.

Note that, by default, the reproducer-quickstart.sh script is written to run an a personal RDO Cloud tenant. Instructions on how to modify the script to run on another host cloud are included in a section below.

When the script completes, you will see a list of instructions printed out on how to run toci_gate_test-oooq.sh from the undercloud:

• ssh to the undercloud: $ ssh zuul@$ansible_host
• Source the environment settings file: $ source /home/zuul/env_vars_to_src.sh
• Run the toci gate script: $ /opt/stack/tripleo-ci/toci_gate_test-oooq.sh

Input argument options in the reproducer-quickstart.sh script

Running reproducer-quickstart.sh --help will show a list of the input options. All the options have a default and none are required. The options are listed below with explanations:

• -w, --workspace: directory where the virtualenv, inventory files, etc. Defaults to creating a directory in /tmp
• -v, --create-virtualenv: create a virtualenv to install Ansible and dependencies. Defaults to true.
• -r, --remove-stacks-keypairs: delete all stacks in the tenant before deployment. will also delete associated keypairs if they exist. Defaults to false.
• -p, --nodestack-prefix: add a unique prefix for multinode and singlenode stacks Defaults to empty.

Using an alternative host cloud

The reproducer-quickstart.sh script is written to run an a personal RDO Cloud tenant. If you want to run on a different host cloud, modify the reproducer-quickstart.sh as follows:

• Add git clone of tripleo-environments or any other repository containing the cloud details, after cloning tripleo-quickstart-extras
• Add the repository to quickstart-extras-requirements.txt: echo "file://$WORKSPACE/tripleo-environments/#egg=tripleo-environments" >> $WORKSPACE/tripleo-quickstart/quickstart-extras-requirements.txt
• Use that host cloud's environment file in place of RDO Cloud's environment file.