X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=resources%2Ftools%2Fdoc_gen%2Fsrc%2Findex.rst;fp=resources%2Ftools%2Fdoc_gen%2Fsrc%2Findex.rst;h=b92ecd6bd414a6b35b4312f25183a6e738688e24;hp=0000000000000000000000000000000000000000;hb=4dadc7a005ca99aa5a14ac650e9aa187cea10619;hpb=4bda4f8b55b0d431b514663e8e90fccd97ad31d4 diff --git a/resources/tools/doc_gen/src/index.rst b/resources/tools/doc_gen/src/index.rst new file mode 100644 index 0000000000..b92ecd6bd4 --- /dev/null +++ b/resources/tools/doc_gen/src/index.rst @@ -0,0 +1,78 @@ +.. |csit| replace:: Continuous System Integration and Testing + + +|csit| Description +================== + +#. Development of software code for fully automated VPP code testing, functionality, performance, regression and new functions. +#. Execution of CSIT test suites on VPP code running on LF FD.io virtual and physical compute environments. +#. Integration with FD.io continuous integration systems (Gerrit, Jenkins and such). +#. Identified existing FD.io project dependencies and interactions: + - vpp - Vector Packet Processing. + - honeycomb - Honeycomb Agent for management plane testing. + - ci-management - Management repo for Jenkins Job Builder, script and management related to the Jenkins CI configuration. + +Project Scope +------------- + +#. Automated regression testing of VPP code changes + - Functionality of VPP data plane, network control plane, management plane against functional specifications. + - Performance of VPP data plane including non-drop-rate packet throughput and delay, against established reference benchmarks. + - Performance of network control plane against established reference benchmarks. + - Performance of management plane against established reference benchmarks. +#. Test case definitions driven by supported and planned VPP functionality, interfaces and performance: + - Uni-dimensional tests: Data plane, (Network) Control plane, Management plane. + - Multi-dimensional tests: Use case driven. +#. Integration with FD.io Continuous Integration system including FD.io Gerrit and Jenkins + - Automated test execution triggered by VPP-VERIFY jobs other VPP and CSIT project jobs. +#. Integration with LF VPP test execution environment + - Functional tests execution on LF hosted VM environment. + - Performance and functional tests execution on LF hosted physical compute environment. + - Subset of tests executed on LF hosted physical compute running VIRL (Virtual Internet Routing Lab). + +|csit| Documentation +-------------------- + +Python Library +############## + +.. toctree:: + :maxdepth: 2 + :glob: + + resources.libraries.python + +Robot Library +############# + +.. toctree:: + :maxdepth: 2 + :glob: + + resources.libraries.robot + +Functional Tests +################ + +.. toctree:: + :maxdepth: 3 + :glob: + + tests.func + +Performance Tests +################# + +.. toctree:: + :maxdepth: 2 + :glob: + + tests.perf + + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search`