[Starlingx-discuss] [docs] Setting up the docs.starlingx.io website

Arce Moreno, Abraham abraham.arce.moreno at intel.com
Mon Sep 3 21:07:41 UTC 2018


> > Are we considering to include some path in the site in order to upload
> reports?, should we open a thread for this as well?
> 
> This is a static site built from Sphinx docs.  What sort of report are you
> thinking about?

Reports containing results coming from our regular functional tests,
an example of the output in xml:

-<robot generator="Robot 3.0.4 (Python 2.7.12 on linux2)" generated="20180829 05:18:39.626">
    -<suite name="Setup" id="s1" source="/home/elio/secondgerrit/clean/stx-test-suite/Tests/Setup.robot">
        +<test name="Test Qemu Libvirt VMs Setup" id="s1-t1">
        +<test name="Test Install ISO" id="s1-t2">
        +<test name="Test Config Controller" id="s1-t3">
          <doc>Tests for Install and Configuration of a controller node. Author(s): - Jose Perez...
          <status starttime="20180829 05:18:39.627" endtime="20180829 05:57:07.073" status="FAIL"/>
      </suite>
    +<statistics>
      <errors> </errors>
</robot>

We were thinking where it could make sense to upload / post those results:
- Wiki
- Launchpad
- Repository

We also looked at how OpenStack reports results:
- For every repo, under Gerrit giving a Pass / Fail
- For RefStack, under their homepage page "community results" [0]
- Any other that could fit our needs?

Some ideas how to share StarlingX test reports:

- Test wiki page to show executive summary results parsed from the given xml:
   - Today this is how we report under our Test wiki page [1]
   - Partially automated
- stx-docs hosting those results parsed from the given xml to rst format:
   - Fully automated taking advantage of tox infrastructure, how about using "tox -e results"?
   - Results uploaded to doc.starlingx.io/results?

[0] https://refstack.openstack.org/#/community_results
[1] https://wiki.openstack.org/wiki/StarlingX/Test#Latest_ISO_image_Sanity_Summary



More information about the Starlingx-discuss mailing list