From 4e89824a333d5fd0afeb23e0601dc30e774f3b5f Mon Sep 17 00:00:00 2001 From: Morgan Richomme Date: Tue, 17 Jan 2017 18:20:27 +0100 Subject: Update testing community doc Change-Id: I7ffbb3c0460958e3ecd837a14bf0c9a5752d1fc0 Signed-off-by: Morgan Richomme --- docs/testing/ecosystem/index.rst | 14 + docs/testing/ecosystem/overview.rst | 338 +++++++++++++++++++++ .../framework.installation.procedure.render.rst | 10 - .../testframework/framework.userguide.render.rst | 10 - docs/testing/testframework/index.rst | 16 - .../testframework/opnfv.testframework.overview.rst | 17 -- 6 files changed, 352 insertions(+), 53 deletions(-) create mode 100644 docs/testing/ecosystem/index.rst create mode 100644 docs/testing/ecosystem/overview.rst delete mode 100644 docs/testing/testframework/framework.installation.procedure.render.rst delete mode 100644 docs/testing/testframework/framework.userguide.render.rst delete mode 100644 docs/testing/testframework/index.rst delete mode 100644 docs/testing/testframework/opnfv.testframework.overview.rst (limited to 'docs/testing') diff --git a/docs/testing/ecosystem/index.rst b/docs/testing/ecosystem/index.rst new file mode 100644 index 000000000..3ffb13bba --- /dev/null +++ b/docs/testing/ecosystem/index.rst @@ -0,0 +1,14 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 +.. (c) Christopher Price (Ericsson AB) + +***************************** +OPNFV Test Framework document +***************************** + +.. toctree:: + :maxdepth: 2 + + ./abstract + ./overview + diff --git a/docs/testing/ecosystem/overview.rst b/docs/testing/ecosystem/overview.rst new file mode 100644 index 000000000..940e720ab --- /dev/null +++ b/docs/testing/ecosystem/overview.rst @@ -0,0 +1,338 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +============= +OPNFV testing +============= + +Introduction +============ + +Testing is one of the key activities in OPNFV, including component level testing, +system testing, automated deployment validation and performance characteristics +or stress testing. + +Some projects are fully dedicated to testing, they provide frameworks or tooling. +The feature projects also include their own test suites. +he test projects fulfill different roles (such as functional checks, performance +measurement, platform and component benchmarks, and analysis) on the scenarios +released in OPNFV. + +This document will detail the OPNFV testing ecosystem, describe the commons used +by the projects and provide the links to project specific documentation. + + +OPNFV testing ecosystem +======================= + +The testing projects +-------------------- + +The OPNFV testing projects may be summarized as follows: + +.. figure:: https://wiki.opnfv.org/download/attachments/8688867/EcoSystem%20Copy.png + :align: center + :alt: Overview of OPNFV Testing projects + +The main projects of the testing projects are described in the table below: + ++----------------+---------------------------------------------------------+ +| Project | Description | ++================+=========================================================+ +| Bottlenecks | This project aims to find system bottlenecks by testing | +| | and verifying OPNFV infrastructure in a staging | +| | environment before committing it to a production | +| | environment. Instead of debugging a deployment in | +| | production environment, an automatic method for | +| | executing benchmarks which plans to validate the | +| | deployment during staging is adopted. This project | +| | provides a framework to find the bottlenecks of OPNFV | +| | infrastructure. | ++----------------+---------------------------------------------------------+ +| CPerf | SDN Controller benchmarks and performance testing, | +| | applicable to controllers in general. | ++----------------+---------------------------------------------------------+ +| Dovetail | This project intends to define and provide a set of | +| | OPNFV related validation criteria that will provide | +| | input for the evaluation of the use of OPNFV trademarks.| +| | The dovetail project is executed with the guidance and | +| | oversight of the Compliance and Certification committee | +| | and work to secure the goals of the C&C committee for | +| | each release. The project intends to incrementally | +| | define qualification criteria that establish the | +| | foundations of how we are able to measure the ability to| +| | utilize the OPNFV platform, how the platform itself | +| | should behave, and how applications may be deployed on | +| | the platform. | ++----------------+---------------------------------------------------------+ +| Functest | This project deals with the functional testing of the | +| | VIM and NFVI. It leverages several upstream test suites | +| | (OpenStack, ODL, ONOS,..) and can be used by feature | +| | project to launch feature test suites in CI/CD. | +| | The project is used for scenario validation. | ++----------------+---------------------------------------------------------+ +| Qtip | QTIP as the project for "Platform Performance | +| | Benchmarking" in OPNFV aims to provide user a simple | +| | indicator for performance, supported by comprehensive | +| | testing data and transparent calculation formula. | +| | It provides a platform with common services for | +| | performance benchmarking which helps users to build | +| | indicators by themselves with ease. | ++----------------+---------------------------------------------------------+ +| Storperf | The purpose of this project is to provide a tool to | +| | measure block and object storage performance in an NFVI.| +| | When complemented with a characterization of typical VF | +| | storage performance requirements, it can provide | +| | pass/fail thresholds for test, staging, and production | +| | NFVI environments. | ++----------------+---------------------------------------------------------+ +| VSperf | The Project “vSwitch Performance" develops a generic and| +| | architecture agnostic vSwitch testing framework and | +| | associated tests, that will serve as a basis for | +| | validating the suitability of different vSwitch | +| | implementations in a Telco NFV deployment environment. | +| | The output of this project will be utilized by the OPNFV| +| | Performance and Test group and its associated projects, | +| | as part of OPNFV Platform and VNF level testing and | +| | validation. | ++----------------+---------------------------------------------------------+ +| Yardstick | The goal of the Project is to verify the infrastructure | +| | compliance when running VNF applications. NFV Use Cases | +| | described in ETSI GS NFV 001 show a large variety of | +| | applications, each defining specific requirements and | +| | complex configuration on the underlying infrastructure | +| | and test tools.The Yardstick concept decomposes typical | +| | VNF work-load performance metrics into a number of | +| | characteristics/performance vectors, which each of them | +| | can be represented by distinct test-cases. | ++----------------+---------------------------------------------------------+ + + +=================================== +The testing working group resources +=================================== + +The assets +========== + +Overall Architecture +-------------------- +The Test result management can be summarized as follows:: + + +-------------+ +-------------+ +-------------+ + | | | | | | + | Test | | Test | | Test | + | Project #1 | | Project #2 | | Project #N | + | | | | | | + +-------------+ +-------------+ +-------------+ + | | | + V V V + +---------------------------------------------+ + | | + | Test Rest API front end | + | http://testresults.opnfv.org/test | + | | + +---------------------------------------------+ + ^ | ^ + | V | + | +-------------------------+ | + | | | | + | | Test Results DB | | + | | Mongo DB | | + | | | | + | +-------------------------+ | + | | + | | + +----------------------+ +----------------------+ + | | | | + | Testing Dashboards | | Landing page | + | | | | + +----------------------+ +----------------------+ + + +The testing databases +--------------------- +A Mongo DB Database has been introduced in Brahmaputra. +The following collections are declared in this database: + * pods: the list of pods used for production CI + * projects: the list of projects providing test cases + * testcases: the test cases related to a given project + * results: the results of the test cases + * scenarios: the OPNFV scenarios tested in CI + +This database can be used by any project through the testapi. +Please note that projects may also use additional databases. This database is +mainly use to colelct CI results and scenario trust indicators. + +This database is cloned for plugfest. + + +The test API +------------ +The Test API is used to declare pods, projects, test cases and test +results. Pods are the pods used to run the tests. +The results pushed in the database are related to pods, projects and +cases. If you try to push results of test done on non referenced pod, +the API will return an error message. + +An additional method dashboard has been added to post-process +the raw results in release Brahmaputra (deprecated in Colorado). + +The data model is very basic, 4 objects are created: + + * Pods + * Projects + * Testcases + * Results + +Pods:: + + { + "id": , + "details": , + "creation_date": "YYYY-MM-DD HH:MM:SS", + "name": , + "mode": , + "role": + }, + +Projects:: + + { + "id": , + "name": , + "creation_date": "YYYY-MM-DD HH:MM:SS", + "description": + }, + +Testcases:: + + { + "id": , + "name":, + "project_name":, + "creation_date": "YYYY-MM-DD HH:MM:SS", + "description": , + "url": + }, + +Results:: + + { + "_id": , + "case_name": , + "project_name": , + "pod_name": , + "installer": , + "version": , + "start_date": "YYYY-MM-DD HH:MM:SS", + "stop_date": "YYYY-MM-DD HH:MM:SS", + "build_tag": , + "scenario": , + "criteria": , + "trust_indicator": { + "current": 0, + "histories": [] + } + } + + Scenarios:: + + { + "id": , + "name":, + "name" : "os-odl_l2-nofeature-ha", + "installers":[ + { + "installer" : , + "versions": [ + { + "version": , + "owner": , + "custom list": { "projects": [{ + "functest" : [ "vping_ssh", "vping_userdata", "tempest_smoke_serial", "rally_sanity", "odl", "doctor"], + "yardstick" : [ "tc002","tc005","tc010","tc011","tc012","tc014","tc037","tc055","tc063","tc069","tc070","tc071","tc072","tc075"]}]}, + "score": { "projects": [{ + "functest" : [{"date": YYY-MM-DD HH:MM, "score":}, {"date": YYY-MM-DD HH:MM, "score":}, ...], + "yardstick" : [{"date": YYY-MM-DD HH:MM, "score":}, {"date": YYY-MM-DD HH:MM, "score":}, ...]}]}, + "trust_indicator": { "projects": [{ + "functest" : [{"date": YYY-MM-DD HH:MM,"status":}, {"date": YYY-MM-DD HH:MM,"status":},...], + "yardstick" : [{"date": YYY-MM-DD HH:MM,"status":}, {"date": YYY-MM-DD HH:MM,"status":},...]}]}}, + { .... + }, + +For detailed information, please go to + + http://testresults.opnfv.org/test/swagger/spec.html + + Authentication: opnfv/api@opnfv + +Please notes that POST/DELETE/PUT operations for test or study purpose via +swagger website is not allowed, because it will change the real data in +the database. + + +The reporting +------------- +Until Colorado, each testing project was reporting a status on a dedicated page. +It was decided to unify the reporting by creating a landing page that should give +the scenario status in one glance (it was previously consolidated manually +on a wiki page). The landing page will be display per scenario: + * the status of the deployment + * the score of the test projectS + * a trust indicator + +Additional filters (version, installer, test collection time window,... ) + +This landing page has been dockerized. The back end relies on the testing DB. + + TODO: add picture + +The test case catalog +---------------------- +Until Colorado, each testing project was managing the list of its test cases. It +was very hard to have a global view of the available test cases among the +different test projects. A common view was possible through the API but it was +not very user friendly. +It was decided to build a web site providing a consistent view of the test cases +per project and allow any scenario owner to build his/her custom list of tests. +The test catalog can be described as below:: + + TODO: add picture + +Other resources +=============== + +wiki: https://wiki.opnfv.org/testing + +mailing list: test-wg@lists.opnfv.org + +IRC chan: #opnfv-testperf + +weekly meeting (https://wiki.opnfv.org/display/meetings/TestPerf): + * Usual time: Every Thursday 15:00-16:00 UTC / 7:00-8:00 PST + * APAC time: 2nd Wednesday of the month 8:00-9:00 UTC + +======================= +Reference documentation +======================= + ++----------------+---------------------------------------------------------+ +| Project | Documentation links | ++================+=========================================================+ +| Bottlenecks | https://wiki.opnfv.org/display/bottlenecks/Bottlenecks | ++----------------+---------------------------------------------------------+ +| CPerf | https://wiki.opnfv.org/display/meetings/CPerf | ++----------------+---------------------------------------------------------+ +| Dovetail | https://wiki.opnfv.org/display/dovetail/Dovetail | ++----------------+---------------------------------------------------------+ +| Functest | https://wiki.opnfv.org/display/functest/ | ++----------------+---------------------------------------------------------+ +| Qtip | https://wiki.opnfv.org/display/qtip | ++----------------+---------------------------------------------------------+ +| Storperf | https://wiki.opnfv.org/display/storperf/Storperf | ++----------------+---------------------------------------------------------+ +| VSperf | https://wiki.opnfv.org/display/vsperf/VSperf | ++----------------+---------------------------------------------------------+ +| Yardstick | https://wiki.opnfv.org/display/yardstick/Yardstick | ++----------------+---------------------------------------------------------+ diff --git a/docs/testing/testframework/framework.installation.procedure.render.rst b/docs/testing/testframework/framework.installation.procedure.render.rst deleted file mode 100644 index 8eaa57d12..000000000 --- a/docs/testing/testframework/framework.installation.procedure.render.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) - - preparation and installation -============================================= - -.. Explain how to prepare for and install the test framework. -.. Need to identify the target structure of this document with the testing WG - diff --git a/docs/testing/testframework/framework.userguide.render.rst b/docs/testing/testframework/framework.userguide.render.rst deleted file mode 100644 index 3f9993c13..000000000 --- a/docs/testing/testframework/framework.userguide.render.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) - - userguide and reporting document -================================================= - -.. Explain how to use the test framework and read reports/results. -.. Need to identify the target structure of this document with the testing WG - diff --git a/docs/testing/testframework/index.rst b/docs/testing/testframework/index.rst deleted file mode 100644 index 16521c141..000000000 --- a/docs/testing/testframework/index.rst +++ /dev/null @@ -1,16 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) Christopher Price (Ericsson AB) - -***************************** -OPNFV Test Framework document -***************************** - -.. toctree:: - :maxdepth: 2 - - ./abstract - ./opnfv.testframework.overview - ./framework.installation.procedure.render - ./framework.userguide.render - diff --git a/docs/testing/testframework/opnfv.testframework.overview.rst b/docs/testing/testframework/opnfv.testframework.overview.rst deleted file mode 100644 index 92cc88685..000000000 --- a/docs/testing/testframework/opnfv.testframework.overview.rst +++ /dev/null @@ -1,17 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) Christopher Price (Ericsson AB) - -================================== -Using the test frameworks in OPNFV -================================== - -Testing is one of the key activities in OPNFV, validation can include component level testing, -system testing, automated deployment validation and performance characteristics testing. - -The following section outlines how to use the test projects that are delivered on the -OPNFV platform for the purpose of testing components and VNFs in the context of a -Brahmaputra deployment. - -Needs to be completed according to the testing WG needs. - -- cgit 1.2.3-korg