Open Stack

We are delighted to announce the release of:

python-manilaclient 4.1.0: Client library for OpenStack Manila API.

This release is part of the zed release series.

The source is available from:

    https://opendev.org/openstack/python-manilaclient

Download the package from:

    https://pypi.org/project/python-manilaclient

Please report issues through:

    https://bugs.launchpad.net/python-manilaclient/+bugs

For more details, please see below.

4.1.0
^^^^^


Prelude
*******

The manilaclient repository now includes a plugin to openstackclient.
You can use the "openstack share .." command line interface to
administer the Shared File System service (manila) on any deployment
alongside using it to provision and manage the life cycle of manila
resources. Refer to the official documentation
(https://docs.openstack.org/python-
manilaclient/latest/cli/osc_plugin_cli.html) to find command syntax
and usage information. You may also view this documentation directly
in the CLI with "openstack help share <subcommand>". For example,
"openstack help share create".


New Features
************

* The command *share-network-subnet-create-check* was added. This
  command will check if the share network subnet can be created in a
  specific share network based on the cloud support. The OSC
  equivalent command is also added, run the subnet create with the new
  option --check-only.


Upgrade Notes
*************

* With the introduction of the openstackclient integration, we are
  also announcing our intent to deprecate the "manila" shell commands.
  These clients will emit a deprecation warning in a future release,
  and will eventually be removed. We recommend that you transition
  your workflows and tooling to use the "openstack" CLI when using the
  Shared File Systems service (manila) commands. The "manilaclient"
  SDK is unaffected by the introducion of OpenStackClient.


Bug Fixes
*********

* Launchpad bug 1909477 (https://bugs.launchpad.net/python-
  manilaclient/+bug/1909477) has been fixed by prevent sending the
  share creation request with any capitalization of the name "None".

* Bug #1925486 (https://bugs.launchpad.net/manila/+bug/1925486)
  Share replica create command does not support share network option
  and manila internally uses parent share's share network. Fixed it to
  allow any share network by providing option "share-network" starting
  with microversion '2.72'.

* Launchpad bug 1959329 (https://bugs.launchpad.net/python-
  manilaclient/+bug/1959329) has been fixed for share server listing
  with network subnet id.

* When creating a share from snapshot with 'openstack share create',
  the client no longer forces the use of a share type. See bug
  #1980985 (https://launchpad.net/bugs/1980985) for more information.


Other Notes
***********

* The "openstack share .." CLI is usable only with the "v2" API. At
  this time, we have no plans to support its use with the deprecated
  "v1" API provided by the Shared File System service (manila).

