cdadd96a3c9b3873f286b5c2f810f6df8117cd27
[snaps.git] / docs / how-to-use / IntegrationTests.rst
1 SNAPS OpenStack Integration Testing
2 ===================================
3
4 These tests are ones designed to be run within their own dynamically created project along with a newly generated user
5 account and generally require other OpenStack object creators.
6
7 The Test Classes
8 ================
9
10 create_security_group_tests.py - CreateSecurityGroupTests
11 ---------------------------------------------------------
12
13 +---------------------------------------+---------------+-----------------------------------------------------------+
14 | Test Name                             | API Versions  | Description                                               |
15 +=======================================+===============+===========================================================+
16 | test_create_group_without_rules       | Keysone 2 & 3 | Ensures the OpenStackSecurityGroup class can create a     |
17 |                                       | Neutron 2     | security group without any rules                          |
18 +---------------------------------------+---------------+-----------------------------------------------------------+
19 | test_create_group_admin_user_to_new   | Keysone 2 & 3 | Ensures the OpenStackSecurityGroup class can be created   |
20 | _project                              | Neutron 2     | by the admin user and associated with a new project       |
21 +---------------------------------------+---------------+-----------------------------------------------------------+
22 | test_create_group_new_user_to_admin   | Keysone 2 & 3 | Ensures the OpenStackSecurityGroup class can be created   |
23 | _project                              | Neutron 2     | by the new user and associated with the admin project     |
24 +---------------------------------------+---------------+-----------------------------------------------------------+
25 | test_create_delete_group              | Keysone 2 & 3 | Ensures the OpenStackSecurityGroup class clean() method   |
26 |                                       | Neutron 2     | will not raise an exception should the group be deleted by|
27 |                                       |               | some other process                                        |
28 +---------------------------------------+---------------+-----------------------------------------------------------+
29 | test_create_group_with_one_simple_rule| Keysone 2 & 3 | Ensures the OpenStackSecurityGroup class can create a     |
30 |                                       | Neutron 2     | security group with a single simple rule                  |
31 +---------------------------------------+---------------+-----------------------------------------------------------+
32 | test_create_group_with_one_complex    | Keysone 2 & 3 | Ensures the OpenStackSecurityGroup class can create a     |
33 | _rule                                 | Neutron 2     | security group with a single complex rule                 |
34 +---------------------------------------+---------------+-----------------------------------------------------------+
35 | test_create_group_with_several_rules  | Keysone 2 & 3 | Ensures the OpenStackSecurityGroup class can create a     |
36 |                                       | Neutron 2     | security group with several rules                         |
37 +---------------------------------------+---------------+-----------------------------------------------------------+
38 | test_add_rule                         | Keysone 2 & 3 | Ensures the OpenStackSecurityGroup#add_rule() method      |
39 |                                       | Neutron 2     | properly creates and associates the new rule              |
40 +---------------------------------------+---------------+-----------------------------------------------------------+
41 | test_remove_rule_by_id                | Keysone 2 & 3 | Ensures the OpenStackSecurityGroup#remove_rule() method   |
42 |                                       | Neutron 2     | properly deletes and disassociates the old rule via its ID|
43 +---------------------------------------+---------------+-----------------------------------------------------------+
44 | test_remove_rule_by_setting           | Keysone 2 & 3 | Ensures the OpenStackSecurityGroup#remove_rule() method   |
45 |                                       | Neutron 2     | properly deletes and disassociates the old rule via its   |
46 |                                       |               | setting object                                            |
47 +---------------------------------------+---------------+-----------------------------------------------------------+
48
49 create_security_group_tests.py - CreateMultipleSecurityGroupTests
50 -----------------------------------------------------------------
51
52 +---------------------------------------+---------------+-----------------------------------------------------------+
53 | Test Name                             | API Versions  | Description                                               |
54 +=======================================+===============+===========================================================+
55 | test_sec_grp_same_name_diff_proj      | Keysone 2 & 3 | Ensures the OpenStackSecurityGroup class does not         |
56 |                                       | Neutron 2     | initialize security groups with the same name from other  |
57 |                                       |               | project/tenants                                           |
58 +---------------------------------------+---------------+-----------------------------------------------------------+
59
60 create_image_tests.py - CreateImageSuccessTests
61 -----------------------------------------------
62
63 +---------------------------------------+---------------+-----------------------------------------------------------+
64 | Test Name                             | Glance API    | Description                                               |
65 +=======================================+===============+===========================================================+
66 | test_create_image_clean_url           | 1 & 2         | Ensures the OpenStackImage class can create an image from |
67 |                                       |               | a download URL location                                   |
68 +---------------------------------------+---------------+-----------------------------------------------------------+
69 | test_create_image_clean_url_properties| 1 & 2         | Ensures the OpenStackImage class can create an image from |
70 |                                       |               | a download URL location with custom properties            |
71 +---------------------------------------+---------------+-----------------------------------------------------------+
72 | test_create_image_clean_file          | 1 & 2         | Ensures the OpenStackImage class can create an image from |
73 |                                       |               | a locally sourced image file                              |
74 +---------------------------------------+---------------+-----------------------------------------------------------+
75 | test_create_delete_image              | 1 & 2         | Ensures the OpenStackImage.clean() method deletes an image|
76 |                                       |               | and does not raise an exception on subsequent calls to the|
77 |                                       |               | clean() method                                            |
78 +---------------------------------------+---------------+-----------------------------------------------------------+
79 | test_create_same_image                | 1 & 2         | Ensures the OpenStackImage.create() method does not create|
80 |                                       |               | another image when one already exists with the same name  |
81 +---------------------------------------+---------------+-----------------------------------------------------------+
82 | test_create_same_image_new_settings   | 1 & 2         | Tests the creation of an OpenStack image when the image   |
83 |                                       |               | already exists and the configuration only contains the    |
84 |                                       |               | the name.                                                 |
85 +---------------------------------------+---------------+-----------------------------------------------------------+
86
87 create_image_tests.py - CreateImageNegativeTests
88 ------------------------------------------------
89
90 +---------------------------------------+---------------+-----------------------------------------------------------+
91 | Test Name                             | Glance API    | Description                                               |
92 +=======================================+===============+===========================================================+
93 | test_bad_image_name                   | 1 & 2         | Ensures OpenStackImage.create() results in an Exception   |
94 |                                       |               | being raised when the ImageConfig.name attribute has    |
95 |                                       |               | not been set                                              |
96 +---------------------------------------+---------------+-----------------------------------------------------------+
97 | test_bad_image_url                    | 1 & 2         | Ensures OpenStackImage.create() results in an Exception   |
98 |                                       |               | being raised when the download URL is invalid             |
99 +---------------------------------------+---------------+-----------------------------------------------------------+
100 | test_bad_image_type                   | 1 & 2         | Ensures OpenStackImage.create() results in an Exception   |
101 |                                       |               | being raised when the image format is 'foo'               |
102 +---------------------------------------+---------------+-----------------------------------------------------------+
103 | test_bad_image_file                   | 1 & 2         | Ensures OpenStackImage.create() results in an Exception   |
104 |                                       |               | being raised when the image file does not exist           |
105 +---------------------------------------+---------------+-----------------------------------------------------------+
106
107 create_image_tests.py - CreateMultiPartImageTests
108 -------------------------------------------------
109
110 +----------------------------------------+---------------+-----------------------------------------------------------+
111 | Test Name                              | Glance API    | Description                                               |
112 +========================================+===============+===========================================================+
113 | test_create_three_part_image_from_url  | 1 & 2         | Ensures that a 3-part image can be created when each part |
114 |                                        |               | is being sourced from URLs                                |
115 +----------------------------------------+---------------+-----------------------------------------------------------+
116 | test_create_three_part_image_from_file | 1 & 2         | Ensures that a 3-part image can be created when each part |
117 | _3_creators                            |               | is being sourced from local files and 3 creators are used |
118 +----------------------------------------+---------------+-----------------------------------------------------------+
119 | test_create_three_part_image_from_url  | 1 & 2         | Ensures that a 3-part image can be created when each part |
120 | _3_creators                            |               | is being sourced from a URL and 3 creators are used       |
121 +----------------------------------------+---------------+-----------------------------------------------------------+
122
123 create_keypairs_tests.py - CreateKeypairsTests
124 ----------------------------------------------
125
126 +---------------------------------------+---------------+-----------------------------------------------------------+
127 | Test Name                             | Nova API      | Description                                               |
128 +=======================================+===============+===========================================================+
129 | test_create_keypair_only              | 2             | Ensures that a keypair object can be created simply by    |
130 |                                       |               | only configuring a name                                   |
131 +---------------------------------------+---------------+-----------------------------------------------------------+
132 | test_create_keypair_large_key         | 2             | Ensures that a keypair object can be created with a large |
133 |                                       |               | key of 10000 bytes                                        |
134 +---------------------------------------+---------------+-----------------------------------------------------------+
135 | test_create_delete_keypair            | 2             | Ensures that a keypair object is deleted via              |
136 |                                       |               | OpenStackKeypair.clean() and subsequent calls do not      |
137 |                                       |               | result in exceptions                                      |
138 +---------------------------------------+---------------+-----------------------------------------------------------+
139 | test_create_keypair_save_pub_only     | 2             | Ensures that a keypair object can be created when the only|
140 |                                       |               | the public key is cached to disk                          |
141 +---------------------------------------+---------------+-----------------------------------------------------------+
142 | test_create_keypair_save_both         | 2             | Ensures that a keypair object can be created when both the|
143 |                                       |               | public and private keys are cached to disk                |
144 +---------------------------------------+---------------+-----------------------------------------------------------+
145 | test_create_keypair_from_file         | 2             | Ensures that a keypair object can be created with an      |
146 |                                       |               | existing public key file                                  |
147 +---------------------------------------+---------------+-----------------------------------------------------------+
148
149 create_keypairs_tests.py - CreateKeypairsCleanupTests
150 -----------------------------------------------------
151
152 +---------------------------------------+---------------+-----------------------------------------------------------+
153 | Test Name                             | Nova API      | Description                                               |
154 +=======================================+===============+===========================================================+
155 | test_create_keypair_gen_files_delete_1| 2             | Ensures that new keypair files are deleted by default     |
156 |                                       |               | by OpenStackKeypair#clean()                               |
157 +---------------------------------------+---------------+-----------------------------------------------------------+
158 | test_create_keypair_gen_files_delete_2| 2             | Ensures that new keypair files are deleted by             |
159 |                                       |               | OpenStackKeypair#clean() when the settings delete_on_clean|
160 |                                       |               | attribute is set to True                                  |
161 +---------------------------------------+---------------+-----------------------------------------------------------+
162 | test_create_keypair_gen_files_keep    | 2             | Ensures that new keypair files are not deleted by         |
163 |                                       |               | OpenStackKeypair#clean()                                  |
164 +---------------------------------------+---------------+-----------------------------------------------------------+
165 | test_create_keypair_exist_files_keep  | 2             | Ensures that existing keypair files are not deleted by    |
166 |                                       |               | OpenStackKeypair#clean()                                  |
167 +---------------------------------------+---------------+-----------------------------------------------------------+
168 | test_create_keypair_exist_files_delete| 2             | Ensures that existing keypair files are deleted by        |
169 |                                       |               | OpenStackKeypair#clean()                                  |
170 +---------------------------------------+---------------+-----------------------------------------------------------+
171
172 create_network_tests.py - CreateNetworkSuccessTests
173 ---------------------------------------------------
174
175 +---------------------------------------+---------------+-----------------------------------------------------------+
176 | Test Name                             | Neutron API   | Description                                               |
177 +=======================================+===============+===========================================================+
178 | test_create_network_without_router    | 2             | Ensures that a network can be created via the             |
179 |                                       |               | OpenStackNetwork class without any routers                |
180 +---------------------------------------+---------------+-----------------------------------------------------------+
181 | test_create_delete_network            | 2             | Ensures that a router can be deleted via the              |
182 |                                       |               | OpenStackNetwork.clean() method                           |
183 +---------------------------------------+---------------+-----------------------------------------------------------+
184 | test_create_network_with_router       | 2             | Ensures that a network can be created via the             |
185 |                                       |               | OpenStackNetwork class with a router                      |
186 +---------------------------------------+---------------+-----------------------------------------------------------+
187 | test_create_networks_same_name        | 2             | Ensures that the OpenStackNetwork.create() method will not|
188 |                                       |               | create a network with the same name                       |
189 +---------------------------------------+---------------+-----------------------------------------------------------+
190 | test_create_networks_router_admin_user| 2             | Ensures that the networks, subnets, and routers can be    |
191 | _to_new_project                       |               | create created by an admin user and assigned to a new     |
192 |                                       |               | project ID                                                |
193 +---------------------------------------+---------------+-----------------------------------------------------------+
194 | test_create_networks_router_new_user  | 2             | Ensures that the networks, subnets, and routers can be    |
195 | _to_admin_project                     |               | create created by a new admin user and assigned to the    |
196 |                                       |               | 'admin' project ID                                        |
197 +---------------------------------------+---------------+-----------------------------------------------------------+
198
199 create_network_tests.py - CreateNetworkIPv6Tests
200 ------------------------------------------------
201
202 +---------------------------------------+---------------+-----------------------------------------------------------+
203 | Test Name                             | Neutron API   | Description                                               |
204 +=======================================+===============+===========================================================+
205 | test_create_network_one_ipv6_subnet   | 2             | Ensures that a network can be created with an IPv6 subnet |
206 +---------------------------------------+---------------+-----------------------------------------------------------+
207 | test_create_network_ipv4_ipv6_subnet  | 2             | Ensures that a network can be created with an IPv4 and    |
208 |                                       |               | IPv6 subnet                                               |
209 +---------------------------------------+---------------+-----------------------------------------------------------+
210
211 create_network_tests.py - CreateMultipleNetworkTests
212 ----------------------------------------------------
213
214 +---------------------------------------+---------------+-----------------------------------------------------------+
215 | Test Name                             | Neutron API   | Description                                               |
216 +=======================================+===============+===========================================================+
217 | test_network_same_name_diff_proj      | 2             | Ensures that a network with the same name can be created  |
218 |                                       |               | against different projects                                |
219 +---------------------------------------+---------------+-----------------------------------------------------------+
220 | test_network_create_by_admin_to       | 2             | Ensures that a network can be created by the admin user   |
221 | _different_project                    |               | to another project and that a creator with the credentials|
222 |                                       |               | to the other project will not create a new network with   |
223 |                                       |               | the same name                                             |
224 +---------------------------------------+---------------+-----------------------------------------------------------+
225
226 create_router_tests.py - CreateRouterSuccessTests
227 -------------------------------------------------
228
229 +---------------------------------------+---------------+-----------------------------------------------------------+
230 | Test Name                             | Neutron API   | Description                                               |
231 +=======================================+===============+===========================================================+
232 | test_create_router_vanilla            | 2             | Ensures that a router can be created via the              |
233 |                                       |               | OpenStackRouter class with minimal settings               |
234 +---------------------------------------+---------------+-----------------------------------------------------------+
235 | test_create_router_admin_user_to_new  | 2             | Ensures that a router can be created by an admin user and |
236 | _project                              |               | assigned to a new project                                 |
237 +---------------------------------------+---------------+-----------------------------------------------------------+
238 | test_create_router_new_user_to_admin  | 2             | Ensures that a router can be created by a new user and    |
239 | _project                              |               | assigned to the admin project                             |
240 +---------------------------------------+---------------+-----------------------------------------------------------+
241 | test_create_delete_router             | 2             | Ensures that a router can be deleted via the              |
242 |                                       |               | OpenStackRouter.clean() method                            |
243 +---------------------------------------+---------------+-----------------------------------------------------------+
244 | test_create_router_admin_state_false  | 2             | Ensures that a router can created with                    |
245 |                                       |               | admin_state_up = False                                    |
246 +---------------------------------------+---------------+-----------------------------------------------------------+
247 | test_create_router_admin_state_True   | 2             | Ensures that a router can created with                    |
248 |                                       |               | admin_state_up = True                                     |
249 +---------------------------------------+---------------+-----------------------------------------------------------+
250 | test_create_router_private_network    | 2             | Ensures that a router port can be created against a       |
251 |                                       |               | private network                                           |
252 +---------------------------------------+---------------+-----------------------------------------------------------+
253 | test_create_router_external_network   | 2             | Ensures that a router can be created that is connected to |
254 |                                       |               | both external and private internal networks               |
255 +---------------------------------------+---------------+-----------------------------------------------------------+
256
257 create_router_tests.py - CreateRouterNegativeTests
258 --------------------------------------------------
259
260 +----------------------------------------+---------------+-----------------------------------------------------------+
261 | Test Name                              | Neutron API   | Description                                               |
262 +========================================+===============+===========================================================+
263 | test_create_router_noname              | 2             | Ensures that an exception is raised when attempting to    |
264 |                                        |               | create a router without a name                            |
265 +----------------------------------------+---------------+-----------------------------------------------------------+
266 | test_create_router_invalid_gateway_name| 2             | Ensures that an exception is raised when attempting to    |
267 |                                        |               | create a router to an external network that does not exist|
268 +----------------------------------------+---------------+-----------------------------------------------------------+
269
270 create_qos_tests.py - CreateQoSTests
271 ------------------------------------
272
273 +----------------------------------------+---------------+-----------------------------------------------------------+
274 | Test Name                              |  Cinder API   | Description                                               |
275 +========================================+===============+===========================================================+
276 | test_create_qos                        | 2 & 3         | Tests the creation of a QoS Spec with the class           |
277 |                                        |               | OpenStackQoS                                              |
278 +----------------------------------------+---------------+-----------------------------------------------------------+
279 | test_create_delete_qos                 | 2 & 3         | Tests the creation of a QoS Spec with the class           |
280 |                                        |               | OpenStackQoS, its deletion with cinder_utils.py the       |
281 |                                        |               | the attempts to use the clean() method to ensure an       |
282 |                                        |               | exception is not called                                   |
283 +----------------------------------------+---------------+-----------------------------------------------------------+
284 | test_create_same_qos                   | 2 & 3         | Tests the creation of a QoS Spec with the class           |
285 |                                        |               | OpenStackQoS then instantiates another OpenStackQoS       |
286 |                                        |               | object with the same configuration to ensure the second   |
287 |                                        |               | instance returns the ID of the original                   |
288 +----------------------------------------+---------------+-----------------------------------------------------------+
289
290 create_volume_type_tests.py - CreateSimpleVolumeTypeSuccessTests
291 ----------------------------------------------------------------
292
293 +----------------------------------------+---------------+-----------------------------------------------------------+
294 | Test Name                              |  Cinder API   | Description                                               |
295 +========================================+===============+===========================================================+
296 | test_create_volume_type                | 2 & 3         | Tests the creation of a Volume Type with the class        |
297 |                                        |               | OpenStackVolumeType                                       |
298 +----------------------------------------+---------------+-----------------------------------------------------------+
299 | test_create_delete_volume_type         | 2 & 3         | Tests the creation of a Volume Type with the class        |
300 |                                        |               | OpenStackVolumeType, its deletion with cinder_utils.py,   |
301 |                                        |               | then attempts to use the clean() method to ensure an      |
302 |                                        |               | exception is not raised                                   |
303 +----------------------------------------+---------------+-----------------------------------------------------------+
304 | test_create_same_volume_type           | 2 & 3         | Tests the creation of a Volume Type with the class        |
305 |                                        |               | OpenStackVolumeType then instantiates another             |
306 |                                        |               | OpenStackVolumeType object with the same configuration to |
307 |                                        |               | ensure the second instance returns the ID of the original |
308 +----------------------------------------+---------------+-----------------------------------------------------------+
309
310 create_volume_type_tests.py - CreateSimpleVolumeTypeComplexTests
311 ----------------------------------------------------------------
312
313 +-----------------------------------------+---------------+-----------------------------------------------------------+
314 | Test Name                               |  Cinder API   | Description                                               |
315 +=========================================+===============+===========================================================+
316 | test_volume_type_with_qos               | 2 & 3         | Tests the creation of a Volume Type with the class        |
317 |                                         |               | OpenStackVolumeType with a QoSSpec                        |
318 +-----------------------------------------+---------------+-----------------------------------------------------------+
319 | test_volume_type_with_encryption        | 2 & 3         | Tests the creation of a Volume Type with the class        |
320 |                                         |               | OpenStackVolumeType with encryption                       |
321 +-----------------------------------------+---------------+-----------------------------------------------------------+
322 | test_volume_type_with_qos_and_encryption| 2 & 3         | Tests the creation of a Volume Type with the class        |
323 |                                         |               | OpenStackVolumeType with encryption and QoS Spec          |
324 +-----------------------------------------+---------------+-----------------------------------------------------------+
325
326 create_volume_tests.py - CreateSimpleVolumeSuccessTests
327 -------------------------------------------------------
328
329 +----------------------------------------+---------------+-----------------------------------------------------------+
330 | Test Name                              |  Cinder API   | Description                                               |
331 +========================================+===============+===========================================================+
332 | test_create_volume_simple              | 2 & 3         | Tests the creation of a Volume Type with the class        |
333 |                                        |               | OpenStackVolume                                           |
334 +----------------------------------------+---------------+-----------------------------------------------------------+
335 | test_create_delete_volume              | 2 & 3         | Tests the creation of a Volume with the class             |
336 |                                        |               | OpenStackVolume, its deletion with cinder_utils.py, then  |
337 |                                        |               | attempts to use the clean() method to ensure an           |
338 |                                        |               | exception is not raised                                   |
339 +----------------------------------------+---------------+-----------------------------------------------------------+
340 | test_create_same_volume                | 2 & 3         | Tests the creation of a Volume with the class             |
341 |                                        |               | OpenStackVolume then instantiates another                 |
342 |                                        |               | OpenStackVolume object with the same configuration to     |
343 |                                        |               | ensure the second instance returns the ID of the original |
344 +----------------------------------------+---------------+-----------------------------------------------------------+
345
346 create_volume_tests.py - CreateSimpleVolumeFailureTests
347 -------------------------------------------------------
348
349 +----------------------------------------+---------------+-----------------------------------------------------------+
350 | Test Name                              |  Cinder API   | Description                                               |
351 +========================================+===============+===========================================================+
352 | test_create_volume_bad_size            | 2 & 3         | Tests to ensure that attempting to create a volume with a |
353 |                                        |               | size of -1 raises a BadRequest exception                  |
354 +----------------------------------------+---------------+-----------------------------------------------------------+
355 | test_create_volume_bad_type            | 2 & 3         | Tests to ensure that attempting to create a volume with a |
356 |                                        |               | type that does not exist raises a NotFound exception      |
357 +----------------------------------------+---------------+-----------------------------------------------------------+
358 | test_create_volume_bad_image           | 2 & 3         | Tests to ensure that attempting to create a volume with an|
359 |                                        |               | image that does not exist raises a BadRequest exception   |
360 +----------------------------------------+---------------+-----------------------------------------------------------+
361 | test_create_volume_bad_zone            | 2 & 3         | Tests to ensure that attempting to create a volume with an|
362 |                                        |               | invalid availability zone raises a BadRequest exception   |
363 +----------------------------------------+---------------+-----------------------------------------------------------+
364
365 create_volume_tests.py - CreateVolumeWithTypeTests
366 --------------------------------------------------
367
368 +----------------------------------------+---------------+-----------------------------------------------------------+
369 | Test Name                              |  Cinder API   | Description                                               |
370 +========================================+===============+===========================================================+
371 | test_bad_volume_type                   | 2 & 3         | Tests to ensure the creation of a Volume with the         |
372 |                                        |               | OpenStackVolume#create() method raises a NotFound         |
373 |                                        |               | exception when attempting to apply a VolumeType that does |
374 |                                        |               | not exist                                                 |
375 +----------------------------------------+---------------+-----------------------------------------------------------+
376 | test_valid_volume_type                 | 2 & 3         | Tests to ensure the creation of a Volume with the         |
377 |                                        |               | OpenStackVolume#create() method properly creates the      |
378 |                                        |               | volume when associating with a valid VolumeType           |
379 +----------------------------------------+---------------+-----------------------------------------------------------+
380
381 create_volume_tests.py - CreateVolumeWithImageTests
382 ---------------------------------------------------
383
384 +----------------------------------------+---------------+-----------------------------------------------------------+
385 | Test Name                              |  Cinder API   | Description                                               |
386 +========================================+===============+===========================================================+
387 | test_bad_image_name                    | 2 & 3         | Tests to ensure the creation of a Volume with the         |
388 |                                        |               | OpenStackVolume#create() method raises a BadRequest       |
389 |                                        |               | exception when attempting to apply an image that does not |
390 |                                        |               | exist                                                     |
391 +----------------------------------------+---------------+-----------------------------------------------------------+
392 | test_valid_volume_image                | 2 & 3         | Tests to ensure the creation of a Volume with the         |
393 |                                        |               | OpenStackVolume#create() method properly creates the      |
394 |                                        |               | volume when associating with a valid image                |
395 +----------------------------------------+---------------+-----------------------------------------------------------+
396
397 create_stack_tests.py - CreateStackSuccessTests
398 -----------------------------------------------
399
400 +---------------------------------------+---------------+-----------------------------------------------------------+
401 | Test Name                             |   Heat API    | Description                                               |
402 +=======================================+===============+===========================================================+
403 | test_create_stack_template_file       | 1-3           | Ensures that a Heat stack can be created with a file-based|
404 |                                       |               | Heat template file                                        |
405 +---------------------------------------+---------------+-----------------------------------------------------------+
406 | test_create_stack_template_dict       | 1-3           | Ensures that a Heat stack can be created with a dictionary|
407 |                                       |               | Heat template                                             |
408 +---------------------------------------+---------------+-----------------------------------------------------------+
409 | test_create_delete_stack              | 1-3           | Ensures that a Heat stack can be created and deleted      |
410 |                                       |               | while having clean() called 2x without an exception       |
411 +---------------------------------------+---------------+-----------------------------------------------------------+
412 | test_create_same_stack                | 1-3           | Ensures that a Heat stack with the same name cannot be    |
413 |                                       |               | created 2x                                                |
414 +---------------------------------------+---------------+-----------------------------------------------------------+
415 | test_retrieve_network_creators        | 1-3           | Ensures that an OpenStackHeatStack instance can return an |
416 |                                       |               | OpenStackNetwork instance configured as deployed          |
417 +---------------------------------------+---------------+-----------------------------------------------------------+
418 | test_retrieve_vm_inst_creators        | 1-3           | Ensures that an OpenStackHeatStack instance can return an |
419 |                                       |               | OpenStackVmInstance instance configured as deployed       |
420 +---------------------------------------+---------------+-----------------------------------------------------------+
421
422 create_stack_tests.py - CreateStackVolumeTests
423 ----------------------------------------------
424
425 +---------------------------------------+---------------+-----------------------------------------------------------+
426 | Test Name                             |   Heat API    | Description                                               |
427 +=======================================+===============+===========================================================+
428 | test_retrieve_volume_creator          | 1-3           | Ensures that an OpenStackHeatStack instance can return a  |
429 |                                       |               | OpenStackVolume instance that it was responsible for      |
430 |                                       |               | deploying                                                 |
431 +---------------------------------------+---------------+-----------------------------------------------------------+
432 | test_retrieve_volume_type_creator     | 1-3           | Ensures that an OpenStackHeatStack instance can return a  |
433 |                                       |               | OpenStackVolumeType instance that it was responsible for  |
434 |                                       |               | deploying                                                 |
435 +---------------------------------------+---------------+-----------------------------------------------------------+
436
437 create_stack_tests.py - CreateStackFloatingIpTests
438 --------------------------------------------------
439
440 +---------------------------------------+---------------+-----------------------------------------------------------+
441 | Test Name                             |   Heat API    | Description                                               |
442 +=======================================+===============+===========================================================+
443 | test_connect_via_ssh_heat_vm          | 1             | Ensures that an OpenStackHeatStack instance can create a  |
444 |                                       |               | VM with a floating IP that can be accessed via            |
445 |                                       |               | OpenStackVmInstance                                       |
446 +---------------------------------------+---------------+-----------------------------------------------------------+
447
448 create_stack_tests.py - CreateStackNestedResourceTests
449 ------------------------------------------------------
450
451 +---------------------------------------+---------------+-----------------------------------------------------------+
452 | Test Name                             |   Heat API    | Description                                               |
453 +=======================================+===============+===========================================================+
454 | test_nested                           | 1             | Ensures that an OpenStackHeatStack with an external       |
455 |                                       |               | resource file with VMs with floating IPs can be accessed  |
456 |                                       |               | in the class OpenStackVmInstance and return the associated|
457 |                                       |               | initialized OpenStackVmInstance objects                   |
458 +---------------------------------------+---------------+-----------------------------------------------------------+
459
460 create_stack_tests.py - CreateStackRouterTests
461 ----------------------------------------------
462
463 +---------------------------------------+---------------+-----------------------------------------------------------+
464 | Test Name                             |   Heat API    | Description                                               |
465 +=======================================+===============+===========================================================+
466 | test_retrieve_router_creator          | 1             | Ensures that an OpenStackHeatStack instance can return a  |
467 |                                       |               | OpenStackRouter instance that it was responsible for      |
468 |                                       |               | deploying                                                 |
469 +---------------------------------------+---------------+-----------------------------------------------------------+
470
471 create_stack_tests.py - CreateStackFlavorTests
472 ----------------------------------------------
473
474 +---------------------------------------+---------------+-----------------------------------------------------------+
475 | Test Name                             |   Heat API    | Description                                               |
476 +=======================================+===============+===========================================================+
477 | test_retrieve_flavor_creator          | 1-3           | Ensures that an OpenStackHeatStack instance can return a  |
478 |                                       |               | OpenStackFlavor instance that it was responsible for      |
479 |                                       |               | deploying                                                 |
480 +---------------------------------------+---------------+-----------------------------------------------------------+
481
482 create_stack_tests.py - CreateStackKeypairTests
483 -----------------------------------------------
484
485 +---------------------------------------+---------------+-----------------------------------------------------------+
486 | Test Name                             |   Heat API    | Description                                               |
487 +=======================================+===============+===========================================================+
488 | test_retrieve_keypair_creator         | 1-3           | Ensures that an OpenStackHeatStack instance can return a  |
489 |                                       |               | OpenStackKeypair instance that it was responsible for     |
490 |                                       |               | deploying                                                 |
491 +---------------------------------------+---------------+-----------------------------------------------------------+
492
493 create_stack_tests.py - CreateStackSecurityGroupTests
494 -----------------------------------------------------
495
496 +---------------------------------------+---------------+-----------------------------------------------------------+
497 | Test Name                             |   Heat API    | Description                                               |
498 +=======================================+===============+===========================================================+
499 | test_retrieve_security_group_creator  | 1-3           | Ensures that an OpenStackHeatStack instance can return a  |
500 |                                       |               | OpenStackSecurityGroup instance that it was responsible   |
501 |                                       |               | for deploying                                             |
502 +---------------------------------------+---------------+-----------------------------------------------------------+
503
504 create_stack_tests.py - CreateComplexStackTests
505 -----------------------------------------------
506
507 +---------------------------------------+---------------+-----------------------------------------------------------+
508 | Test Name                             |   Heat API    | Description                                               |
509 +=======================================+===============+===========================================================+
510 | test_connect_via_ssh_heat_vm          | 1-3           | Ensures that two OpenStackHeatStack instances can return  |
511 |                                       |               | OpenStackVmInstance instances one configured with a       |
512 |                                       |               | floating IP and keypair and can be access via SSH         |
513 +---------------------------------------+---------------+-----------------------------------------------------------+
514
515 create_stack_tests.py - CreateStackNegativeTests
516 ------------------------------------------------
517
518 +----------------------------------------+---------------+-----------------------------------------------------------+
519 | Test Name                              |   Heat API    | Description                                               |
520 +========================================+===============+===========================================================+
521 | test_missing_dependencies              | 1-3           | Ensures that a Heat template fails to deploy when expected|
522 |                                        |               | dependencies are missing                                  |
523 +----------------------------------------+---------------+-----------------------------------------------------------+
524 | test_bad_stack_file                    | 1-3           | Ensures that a Heat template fails to deploy when the Heat|
525 |                                        |               | template file does not exist                              |
526 +----------------------------------------+---------------+-----------------------------------------------------------+
527
528 create_stack_tests.py - CreateStackFailureTests
529 -----------------------------------------------
530
531 +----------------------------------------+---------------+-----------------------------------------------------------+
532 | Test Name                              |   Heat API    | Description                                               |
533 +========================================+===============+===========================================================+
534 | test_stack_failure                     | 1-3           | Ensures that a Heat template fails to deploy when expected|
535 |                                        |               | dependencies are missing                                  |
536 +----------------------------------------+---------------+-----------------------------------------------------------+
537
538 create_instance_tests.py - CreateInstanceSimpleTests
539 ----------------------------------------------------
540
541 +---------------------------------------+---------------+-----------------------------------------------------------+
542 | Test Name                             | API Versions  | Description                                               |
543 +=======================================+===============+===========================================================+
544 | test_create_delete_instance           | Nova 2        | Ensures that the OpenStackVmInstance.clean() method       |
545 |                                       | Neutron 2     | deletes the instance                                      |
546 +---------------------------------------+---------------+-----------------------------------------------------------+
547
548 create_instance_tests.py - SimpleHealthCheck
549 --------------------------------------------
550
551 +---------------------------------------+---------------+-----------------------------------------------------------+
552 | Test Name                             | API Versions  | Description                                               |
553 +=======================================+===============+===========================================================+
554 | test_check_vm_ip_dhcp                 | Nova 2        | Tests the creation of an OpenStack instance with a single |
555 |                                       | Neutron 2     | port and it's assigned IP address                         |
556 +---------------------------------------+---------------+-----------------------------------------------------------+
557
558 create_instance_tests.py - CreateInstanceTwoNetTests
559 ----------------------------------------------------
560
561 +---------------------------------------+---------------+-----------------------------------------------------------+
562 | Test Name                             | API Versions  | Description                                               |
563 +=======================================+===============+===========================================================+
564 | test_ping_via_router                  | Nova 2        | Tests the ability of two VMs on different private overlay |
565 |                                       | Neutron 2     | networks tied together with a router to ping each other   |
566 +---------------------------------------+---------------+-----------------------------------------------------------+
567
568 create_instance_tests.py - CreateInstanceSingleNetworkTests
569 -----------------------------------------------------------
570
571 +---------------------------------------+---------------+-----------------------------------------------------------+
572 | Test Name                             | API Versions  | Description                                               |
573 +=======================================+===============+===========================================================+
574 | test_single_port_static               | Nova 2        | Ensures that an instance with a single port/NIC with a    |
575 |                                       | Neutron 2     | static IP can be created                                  |
576 +---------------------------------------+---------------+-----------------------------------------------------------+
577 | test_ssh_client_fip_before_active     | Nova 2        | Ensures that an instance can be reached over SSH when the |
578 |                                       | Neutron 2     | floating IP is assigned prior to the VM becoming ACTIVE   |
579 +---------------------------------------+---------------+-----------------------------------------------------------+
580 | test_ssh_client_fip_after_active      | Nova 2        | Ensures that an instance can be reached over SSH when the |
581 |                                       | Neutron 2     | floating IP is assigned after to the VM becoming ACTIVE   |
582 +---------------------------------------+---------------+-----------------------------------------------------------+
583 | test_ssh_client_fip_after_init        | Nova 2        | Ensures that an instance can have a floating IP assigned  |
584 |                                       | Neutron 2     | added after initialization                                |
585 +---------------------------------------+---------------+-----------------------------------------------------------+
586 | test_ssh_client_fip_reverse_engineer  | Nova 2        | Ensures that an instance can be reverse engineered and    |
587 |                                       | Neutron 2     | allows for a floating IP to be added after initialization |
588 +---------------------------------------+---------------+-----------------------------------------------------------+
589 | test_ssh_client_fip_after_reboot      | Nova 2        | Ensures that an instance can be reached over SSH after    |
590 |                                       | Neutron 2     | a reboot call has been issued                             |
591 +---------------------------------------+---------------+-----------------------------------------------------------+
592 | test_ssh_client_fip_second_creator    | Nova 2        | Ensures that an instance can be reached over SSH via a    |
593 |                                       | Neutron 2     | second identical creator object                           |
594 +---------------------------------------+---------------+-----------------------------------------------------------+
595
596 create_instance_tests.py - CreateInstancePortManipulationTests
597 --------------------------------------------------------------
598
599 +---------------------------------------+---------------+-----------------------------------------------------------+
600 | Test Name                             | API Versions  | Description                                               |
601 +=======================================+===============+===========================================================+
602 | test_set_custom_valid_ip_one_subnet   | Nova 2        | Ensures that an instance's can have a valid static IP is  |
603 |                                       | Neutron 2     | properly assigned                                         |
604 +---------------------------------------+---------------+-----------------------------------------------------------+
605 | test_set_custom_invalid_ip_one_subnet | Nova 2        | Ensures that an instance's port with an invalid static IP |
606 |                                       | Neutron 2     | raises an exception                                       |
607 +---------------------------------------+---------------+-----------------------------------------------------------+
608 | test_set_custom_valid_mac             | Nova 2        | Ensures that an instance's port can have a valid MAC      |
609 |                                       | Neutron 2     | address properly assigned                                 |
610 +---------------------------------------+---------------+-----------------------------------------------------------+
611 | test_set_custom_invalid_mac           | Nova 2        | Ensures that an instance's port with an invalid MAC       |
612 |                                       | Neutron 2     | address raises and exception                              |
613 +---------------------------------------+---------------+-----------------------------------------------------------+
614 | test_set_custom_mac_and_ip            | Nova 2        | Ensures that an instance's port with a valid static IP and|
615 |                                       | Neutron 2     | MAC are properly assigned                                 |
616 +---------------------------------------+---------------+-----------------------------------------------------------+
617 | test_set_allowed_address_pairs        | Nova 2        | Ensures the configured allowed_address_pairs is properly  |
618 |                                       | Neutron 2     | set on a VMs port                                         |
619 +---------------------------------------+---------------+-----------------------------------------------------------+
620 | test_set_allowed_address_pairs_bad_mac| Nova 2        | Ensures the port cannot be created when a bad MAC address |
621 |                                       | Neutron 2     | format is used in the allowed_address_pairs port attribute|
622 +---------------------------------------+---------------+-----------------------------------------------------------+
623 | test_set_allowed_address_pairs_bad_ip | Nova 2        | Ensures the port cannot be created when a bad IP address  |
624 |                                       | Neutron 2     | format is used in the allowed_address_pairs port attribute|
625 +---------------------------------------+---------------+-----------------------------------------------------------+
626
627 create_instance_tests.py - CreateInstanceOnComputeHost
628 ------------------------------------------------------
629
630 +---------------------------------------+---------------+-----------------------------------------------------------+
631 | Test Name                             | API Versions  | Description                                               |
632 +=======================================+===============+===========================================================+
633 | test_deploy_vm_to_each_compute_node   | Nova 2        | Tests to ensure that one can fire up an instance on each  |
634 |                                       | Neutron 2     | active compute node                                       |
635 +---------------------------------------+---------------+-----------------------------------------------------------+
636
637 create_instance_tests.py - CreateInstanceFromThreePartImage
638 -----------------------------------------------------------
639
640 +-----------------------------------------------------+---------------+-----------------------------------------------------------+
641 | Test Name                                           | API Versions  | Description                                               |
642 +=====================================================+===============+===========================================================+
643 | test_create_delete_instance_from_three_part_image   | Nova 2        | Tests to ensure that one can fire up an instance then     |
644 |                                                     | Neutron 2     | delete it when using a 3-part image                       |
645 +-----------------------------------------------------+---------------+-----------------------------------------------------------+
646
647 create_instance_tests.py - CreateInstanceIPv6NetworkTests (Staging)
648 -------------------------------------------------------------------
649
650 +---------------------------------------+---------------+-----------------------------------------------------------+
651 | Test Name                             | API Versions  | Description                                               |
652 +=======================================+===============+===========================================================+
653 | test_v4fip_v6overlay                  | Nova 2        | Expects a BadRequest exception to be raised when          |
654 |                                       | Neutron 2     | attempting to add an IPv4 floating IP to a VM with an IPv6|
655 |                                       |               | port                                                      |
656 +---------------------------------------+---------------+-----------------------------------------------------------+
657 | test_fip_v4and6_overlay               | Nova 2        | Connects to a VM via a floating IP joined to a port that  |
658 |                                       | Neutron 2     | has been confiured with both IPv4 and IPv6 addresses      |
659 +---------------------------------------+---------------+-----------------------------------------------------------+
660
661 create_instance_tests.py - InstanceSecurityGroupTests
662 -----------------------------------------------------
663
664 +---------------------------------------+---------------+-----------------------------------------------------------+
665 | Test Name                             | API Versions  | Description                                               |
666 +=======================================+===============+===========================================================+
667 | test_add_security_group               | Nova 2        | Ensures that a VM instance can have security group added  |
668 |                                       | Neutron 2     | to it while its running                                   |
669 +---------------------------------------+---------------+-----------------------------------------------------------+
670 | test_add_invalid_security_group       | Nova 2        | Ensures that a VM instance does not accept the addition of|
671 |                                       | Neutron 2     | a security group that no longer exists                    |
672 +---------------------------------------+---------------+-----------------------------------------------------------+
673 | test_remove_security_group            | Nova 2        | Ensures that a VM instance accepts the removal of a       |
674 |                                       | Neutron 2     | security group                                            |
675 +---------------------------------------+---------------+-----------------------------------------------------------+
676 | test_remove_security_group_never_added| Nova 2        | Ensures that a VM instance does not accept the removal of |
677 |                                       | Neutron 2     | a security group that was never added in the first place  |
678 +---------------------------------------+---------------+-----------------------------------------------------------+
679 | test_add_same_security_group          | Nova 2        | Ensures that a VM instance does not add a security group  |
680 |                                       | Neutron 2     | that has already been added to the instance               |
681 +---------------------------------------+---------------+-----------------------------------------------------------+
682
683 create_instance_tests.py - CreateInstanceVolumeTests
684 ----------------------------------------------------
685
686 +---------------------------------------+---------------+-----------------------------------------------------------+
687 | Test Name                             | API Versions  | Description                                               |
688 +=======================================+===============+===========================================================+
689 | test_create_instance_with_one_volume  | Nova 2        | Ensures that a VM instance can have one volume attached   |
690 |                                       | Cinder 2 & 3  | to it                                                     |
691 +---------------------------------------+---------------+-----------------------------------------------------------+
692 | test_create_instance_with_two_volumes | Nova 2        | Ensures that a VM instance can have two volumes attached  |
693 |                                       | Cinder 2 & 3  | to it                                                     |
694 +---------------------------------------+---------------+-----------------------------------------------------------+
695
696 ansible_utils_tests.py - AnsibleProvisioningTests
697 -------------------------------------------------
698
699 +---------------------------------------+---------------+-----------------------------------------------------------+
700 | Test Name                             | API Versions  | Description                                               |
701 +=======================================+===============+===========================================================+
702 | test_apply_simple_playbook            | Nova 2        | Ensures that an instance assigned with a floating IP will |
703 |                                       | Neutron 2     | apply a simple Ansible playbook                           |
704 +---------------------------------------+---------------+-----------------------------------------------------------+
705 | test_apply_template_playbook          | Nova 2        | Ensures that an instance assigned with a floating IP will |
706 |                                       | Neutron 2     | apply a Ansible playbook containing Jinga2 substitution   |
707 |                                       |               | values                                                    |
708 +---------------------------------------+---------------+-----------------------------------------------------------+
709
710 cluster_template_tests.py - CreateClusterTemplateTests
711 ------------------------------------------------------
712
713 +----------------------------------------+---------------+-----------------------------------------------------------+
714 | Test Name                              |  Magnum API   | Description                                               |
715 +========================================+===============+===========================================================+
716 | test_create_cluster_template           | 1             | Tests the creation of a Cluster template with the class   |
717 |                                        |               | OpenStackClusterTemplate                                  |
718 +----------------------------------------+---------------+-----------------------------------------------------------+
719 | test_create_delete_cluster_template    | 1             | Tests the creation and deletiong of a Cluster template    |
720 |                                        |               | with the class OpenStackClusterTemplate                   |
721 +----------------------------------------+---------------+-----------------------------------------------------------+
722 | test_create_same_cluster_template      | 1             | Tests the creation of a Cluster template 2x using the same|
723 |                                        |               | config object to ensure it was only created once          |
724 +----------------------------------------+---------------+-----------------------------------------------------------+
725 | test_create_cluster_template_bad_flavor| 1             | Tests to ensure OpenStackClusterTemplate#create() will    |
726 |                                        |               | raise an exception when the flavor is invalid             |
727 +----------------------------------------+---------------+-----------------------------------------------------------+
728 | test_create_cluster_template_bad_master| 1             | Tests to ensure OpenStackClusterTemplate#create() will    |
729 | _flavor                                |               | raise an exception when the master flavor is invalid      |
730 +----------------------------------------+---------------+-----------------------------------------------------------+
731 | test_create_cluster_template_bad_image | 1             | Tests to ensure OpenStackClusterTemplate#create() will    |
732 |                                        |               | raise an exception when the image is invalid              |
733 +----------------------------------------+---------------+-----------------------------------------------------------+
734 | test_create_cluster_template_bad       | 1             | Tests to ensure OpenStackClusterTemplate#create() will    |
735 | _network_driver                        |               | raise an exception when the network driver is invalid     |
736 +----------------------------------------+---------------+-----------------------------------------------------------+
737 | test_create_cluster_template_bad       | 1             | Tests to ensure OpenStackClusterTemplate#create() will    |
738 | _volume_driver                         |               | raise an exception when the volume driver is invalid      |
739 +----------------------------------------+---------------+-----------------------------------------------------------+
740