blob: 98d798e2599237c17f64f1b19096cdaeab0918dc (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
===========================
Functest Installation Guide
===========================
.. toctree::
:numbered:
:maxdepth: 2
Version history
===============
+------------+----------+------------------+----------------------------------+
| **Date** | **Ver.** | **Author** | **Comment** |
| | | | |
+------------+----------+------------------+----------------------------------+
| 2016-08-17 | 1.0.0 | Juha Haapavirta | Colorado release |
| | | Column Gaynor | |
+------------+----------+------------------+----------------------------------+
| 2017-01-19 | 1.0.1 | Morgan Richomme | Adaptations for Danube |
| | | | * update testcase list |
| | | | * update docker command |
+------------+----------+------------------+----------------------------------+
| 2017-08-16 | 1.0.2 | Morgan Richomme | Adaptations for Euphrates |
+------------+----------+------------------+----------------------------------+
Introduction
============
This document describes how to install and configure Functest in OPNFV.
High level architecture
-----------------------
The high level architecture of Functest within OPNFV can be described as
follows::
CIMC/Lights+out management Admin Mgmt/API Public Storage Private
PXE
+ + + + + +
| | | | | |
| +----------------------------+ | | | | |
| | | | | | | |
+-----+ Jumphost | | | | | |
| | | | | | | |
| | +--------------------+ | | | | | |
| | | | | | | | | |
| | | Tools | +----------------+ | | |
| | | - Rally | | | | | | |
| | | - Robot | | | | | | |
| | | - RefStack | | | | | | |
| | | | |-------------------------+ | |
| | | Testcases | | | | | | |
| | | - VIM | | | | | | |
| | | | | | | | | |
| | | - SDN Controller | | | | | | |
| | | | | | | | | |
| | | - Features | | | | | | |
| | | | | | | | | |
| | | - VNF | | | | | | |
| | | | | | | | | |
| | +--------------------+ | | | | | |
| | Functest Docker + | | | | |
| | | | | | | |
| | | | | | | |
| | | | | | | |
| +----------------------------+ | | | | |
| | | | | |
| +----------------+ | | | | |
| | 1 | | | | | |
+----+ +--------------+-+ | | | | |
| | | 2 | | | | | |
| | | +--------------+-+ | | | | |
| | | | 3 | | | | | |
| | | | +--------------+-+ | | | | |
| | | | | 4 | | | | | |
| +-+ | | +--------------+-+ | | | | |
| | | | | 5 +-------------+ | | | |
| +-+ | | nodes for | | | | | |
| | | | deploying +---------------------+ | | |
| +-+ | OPNFV | | | | | |
| | | +------------------------------+ | |
| +-+ SUT | | | | | |
| | +--------------------------------------+ |
| | | | | | | |
| | +----------------------------------------------+
| +----------------+ | | | | |
| | | | | |
+ + + + + +
SUT = System Under Test
Note connectivity to management network is not needed for most of the testcases.
But it may be needed for some specific snaps tests.
All the libraries and dependencies needed by all of the Functest tools are
pre-installed into the Docker images. This allows running Functest on any
platform.
The automated mechanisms inside the Functest Docker container will:
* Retrieve OpenStack credentials
* Prepare the environment according to the System Under Test (SUT)
* Perform the appropriate functional tests
* Push the test results into the OPNFV test result database
This Docker image can be integrated into CI or deployed independently.
Please note that the Functest Docker container has been designed for OPNFV,
however, it would be possible to adapt it to any OpenStack based VIM +
controller environment, since most of the test cases are integrated from
upstream communities.
The functional test cases are described in the Functest User Guide `[2]`_
.. include:: ./prerequisites.rst
.. include:: ./configguide.rst
.. include:: ./ci.rst
References
==========
`[1]`_ : Keystone and public end point constraint
`[2]`_ : Functest User guide
`[3]`_ : Functest Jenkins jobs
`[4]`_ : Functest Configuration guide
`[5]`_ : OPNFV main site
`[6]`_ : Functest wiki page
IRC support channel: #opnfv-functest
.. _`[1]`: https://ask.openstack.org/en/question/68144/keystone-unable-to-use-the-public-endpoint/
.. _`[2]`: http://docs.opnfv.org/en/latest/submodules/functest/docs/testing/user/userguide/index.html
.. _`[3]`: https://git.opnfv.org/releng/tree/jjb/functest/functest-daily-jobs.yml
.. _`[4]`: http://docs.opnfv.org/en/latest/submodules/functest/docs/testing/user/configguide/index.html
.. _`[5]`: http://www.opnfv.org
.. _`[6]`: https://wiki.opnfv.org/functest
|