* The "openstack share .." CLI does not yet support API microversion
  negotiation. This means that to use this release of the
  OpenStackClient with older Shared File System API service, users
  would have to set the API version in their environments. This can be
  done via cloud config (specify "shared_file_system_api_version") or
  via shell environment "OS_SHARE_API_VERSION" or via the CLI
  overrride: "--os-share-api-version". Without this override, the
  client will use a hard-coded API version
  (https://opendev.org/openstack/python-
  manilaclient/src/branch/stable/zed/manilaclient/api_versions.py#L30)
  to make API requests and this may fail in your deployment if the
  version is unsupported.

Changes in python-manilaclient 4.0.0..4.1.0
-------------------------------------------

09ab2c3 [OSC] Implement Share Server  Migration set task-state
586c603 Support multiple subnets per AZ
bb1a957 [OSC] Implement Share Server  Migration check
67ebf68 Make the OSC plugin handle the --insecure flag
db1bba7 Add 'share-network' option for share replica create.
a9172c1 [reno] Announce openstackclient GA
dfb3f07 Fixes minor typos and removes redundants lines.
20638a5 [OSC] Implement Share Server  Migration Start Command
35be44a [OSC] Implement Share Server  Migration Show Command
8f53399 [OSC] Implement Share Restore Command
5c5220b [OSC] Implement Share Server Migration Cancel and Complete Command
617a93d requirements: Bump python-openstackclient version
e93f3c2 Ensures API microversion is greater than  or equal to '2.69'
963ac40 Add share group type functional tests for OSC
5f56bff requirements: Add stestr
06f7ea6 [OSC] Don't use default type with snapshot clones
992a942 Fix missing space before end quote
51154c4 [OSC] Fix typos in help messages for security services command
df9af53 [OSC] Add OSC Functional Tests Export Location
8fedd08 [OSC] Implement Share Migration show and add argument to Share Set Command
79d1f1c Python3.11: fix unit test crashes
17d5609 [OSC] Add functional tests for share snapshots
4f7724c Add support for --soft when deleting a share or more shares
8873dc2 [OSC] Implement security services commands
27a8a06 Add functional tests for group type access
f3eea6b [OSC] Add OSC Functional Tests Replica Export Location
dc918e5 [OSC] Implement Share Server Commands
1597bf6 Avoid any capitalization of the name "None"
27b8830 Fix share server listing with network subnet id
301274d [OSC] Implement Share Group Snapshot Commands
64eefb9 [OSC] Add OSC Functional Tests Network
2f11d14 Fix incompatible headers on OS share group type list
eeece58 fix manager _list() method when called from another manager


Diffstat (except docs and test files)
-------------------------------------

manilaclient/api_versions.py                       |   2 +-
manilaclient/base.py                               |  14 +-
manilaclient/osc/plugin.py                         |   3 +-
manilaclient/osc/v2/security_services.py           | 501 +++++++++++++
manilaclient/osc/v2/share.py                       | 129 +++-
manilaclient/osc/v2/share_group_snapshots.py       | 442 ++++++++++++
manilaclient/osc/v2/share_group_types.py           |   3 +-
manilaclient/osc/v2/share_network_subnets.py       |  53 +-
manilaclient/osc/v2/share_replicas.py              |  18 +
manilaclient/osc/v2/share_servers.py               | 638 +++++++++++++++++
manilaclient/osc/v2/share_snapshots.py             |  10 +-
.../functional/osc/test_share_group_type_access.py |  88 +++
.../functional/osc/test_share_network_subnets.py   |  37 +
.../osc/test_share_replica_export_locations.py     |  59 ++
.../unit/osc/v2/test_share_group_snapshots.py      | 671 ++++++++++++++++++
.../unit/osc/v2/test_share_network_subnets.py      |  58 ++
manilaclient/v2/share_networks.py                  |  27 +
manilaclient/v2/share_replicas.py                  |  18 +-
manilaclient/v2/shares.py                          |   2 +-
manilaclient/v2/shell.py                           | 140 +++-
...rt_multiple_subnet_per_az-46145c3e90e097be.yaml |   6 +
...shares-with-the-name-none-cfb0a59baa597803.yaml |   6 +
...ion-to-replica-create-api-7d2ff3628e93fc77.yaml |   8 +
...server-listing-by-subnets-fa6447fd43093cae.yaml |   4 +
...re-type-with-snapshot-ref-de0331c640afbbd3.yaml |   6 +
.../manila-openstackclient-bf61ceb270d3afb7.yaml   |  37 +
setup.cfg                                          |  25 +
test-requirements.txt                              |  14 +-
51 files changed, 5583 insertions(+), 88 deletions(-)


Requirements updates
--------------------

diff --git a/test-requirements.txt b/test-requirements.txt
index d1d9c3f..6a9d952 100644
--- a/test-requirements.txt
+++ b/test-requirements.txt
@@ -1,5 +0,0 @@
-# The order of packages is significant, because pip processes them in the order
-# of appearance. Changing the order has an impact on the overall integration
-# process, which may cause wedges in the gate later.
-
-# hacking should be first
@@ -11,5 +6 @@ fixtures>=3.0.0 # Apache-2.0/BSD
-# Can be removed in Victoria cycle, when we raise the requirement of
-# python-openstackclient in this file to a version that no longer
-# requires mock. See: https://review.opendev.org/717410/
-mock>=2.0.0 # BSD
-os-testr>=1.0.0 # Apache-2.0
+stestr>=2.0.0 # Apache-2.0
@@ -18,2 +9 @@ testtools>=2.2.0 # MIT
-python-openstackclient>=3.12.0 # Apache-2.0
-
+python-openstackclient>=5.3.0 # Apache-2.0