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 - CreateNetworkGatewayTests
 200 ---------------------------------------------------
 201
 202 +---------------------------------------+---------------+-----------------------------------------------------------+
 203 | Test Name                             | Neutron API   | Description                                               |
 204 +=======================================+===============+===========================================================+
 205 | test_create_subnet_default_gateway_ip | 2             | Ensures that a network can be created with a Subnet that  |
 206 |                                       |               | has the gateway_ip automatically assigned                 |
 207 +---------------------------------------+---------------+-----------------------------------------------------------+
 208 | test_create_subnet_valid_gateway_ip   | 2             | Ensures that a network can be created with a Subnet that  |
 209 |                                       |               | has the gateway_ip statically assigned with a valid IP    |
 210 +---------------------------------------+---------------+-----------------------------------------------------------+
 211 | test_create_subnet_no_gateway         | 2             | Ensures that a network can be created where no gateway_ip |
 212 |                                       |               | is assigned                                               |
 213 +---------------------------------------+---------------+-----------------------------------------------------------+
 214 | test_create_subnet_invalid_gateway_ip | 2             | Ensures that a network cannot be created with a Subnet    |
 215 |                                       |               | has an invalid gateway_ip value such as 'foo'             |
 216 +---------------------------------------+---------------+-----------------------------------------------------------+
 217
 218 create_network_tests.py - CreateNetworkIPv6Tests
 219 ------------------------------------------------
 220
 221 +---------------------------------------+---------------+-----------------------------------------------------------+
 222 | Test Name                             | Neutron API   | Description                                               |
 223 +=======================================+===============+===========================================================+
 224 | test_create_network_one_ipv6_subnet   | 2             | Ensures that a network can be created with an IPv6 subnet |
 225 +---------------------------------------+---------------+-----------------------------------------------------------+
 226 | test_create_network_ipv4_ipv6_subnet  | 2             | Ensures that a network can be created with an IPv4 and    |
 227 |                                       |               | IPv6 subnet                                               |
 228 +---------------------------------------+---------------+-----------------------------------------------------------+
 229
 230 create_network_tests.py - CreateMultipleNetworkTests
 231 ----------------------------------------------------
 232
 233 +---------------------------------------+---------------+-----------------------------------------------------------+
 234 | Test Name                             | Neutron API   | Description                                               |
 235 +=======================================+===============+===========================================================+
 236 | test_network_same_name_diff_proj      | 2             | Ensures that a network with the same name can be created  |
 237 |                                       |               | against different projects                                |
 238 +---------------------------------------+---------------+-----------------------------------------------------------+
 239 | test_network_create_by_admin_to       | 2             | Ensures that a network can be created by the admin user   |
 240 | _different_project                    |               | to another project and that a creator with the credentials|
 241 |                                       |               | to the other project will not create a new network with   |
 242 |                                       |               | the same name                                             |
 243 +---------------------------------------+---------------+-----------------------------------------------------------+
 244
 245 create_router_tests.py - CreateRouterSuccessTests
 246 -------------------------------------------------
 247
 248 +---------------------------------------+---------------+-----------------------------------------------------------+
 249 | Test Name                             | Neutron API   | Description                                               |
 250 +=======================================+===============+===========================================================+
 251 | test_create_router_vanilla            | 2             | Ensures that a router can be created via the              |
 252 |                                       |               | OpenStackRouter class with minimal settings               |
 253 +---------------------------------------+---------------+-----------------------------------------------------------+
 254 | test_create_router_admin_user_to_new  | 2             | Ensures that a router can be created by an admin user and |
 255 | _project                              |               | assigned to a new project                                 |
 256 +---------------------------------------+---------------+-----------------------------------------------------------+
 257 | test_create_router_new_user_to_admin  | 2             | Ensures that a router can be created by a new user and    |
 258 | _project                              |               | assigned to the admin project                             |
 259 +---------------------------------------+---------------+-----------------------------------------------------------+
 260 | test_create_delete_router             | 2             | Ensures that a router can be deleted via the              |
 261 |                                       |               | OpenStackRouter.clean() method                            |
 262 +---------------------------------------+---------------+-----------------------------------------------------------+
 263 | test_create_router_admin_state_false  | 2             | Ensures that a router can created with                    |
 264 |                                       |               | admin_state_up = False                                    |
 265 +---------------------------------------+---------------+-----------------------------------------------------------+
 266 | test_create_router_admin_state_True   | 2             | Ensures that a router can created with                    |
 267 |                                       |               | admin_state_up = True                                     |
 268 +---------------------------------------+---------------+-----------------------------------------------------------+
 269 | test_create_router_private_network    | 2             | Ensures that a router port can be created against a       |
 270 |                                       |               | private network                                           |
 271 +---------------------------------------+---------------+-----------------------------------------------------------+
 272 | test_create_router_external_network   | 2             | Ensures that a router can be created that is connected to |
 273 |                                       |               | both external and private internal networks               |
 274 +---------------------------------------+---------------+-----------------------------------------------------------+
 275
 276 create_router_tests.py - CreateRouterNegativeTests
 277 --------------------------------------------------
 278
 279 +----------------------------------------+---------------+-----------------------------------------------------------+
 280 | Test Name                              | Neutron API   | Description                                               |
 281 +========================================+===============+===========================================================+
 282 | test_create_router_noname              | 2             | Ensures that an exception is raised when attempting to    |
 283 |                                        |               | create a router without a name                            |
 284 +----------------------------------------+---------------+-----------------------------------------------------------+
 285 | test_create_router_invalid_gateway_name| 2             | Ensures that an exception is raised when attempting to    |
 286 |                                        |               | create a router to an external network that does not exist|
 287 +----------------------------------------+---------------+-----------------------------------------------------------+
 288
 289 create_qos_tests.py - CreateQoSTests
 290 ------------------------------------
 291
 292 +----------------------------------------+---------------+-----------------------------------------------------------+
 293 | Test Name                              |  Cinder API   | Description                                               |
 294 +========================================+===============+===========================================================+
 295 | test_create_qos                        | 2 & 3         | Tests the creation of a QoS Spec with the class           |
 296 |                                        |               | OpenStackQoS                                              |
 297 +----------------------------------------+---------------+-----------------------------------------------------------+
 298 | test_create_delete_qos                 | 2 & 3         | Tests the creation of a QoS Spec with the class           |
 299 |                                        |               | OpenStackQoS, its deletion with cinder_utils.py the       |
 300 |                                        |               | the attempts to use the clean() method to ensure an       |
 301 |                                        |               | exception is not called                                   |
 302 +----------------------------------------+---------------+-----------------------------------------------------------+
 303 | test_create_same_qos                   | 2 & 3         | Tests the creation of a QoS Spec with the class           |
 304 |                                        |               | OpenStackQoS then instantiates another OpenStackQoS       |
 305 |                                        |               | object with the same configuration to ensure the second   |
 306 |                                        |               | instance returns the ID of the original                   |
 307 +----------------------------------------+---------------+-----------------------------------------------------------+
 308
 309 create_volume_type_tests.py - CreateSimpleVolumeTypeSuccessTests
 310 ----------------------------------------------------------------
 311
 312 +----------------------------------------+---------------+-----------------------------------------------------------+
 313 | Test Name                              |  Cinder API   | Description                                               |
 314 +========================================+===============+===========================================================+
 315 | test_create_volume_type                | 2 & 3         | Tests the creation of a Volume Type with the class        |
 316 |                                        |               | OpenStackVolumeType                                       |
 317 +----------------------------------------+---------------+-----------------------------------------------------------+
 318 | test_create_delete_volume_type         | 2 & 3         | Tests the creation of a Volume Type with the class        |
 319 |                                        |               | OpenStackVolumeType, its deletion with cinder_utils.py,   |
 320 |                                        |               | then attempts to use the clean() method to ensure an      |
 321 |                                        |               | exception is not raised                                   |
 322 +----------------------------------------+---------------+-----------------------------------------------------------+
 323 | test_create_same_volume_type           | 2 & 3         | Tests the creation of a Volume Type with the class        |
 324 |                                        |               | OpenStackVolumeType then instantiates another             |
 325 |                                        |               | OpenStackVolumeType object with the same configuration to |
 326 |                                        |               | ensure the second instance returns the ID of the original |
 327 +----------------------------------------+---------------+-----------------------------------------------------------+
 328
 329 create_volume_type_tests.py - CreateSimpleVolumeTypeComplexTests
 330 ----------------------------------------------------------------
 331
 332 +-----------------------------------------+---------------+-----------------------------------------------------------+
 333 | Test Name                               |  Cinder API   | Description                                               |
 334 +=========================================+===============+===========================================================+
 335 | test_volume_type_with_qos               | 2 & 3         | Tests the creation of a Volume Type with the class        |
 336 |                                         |               | OpenStackVolumeType with a QoSSpec                        |
 337 +-----------------------------------------+---------------+-----------------------------------------------------------+
 338 | test_volume_type_with_encryption        | 2 & 3         | Tests the creation of a Volume Type with the class        |
 339 |                                         |               | OpenStackVolumeType with encryption                       |
 340 +-----------------------------------------+---------------+-----------------------------------------------------------+
 341 | test_volume_type_with_qos_and_encryption| 2 & 3         | Tests the creation of a Volume Type with the class        |
 342 |                                         |               | OpenStackVolumeType with encryption and QoS Spec          |
 343 +-----------------------------------------+---------------+-----------------------------------------------------------+
 344
 345 create_volume_tests.py - CreateSimpleVolumeSuccessTests
 346 -------------------------------------------------------
 347
 348 +----------------------------------------+---------------+-----------------------------------------------------------+
 349 | Test Name                              |  Cinder API   | Description                                               |
 350 +========================================+===============+===========================================================+
 351 | test_create_volume_simple              | 2 & 3         | Tests the creation of a Volume Type with the class        |
 352 |                                        |               | OpenStackVolume                                           |
 353 +----------------------------------------+---------------+-----------------------------------------------------------+
 354 | test_create_delete_volume              | 2 & 3         | Tests the creation of a Volume with the class             |
 355 |                                        |               | OpenStackVolume, its deletion with cinder_utils.py, then  |
 356 |                                        |               | attempts to use the clean() method to ensure an           |
 357 |                                        |               | exception is not raised                                   |
 358 +----------------------------------------+---------------+-----------------------------------------------------------+
 359 | test_create_same_volume                | 2 & 3         | Tests the creation of a Volume with the class             |
 360 |                                        |               | OpenStackVolume then instantiates another                 |
 361 |                                        |               | OpenStackVolume object with the same configuration to     |
 362 |                                        |               | ensure the second instance returns the ID of the original |
 363 +----------------------------------------+---------------+-----------------------------------------------------------+
 364
 365 create_volume_tests.py - CreateSimpleVolumeFailureTests
 366 -------------------------------------------------------
 367
 368 +----------------------------------------+---------------+-----------------------------------------------------------+
 369 | Test Name                              |  Cinder API   | Description                                               |
 370 +========================================+===============+===========================================================+
 371 | test_create_volume_bad_size            | 2 & 3         | Tests to ensure that attempting to create a volume with a |
 372 |                                        |               | size of -1 raises a BadRequest exception                  |
 373 +----------------------------------------+---------------+-----------------------------------------------------------+
 374 | test_create_volume_bad_type            | 2 & 3         | Tests to ensure that attempting to create a volume with a |
 375 |                                        |               | type that does not exist raises a NotFound exception      |
 376 +----------------------------------------+---------------+-----------------------------------------------------------+
 377 | test_create_volume_bad_image           | 2 & 3         | Tests to ensure that attempting to create a volume with an|
 378 |                                        |               | image that does not exist raises a BadRequest exception   |
 379 +----------------------------------------+---------------+-----------------------------------------------------------+
 380 | test_create_volume_bad_zone            | 2 & 3         | Tests to ensure that attempting to create a volume with an|
 381 |                                        |               | invalid availability zone raises a BadRequest exception   |
 382 +----------------------------------------+---------------+-----------------------------------------------------------+
 383
 384 create_volume_tests.py - CreateVolumeWithTypeTests
 385 --------------------------------------------------
 386
 387 +----------------------------------------+---------------+-----------------------------------------------------------+
 388 | Test Name                              |  Cinder API   | Description                                               |
 389 +========================================+===============+===========================================================+
 390 | test_bad_volume_type                   | 2 & 3         | Tests to ensure the creation of a Volume with the         |
 391 |                                        |               | OpenStackVolume#create() method raises a NotFound         |
 392 |                                        |               | exception when attempting to apply a VolumeType that does |
 393 |                                        |               | not exist                                                 |
 394 +----------------------------------------+---------------+-----------------------------------------------------------+
 395 | test_valid_volume_type                 | 2 & 3         | Tests to ensure the creation of a Volume with the         |
 396 |                                        |               | OpenStackVolume#create() method properly creates the      |
 397 |                                        |               | volume when associating with a valid VolumeType           |
 398 +----------------------------------------+---------------+-----------------------------------------------------------+
 399
 400 create_volume_tests.py - CreateVolumeWithImageTests
 401 ---------------------------------------------------
 402
 403 +----------------------------------------+---------------+-----------------------------------------------------------+
 404 | Test Name                              |  Cinder API   | Description                                               |
 405 +========================================+===============+===========================================================+
 406 | test_bad_image_name                    | 2 & 3         | Tests to ensure the creation of a Volume with the         |
 407 |                                        |               | OpenStackVolume#create() method raises a BadRequest       |
 408 |                                        |               | exception when attempting to apply an image that does not |
 409 |                                        |               | exist                                                     |
 410 +----------------------------------------+---------------+-----------------------------------------------------------+
 411 | test_valid_volume_image                | 2 & 3         | Tests to ensure the creation of a Volume with the         |
 412 |                                        |               | OpenStackVolume#create() method properly creates the      |
 413 |                                        |               | volume when associating with a valid image                |
 414 +----------------------------------------+---------------+-----------------------------------------------------------+
 415
 416 create_stack_tests.py - CreateStackSuccessTests
 417 -----------------------------------------------
 418
 419 +---------------------------------------+---------------+-----------------------------------------------------------+
 420 | Test Name                             |   Heat API    | Description                                               |
 421 +=======================================+===============+===========================================================+
 422 | test_create_stack_template_file       | 1-3           | Ensures that a Heat stack can be created with a file-based|
 423 |                                       |               | Heat template file                                        |
 424 +---------------------------------------+---------------+-----------------------------------------------------------+
 425 | test_create_stack_template_dict       | 1-3           | Ensures that a Heat stack can be created with a dictionary|
 426 |                                       |               | Heat template                                             |
 427 +---------------------------------------+---------------+-----------------------------------------------------------+
 428 | test_create_delete_stack              | 1-3           | Ensures that a Heat stack can be created and deleted      |
 429 |                                       |               | while having clean() called 2x without an exception       |
 430 +---------------------------------------+---------------+-----------------------------------------------------------+
 431 | test_create_same_stack                | 1-3           | Ensures that a Heat stack with the same name cannot be    |
 432 |                                       |               | created 2x                                                |
 433 +---------------------------------------+---------------+-----------------------------------------------------------+
 434 | test_retrieve_network_creators        | 1-3           | Ensures that an OpenStackHeatStack instance can return an |
 435 |                                       |               | OpenStackNetwork instance configured as deployed          |
 436 +---------------------------------------+---------------+-----------------------------------------------------------+
 437 | test_retrieve_vm_inst_creators        | 1-3           | Ensures that an OpenStackHeatStack instance can return an |
 438 |                                       |               | OpenStackVmInstance instance configured as deployed       |
 439 +---------------------------------------+---------------+-----------------------------------------------------------+
 440
 441 create_stack_tests.py - CreateStackVolumeTests
 442 ----------------------------------------------
 443
 444 +---------------------------------------+---------------+-----------------------------------------------------------+
 445 | Test Name                             |   Heat API    | Description                                               |
 446 +=======================================+===============+===========================================================+
 447 | test_retrieve_volume_creator          | 1-3           | Ensures that an OpenStackHeatStack instance can return a  |
 448 |                                       |               | OpenStackVolume instance that it was responsible for      |
 449 |                                       |               | deploying                                                 |
 450 +---------------------------------------+---------------+-----------------------------------------------------------+
 451 | test_retrieve_volume_type_creator     | 1-3           | Ensures that an OpenStackHeatStack instance can return a  |
 452 |                                       |               | OpenStackVolumeType instance that it was responsible for  |
 453 |                                       |               | deploying                                                 |
 454 +---------------------------------------+---------------+-----------------------------------------------------------+
 455
 456 create_stack_tests.py - CreateStackFloatingIpTests
 457 --------------------------------------------------
 458
 459 +---------------------------------------+---------------+-----------------------------------------------------------+
 460 | Test Name                             |   Heat API    | Description                                               |
 461 +=======================================+===============+===========================================================+
 462 | test_connect_via_ssh_heat_vm          | 1             | Ensures that an OpenStackHeatStack instance can create a  |
 463 |                                       |               | VM with a floating IP that can be accessed via            |
 464 |                                       |               | OpenStackVmInstance                                       |
 465 +---------------------------------------+---------------+-----------------------------------------------------------+
 466
 467 create_stack_tests.py - CreateStackNestedResourceTests
 468 ------------------------------------------------------
 469
 470 +---------------------------------------+---------------+-----------------------------------------------------------+
 471 | Test Name                             |   Heat API    | Description                                               |
 472 +=======================================+===============+===========================================================+
 473 | test_nested                           | 1             | Ensures that an OpenStackHeatStack with an external       |
 474 |                                       |               | resource file with VMs with floating IPs can be accessed  |
 475 |                                       |               | in the class OpenStackVmInstance and return the associated|
 476 |                                       |               | initialized OpenStackVmInstance objects                   |
 477 +---------------------------------------+---------------+-----------------------------------------------------------+
 478
 479 create_stack_tests.py - CreateStackRouterTests
 480 ----------------------------------------------
 481
 482 +---------------------------------------+---------------+-----------------------------------------------------------+
 483 | Test Name                             |   Heat API    | Description                                               |
 484 +=======================================+===============+===========================================================+
 485 | test_retrieve_router_creator          | 1             | Ensures that an OpenStackHeatStack instance can return a  |
 486 |                                       |               | OpenStackRouter instance that it was responsible for      |
 487 |                                       |               | deploying                                                 |
 488 +---------------------------------------+---------------+-----------------------------------------------------------+
 489
 490 create_stack_tests.py - CreateStackFlavorTests
 491 ----------------------------------------------
 492
 493 +---------------------------------------+---------------+-----------------------------------------------------------+
 494 | Test Name                             |   Heat API    | Description                                               |
 495 +=======================================+===============+===========================================================+
 496 | test_retrieve_flavor_creator          | 1-3           | Ensures that an OpenStackHeatStack instance can return a  |
 497 |                                       |               | OpenStackFlavor instance that it was responsible for      |
 498 |                                       |               | deploying                                                 |
 499 +---------------------------------------+---------------+-----------------------------------------------------------+
 500
 501 create_stack_tests.py - CreateStackKeypairTests
 502 -----------------------------------------------
 503
 504 +---------------------------------------+---------------+-----------------------------------------------------------+
 505 | Test Name                             |   Heat API    | Description                                               |
 506 +=======================================+===============+===========================================================+
 507 | test_retrieve_keypair_creator         | 1-3           | Ensures that an OpenStackHeatStack instance can return a  |
 508 |                                       |               | OpenStackKeypair instance that it was responsible for     |
 509 |                                       |               | deploying                                                 |
 510 +---------------------------------------+---------------+-----------------------------------------------------------+
 511
 512 create_stack_tests.py - CreateStackSecurityGroupTests
 513 -----------------------------------------------------
 514
 515 +---------------------------------------+---------------+-----------------------------------------------------------+
 516 | Test Name                             |   Heat API    | Description                                               |
 517 +=======================================+===============+===========================================================+
 518 | test_retrieve_security_group_creator  | 1-3           | Ensures that an OpenStackHeatStack instance can return a  |
 519 |                                       |               | OpenStackSecurityGroup instance that it was responsible   |
 520 |                                       |               | for deploying                                             |
 521 +---------------------------------------+---------------+-----------------------------------------------------------+
 522
 523 create_stack_tests.py - CreateComplexStackTests
 524 -----------------------------------------------
 525
 526 +---------------------------------------+---------------+-----------------------------------------------------------+
 527 | Test Name                             |   Heat API    | Description                                               |
 528 +=======================================+===============+===========================================================+
 529 | test_connect_via_ssh_heat_vm          | 1-3           | Ensures that two OpenStackHeatStack instances can return  |
 530 |                                       |               | OpenStackVmInstance instances one configured with a       |
 531 |                                       |               | floating IP and keypair and can be access via SSH         |
 532 +---------------------------------------+---------------+-----------------------------------------------------------+
 533
 534 create_stack_tests.py - CreateStackNegativeTests
 535 ------------------------------------------------
 536
 537 +----------------------------------------+---------------+-----------------------------------------------------------+
 538 | Test Name                              |   Heat API    | Description                                               |
 539 +========================================+===============+===========================================================+
 540 | test_missing_dependencies              | 1-3           | Ensures that a Heat template fails to deploy when expected|
 541 |                                        |               | dependencies are missing                                  |
 542 +----------------------------------------+---------------+-----------------------------------------------------------+
 543 | test_bad_stack_file                    | 1-3           | Ensures that a Heat template fails to deploy when the Heat|
 544 |                                        |               | template file does not exist                              |
 545 +----------------------------------------+---------------+-----------------------------------------------------------+
 546
 547 create_stack_tests.py - CreateStackFailureTests
 548 -----------------------------------------------
 549
 550 +----------------------------------------+---------------+-----------------------------------------------------------+
 551 | Test Name                              |   Heat API    | Description                                               |
 552 +========================================+===============+===========================================================+
 553 | test_stack_failure                     | 1-3           | Ensures that a Heat template fails to deploy when expected|
 554 |                                        |               | dependencies are missing                                  |
 555 +----------------------------------------+---------------+-----------------------------------------------------------+
 556
 557 create_instance_tests.py - CreateInstanceSimpleTests
 558 ----------------------------------------------------
 559
 560 +---------------------------------------+---------------+-----------------------------------------------------------+
 561 | Test Name                             | API Versions  | Description                                               |
 562 +=======================================+===============+===========================================================+
 563 | test_create_delete_instance           | Nova 2        | Ensures that the OpenStackVmInstance.clean() method       |
 564 |                                       | Neutron 2     | deletes the instance                                      |
 565 +---------------------------------------+---------------+-----------------------------------------------------------+
 566
 567 create_instance_tests.py - SimpleHealthCheck
 568 --------------------------------------------
 569
 570 +---------------------------------------+---------------+-----------------------------------------------------------+
 571 | Test Name                             | API Versions  | Description                                               |
 572 +=======================================+===============+===========================================================+
 573 | test_check_vm_ip_dhcp                 | Nova 2        | Tests the creation of an OpenStack instance with a single |
 574 |                                       | Neutron 2     | port and it's assigned IP address                         |
 575 +---------------------------------------+---------------+-----------------------------------------------------------+
 576
 577 create_instance_tests.py - CreateInstanceTwoNetTests
 578 ----------------------------------------------------
 579
 580 +---------------------------------------+---------------+-----------------------------------------------------------+
 581 | Test Name                             | API Versions  | Description                                               |
 582 +=======================================+===============+===========================================================+
 583 | test_ping_via_router                  | Nova 2        | Tests the ability of two VMs on different private overlay |
 584 |                                       | Neutron 2     | networks tied together with a router to ping each other   |
 585 +---------------------------------------+---------------+-----------------------------------------------------------+
 586
 587 create_instance_tests.py - CreateInstanceSingleNetworkTests
 588 -----------------------------------------------------------
 589
 590 +---------------------------------------+---------------+-----------------------------------------------------------+
 591 | Test Name                             | API Versions  | Description                                               |
 592 +=======================================+===============+===========================================================+
 593 | test_single_port_static               | Nova 2        | Ensures that an instance with a single port/NIC with a    |
 594 |                                       | Neutron 2     | static IP can be created                                  |
 595 +---------------------------------------+---------------+-----------------------------------------------------------+
 596 | test_ssh_client_fip_before_active     | Nova 2        | Ensures that an instance can be reached over SSH when the |
 597 |                                       | Neutron 2     | floating IP is assigned prior to the VM becoming ACTIVE   |
 598 +---------------------------------------+---------------+-----------------------------------------------------------+
 599 | test_ssh_client_fip_after_active      | Nova 2        | Ensures that an instance can be reached over SSH when the |
 600 |                                       | Neutron 2     | floating IP is assigned after to the VM becoming ACTIVE   |
 601 +---------------------------------------+---------------+-----------------------------------------------------------+
 602 | test_ssh_client_fip_after_init        | Nova 2        | Ensures that an instance can have a floating IP assigned  |
 603 |                                       | Neutron 2     | added after initialization                                |
 604 +---------------------------------------+---------------+-----------------------------------------------------------+
 605 | test_ssh_client_fip_reverse_engineer  | Nova 2        | Ensures that an instance can be reverse engineered and    |
 606 |                                       | Neutron 2     | allows for a floating IP to be added after initialization |
 607 +---------------------------------------+---------------+-----------------------------------------------------------+
 608 | test_ssh_client_fip_after_reboot      | Nova 2        | Ensures that an instance can be reached over SSH after    |
 609 |                                       | Neutron 2     | a reboot call has been issued                             |
 610 +---------------------------------------+---------------+-----------------------------------------------------------+
 611 | test_ssh_client_fip_second_creator    | Nova 2        | Ensures that an instance can be reached over SSH via a    |
 612 |                                       | Neutron 2     | second identical creator object                           |
 613 +---------------------------------------+---------------+-----------------------------------------------------------+
 614
 615 create_instance_tests.py - CreateInstancePortManipulationTests
 616 --------------------------------------------------------------
 617
 618 +---------------------------------------+---------------+-----------------------------------------------------------+
 619 | Test Name                             | API Versions  | Description                                               |
 620 +=======================================+===============+===========================================================+
 621 | test_set_custom_valid_ip_one_subnet   | Nova 2        | Ensures that an instance's can have a valid static IP is  |
 622 |                                       | Neutron 2     | properly assigned                                         |
 623 +---------------------------------------+---------------+-----------------------------------------------------------+
 624 | test_set_custom_invalid_ip_one_subnet | Nova 2        | Ensures that an instance's port with an invalid static IP |
 625 |                                       | Neutron 2     | raises an exception                                       |
 626 +---------------------------------------+---------------+-----------------------------------------------------------+
 627 | test_set_custom_valid_mac             | Nova 2        | Ensures that an instance's port can have a valid MAC      |
 628 |                                       | Neutron 2     | address properly assigned                                 |
 629 +---------------------------------------+---------------+-----------------------------------------------------------+
 630 | test_set_custom_invalid_mac           | Nova 2        | Ensures that an instance's port with an invalid MAC       |
 631 |                                       | Neutron 2     | address raises and exception                              |
 632 +---------------------------------------+---------------+-----------------------------------------------------------+
 633 | test_set_custom_mac_and_ip            | Nova 2        | Ensures that an instance's port with a valid static IP and|
 634 |                                       | Neutron 2     | MAC are properly assigned                                 |
 635 +---------------------------------------+---------------+-----------------------------------------------------------+
 636 | test_set_allowed_address_pairs        | Nova 2        | Ensures the configured allowed_address_pairs is properly  |
 637 |                                       | Neutron 2     | set on a VMs port                                         |
 638 +---------------------------------------+---------------+-----------------------------------------------------------+
 639 | test_set_allowed_address_pairs_bad_mac| Nova 2        | Ensures the port cannot be created when a bad MAC address |
 640 |                                       | Neutron 2     | format is used in the allowed_address_pairs port attribute|
 641 +---------------------------------------+---------------+-----------------------------------------------------------+
 642 | test_set_allowed_address_pairs_bad_ip | Nova 2        | Ensures the port cannot be created when a bad IP address  |
 643 |                                       | Neutron 2     | format is used in the allowed_address_pairs port attribute|
 644 +---------------------------------------+---------------+-----------------------------------------------------------+
 645
 646 create_instance_tests.py - CreateInstanceOnComputeHost
 647 ------------------------------------------------------
 648
 649 +---------------------------------------+---------------+-----------------------------------------------------------+
 650 | Test Name                             | API Versions  | Description                                               |
 651 +=======================================+===============+===========================================================+
 652 | test_deploy_vm_to_each_compute_node   | Nova 2        | Tests to ensure that one can fire up an instance on each  |
 653 |                                       | Neutron 2     | active compute node                                       |
 654 +---------------------------------------+---------------+-----------------------------------------------------------+
 655
 656 create_instance_tests.py - CreateInstanceFromThreePartImage
 657 -----------------------------------------------------------
 658
 659 +-----------------------------------------------------+---------------+-----------------------------------------------------------+
 660 | Test Name                                           | API Versions  | Description                                               |
 661 +=====================================================+===============+===========================================================+
 662 | test_create_delete_instance_from_three_part_image   | Nova 2        | Tests to ensure that one can fire up an instance then     |
 663 |                                                     | Neutron 2     | delete it when using a 3-part image                       |
 664 +-----------------------------------------------------+---------------+-----------------------------------------------------------+
 665
 666 create_instance_tests.py - CreateInstanceIPv6NetworkTests (Staging)
 667 -------------------------------------------------------------------
 668
 669 +---------------------------------------+---------------+-----------------------------------------------------------+
 670 | Test Name                             | API Versions  | Description                                               |
 671 +=======================================+===============+===========================================================+
 672 | test_v4fip_v6overlay                  | Nova 2        | Expects a BadRequest exception to be raised when          |
 673 |                                       | Neutron 2     | attempting to add an IPv4 floating IP to a VM with an IPv6|
 674 |                                       |               | port                                                      |
 675 +---------------------------------------+---------------+-----------------------------------------------------------+
 676 | test_fip_v4and6_overlay               | Nova 2        | Connects to a VM via a floating IP joined to a port that  |
 677 |                                       | Neutron 2     | has been confiured with both IPv4 and IPv6 addresses      |
 678 +---------------------------------------+---------------+-----------------------------------------------------------+
 679
 680 create_instance_tests.py - InstanceSecurityGroupTests
 681 -----------------------------------------------------
 682
 683 +---------------------------------------+---------------+-----------------------------------------------------------+
 684 | Test Name                             | API Versions  | Description                                               |
 685 +=======================================+===============+===========================================================+
 686 | test_add_security_group               | Nova 2        | Ensures that a VM instance can have security group added  |
 687 |                                       | Neutron 2     | to it while its running                                   |
 688 +---------------------------------------+---------------+-----------------------------------------------------------+
 689 | test_add_invalid_security_group       | Nova 2        | Ensures that a VM instance does not accept the addition of|
 690 |                                       | Neutron 2     | a security group that no longer exists                    |
 691 +---------------------------------------+---------------+-----------------------------------------------------------+
 692 | test_remove_security_group            | Nova 2        | Ensures that a VM instance accepts the removal of a       |
 693 |                                       | Neutron 2     | security group                                            |
 694 +---------------------------------------+---------------+-----------------------------------------------------------+
 695 | test_remove_security_group_never_added| Nova 2        | Ensures that a VM instance does not accept the removal of |
 696 |                                       | Neutron 2     | a security group that was never added in the first place  |
 697 +---------------------------------------+---------------+-----------------------------------------------------------+
 698 | test_add_same_security_group          | Nova 2        | Ensures that a VM instance does not add a security group  |
 699 |                                       | Neutron 2     | that has already been added to the instance               |
 700 +---------------------------------------+---------------+-----------------------------------------------------------+
 701
 702 create_instance_tests.py - CreateInstanceVolumeTests
 703 ----------------------------------------------------
 704
 705 +---------------------------------------+---------------+-----------------------------------------------------------+
 706 | Test Name                             | API Versions  | Description                                               |
 707 +=======================================+===============+===========================================================+
 708 | test_create_instance_with_one_volume  | Nova 2        | Ensures that a VM instance can have one volume attached   |
 709 |                                       | Cinder 2 & 3  | to it                                                     |
 710 +---------------------------------------+---------------+-----------------------------------------------------------+
 711 | test_create_instance_with_two_volumes | Nova 2        | Ensures that a VM instance can have two volumes attached  |
 712 |                                       | Cinder 2 & 3  | to it                                                     |
 713 +---------------------------------------+---------------+-----------------------------------------------------------+
 714
 715 ansible_utils_tests.py - AnsibleProvisioningTests
 716 -------------------------------------------------
 717
 718 +---------------------------------------+---------------+-----------------------------------------------------------+
 719 | Test Name                             | API Versions  | Description                                               |
 720 +=======================================+===============+===========================================================+
 721 | test_apply_simple_playbook            | Nova 2        | Ensures that an instance assigned with a floating IP will |
 722 |                                       | Neutron 2     | apply a simple Ansible playbook                           |
 723 +---------------------------------------+---------------+-----------------------------------------------------------+
 724 | test_apply_template_playbook          | Nova 2        | Ensures that an instance assigned with a floating IP will |
 725 |                                       | Neutron 2     | apply a Ansible playbook containing Jinga2 substitution   |
 726 |                                       |               | values                                                    |
 727 +---------------------------------------+---------------+-----------------------------------------------------------+
 728
 729 cluster_template_tests.py - CreateClusterTemplateTests
 730 ------------------------------------------------------
 731
 732 +----------------------------------------+---------------+-----------------------------------------------------------+
 733 | Test Name                              |  Magnum API   | Description                                               |
 734 +========================================+===============+===========================================================+
 735 | test_create_cluster_template           | 1             | Tests the creation of a Cluster template with the class   |
 736 |                                        |               | OpenStackClusterTemplate                                  |
 737 +----------------------------------------+---------------+-----------------------------------------------------------+
 738 | test_create_delete_cluster_template    | 1             | Tests the creation and deletiong of a Cluster template    |
 739 |                                        |               | with the class OpenStackClusterTemplate                   |
 740 +----------------------------------------+---------------+-----------------------------------------------------------+
 741 | test_create_same_cluster_template      | 1             | Tests the creation of a Cluster template 2x using the same|
 742 |                                        |               | config object to ensure it was only created once          |
 743 +----------------------------------------+---------------+-----------------------------------------------------------+
 744 | test_create_cluster_template_bad_flavor| 1             | Tests to ensure OpenStackClusterTemplate#create() will    |
 745 |                                        |               | raise an exception when the flavor is invalid             |
 746 +----------------------------------------+---------------+-----------------------------------------------------------+
 747 | test_create_cluster_template_bad_master| 1             | Tests to ensure OpenStackClusterTemplate#create() will    |
 748 | _flavor                                |               | raise an exception when the master flavor is invalid      |
 749 +----------------------------------------+---------------+-----------------------------------------------------------+
 750 | test_create_cluster_template_bad_image | 1             | Tests to ensure OpenStackClusterTemplate#create() will    |
 751 |                                        |               | raise an exception when the image is invalid              |
 752 +----------------------------------------+---------------+-----------------------------------------------------------+
 753 | test_create_cluster_template_bad       | 1             | Tests to ensure OpenStackClusterTemplate#create() will    |
 754 | _network_driver                        |               | raise an exception when the network driver is invalid     |
 755 +----------------------------------------+---------------+-----------------------------------------------------------+
 756 | test_create_cluster_template_bad       | 1             | Tests to ensure OpenStackClusterTemplate#create() will    |
 757 | _volume_driver                         |               | raise an exception when the volume driver is invalid      |
 758 +----------------------------------------+---------------+-----------------------------------------------------------+
 759