v16.1.0 Release Notes

16.1.0 Release Notes

16.1.0

Prelude

This is an intermediate release during the Pike development cycle to make new functionality available to plugins and other consumers.

New Features

  • Add a new client to handle the OAUTH token feature from the identity API.

  • A new boolean config option serial_console is added to the section compute-feature-enabled. If enabled, tests, which validate the behavior of Nova’s serial console feature (an alternative to VNC, RDP, SPICE) can be executed.

  • Add a new client to handle the domain configuration feature from the identity v3 API.

  • A new config option in the network-feature-enabled section, floating_ips, to specify whether floating ips are available in the cloud under test. By default this is set to True.

  • Add force detach volume feature API to v2 volumes_client library. This feature enables the possibility to force a volume to detach, and roll back an unsuccessful detach operation after you disconnect the volume.

  • Defines the identity v3 OS-EP-FILTER EndPoint Groups API client. This client manages Create, Get, Update, Check, List, and Delete of EndPoint Group.

  • Defines the identity v3 OS-EP-FILTER extension API client. This client manages associations between endpoints, projects along with groups.

  • The delete_volume method of the VolumesClient class now has an additional **params argument that enables passing additional information in the query string of the HTTP request.

  • Add list volume transfers with details API to v2 transfers_client library. This feature enables the possibility to list volume transfers with details.

  • A new config option ‘manage_snapshot_ref’ is added in the volume section, to specify snapshot ref parameter for different storage backend drivers when managing an existing snapshot. By default it is set to fit the LVM driver.

  • The list_endpoints method of the v3 EndPointsClient class now has an additional **params argument that enables passing additional information in the query string of the HTTP request.

  • Add --save-state option to allow saving state of cloud before tempest run.

  • Add validation schema for Nova server diagnostics API

  • Add show host API to the volume v2 hosts_client library. This feature enables the possibility to show details for a host.

  • Add show snapshot metadata item API to v2 snapshots_client library. This feature enables the possibility to show a snapshot’s metadata for a specific key.

  • Add show volume metadata item API to v2 volumes_client library. This feature enables the possibility to show a volume’s metadata for a specific key.

  • Define v3 volumes_client for the volume service as a library interface, allowing other projects to use this module as a stable library without maintenance changes. Add show volume summary API to v3 volumes_client library, min_microversion of this API is 3.12.

    • volumes_client(v3)

  • Define v3 backups_client for the volume service as a library interface, allowing other projects to use this module as a stable library without maintenance changes. Add update backup API to v3 backups_client library, min_microversion of this API is 3.9.

    • backups_client(v3)

  • Add groups and group_types clients for the volume service as library. Add tempest tests for create group, delete group, show group, and list group volume APIs.

  • Define v2 quota_classes_client for the volume service as library interfaces, allowing other projects to use this module as stable libraries without maintenance changes.

    • quota_classes_client(v2)

  • A new configuration flag api_v2_admin is introduced in the identity feature flag group to allow for enabling/disabling all identity v2 admin tests. The new flag only applies when the existing api_v2 flag is set to True

  • Add additional API endpoints to the identity v2 client token API: - list_endpoints_for_token - check_token_existence

  • A new attr decorator has been added in the tempest.lib.decorators module. For example, use it to tag specific tests, which could be leveraged by test runners to run only a subset of Tempest tests.

  • A new related_bug decorator has been added to tempest.lib.decorators. Use it to decorate and tag a test that was added in relation to a launchpad bug report.

  • Move base_client from tempest.lib.services.volume.v3 to tempest.lib.services.volume, so if we want to add new interfaces based on a v2 client, we can make that v2 client inherit from volume.base_client.BaseClient to get microversion support, and then to make the new v3 client inherit from the v2 client, thus to avoid the multiple inheritance.

  • Define v2.0 tags_client for the network service as a library interface, allowing other projects to use this module as a stable library without maintenance changes.

    • tags_client(v2.0)

  • Pause teardown When pause_teardown flag in tempest.conf is set to True a pdb breakpoint is added to tearDown and tearDownClass methods in test.py. This allows to pause cleaning resources process, so that used resources can be examined. Closer examination of used resources may lead to faster debugging.

  • Added tempest workspace remove --name <workspace_name> --rmdir feature to delete the workspace directory as well as entry.

Upgrade Notes

  • Switch to use Glance v2 APIs in volume tests, by adding the Glance v2 client images_client.

  • The Heat API tests have been removed from tempest, they were unmaintained. The future direction of api test for heat is their in-tree Gabbi tests

  • The volume config option ‘api_v3’ default is changed to True because the volume v3 API is CURRENT.

  • verify_tempest_config command starts using extension_client of cinder v2 API only, because cinder v3 API is current and v2 and v1 are deprecated and v3 extension API is the same as v2. Then we can reuse the v2 client for v3 API also.

Deprecation Notes

  • Image APIs in compute are deprecated, Image native APIs are recommended. And Glance v1 APIs are deprecated and v2 APIs are current. Image client compute_images_client and Glance v1 APIs are removed in volume tests.

  • The config option forbid_global_implied_dsr from the IdentityFeature group is now deprecated. This feature flag was introduced to support testing of old OpenStack versions which are not supported anymore.

  • Deprecate default value for configuration parameter v3_endpoint_type of identity section in OpenStack Pike and modify the default value to publicURL in OpenStack Q release.

  • Deprecate class BaseClient from volume.v3.base_client and move it to volume.base_client. tempest.lib.services.volume.v3.base_client.BaseClient (new tempest.lib.services.volume.base_client.BaseClient)

Bug Fixes

  • When receiving nullable list as a response body, tempest.lib rest_client module raised an exception without valid json deserialization. A new release fixes this bug.