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