OpenStack CI Loop for Xen-Libvirt
CI Loop
This article provides some information about jenkins.openstack.xenproject.org, which is the front-end for the Xen Project OpenStack CI loop, which is a 3rd party OpenStack CI loop (3rd party because it is operated by the Xen Project, not the OpenStack Foundation). You can find more information about 3rd party OpenStack testing systems in the following articles
- Setting Up an External OpenStack Testing System – Part 1
- Setting Up an External OpenStack Testing System – Part 2
- The Test Suite we run (OpenStack Tempest)
- Tempest Overview
- Xen Project now in OpenStack Nova Hypervisor Driver Quality Group B
Baseline
Our baseline for testing is ...
Ubuntu xen package 4.4.1-0ubuntu0.14.04.6 (Xen 4.4.1), with the following 5 patches applied
- 9369988 libxl: event handling: Break out ao_work_outstanding
- f1335f0 libxl: event handling: ao_inprogress does waits while reports outstanding
- 4783c99 libxl: In domain death search, start search at first domid we want
- 188e9c5 libxl: Domain destroy: fork
- 9acfbe1 libxl: Increase device model startup timeout to 1min.
We are using the Ubuntu libvirt package 1.2.2 libvirt_1.2.2-0ubuntu13.1.7 as baseline, updated it to the most recent libvirt release, version 1.2.14, with the 3 missing libvirt patches from Jim Fehlig in the series outlined in this mail:
- f86ae40 libxl: Move job acquisition in libxlDomainStart to callers
- 894d2ff libxl: acquire a job when destroying a domain
- 6dfec1e libxl: drop virDomainObj lock when destroying a domain
Note that all the necessary Xen changes are in Xen 4.5.1 and libvirt 1.2.15.
Usage Instructions
Our OpenStack CI loop interface is available at jenkins.openstack.xenproject.org. The CI loop is now integrated with OpenStack Gerrit, in voting mode (Group B). This means that functional testing provided by our CI loop does not gate commits, but advises patch authors and reviewers of results in gerrit.
The CI loop tests our baseline against each Nova OpenStack commit.
Dashboard
The most useful view to get an overview over test failures can be found at the Build History page.
OpenStack review: Each build maps onto a changeset on review.openstack.org. The following figure shows how to map a test run on our CI loop to a specific OpenStack review.
Aborted builds: Sometimes, jobs are aborted. The main reason for aborted jobs is that the OpenStack CI loop run at the OpenStack Foundation (or another voting 3rd party CI loop) may have determined that a change breaks a test. In other words, it is not necessary to complete the test in this case. Aborted jobs are typically marked with a grey circle. Note that this is nothing to worry about
Checking up on Test Failures
Test failures can be caused by
- an OpenStack commit review.openstack.org
- an issue in libvirt
- an issue in Xen
The first thing to do is to check whether a failure has been caused by an OpenStack commit review.openstack.org. If that is the case, the OpenStack community will fix the issue and re-submit the changeset.
That is unless, the issue is specific to the Xen Project. In that case, there is an expectation that we help the committer investigate the issue. Note that you can also use zuul.openstack.xenproject.org/scoreboard to get a comparison which tests failures were Xen specific.
The figure below, shows how you can find the test reports and how you verify that an issue is Xen+Libvirt specific.
The figure below, shows you how you get to the libvirt and libxl libvirt driver log files, which you will need to investigate and reproduce an issue.
Scripts to investigate issues
A simple couple of bash lines to download the full console logs from the jobs and create a histogram of tempest tests caused the majority of the failures:
# for i in {1106..1374}; do wget http://104.239.148.40:8080/job/dsvm-tempest-xen/${i}/consoleFull -O ${i}_console; done # grep -h "\.\.\. FAIL" * | sed -e 's/.*\(tempest[^) ]*\).*/\1/' | sort | uniq -c | sort -n
Note that the
in {<start test-run>..<end test-run>}
portion of the script needs to be adjusted to the start and end test run.
Community Activities
Training Session (week of May 4th)
We are planning a training session the week of May 4th or the week after, For more details see here. This will also include a discussion on how to integrate the CI loop into the project's workflow.