From a9172c1fa314d30044f53e89bc0b1dc450a6a0a3 Mon Sep 17 00:00:00 2001 From: Goutham Pacha Ravi Date: Tue, 30 Aug 2022 18:56:59 -0800 Subject: [PATCH] [reno] Announce openstackclient GA and the future deprecation of the "manila" shell as users know it. Partially-Implements: bp/openstack-client-support Change-Id: I110b66df43916254ec54345cb675bd6f42f2f03b Signed-off-by: Goutham Pacha Ravi --- ...nila-openstackclient-bf61ceb270d3afb7.yaml | 37 +++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 releasenotes/notes/manila-openstackclient-bf61ceb270d3afb7.yaml diff --git a/releasenotes/notes/manila-openstackclient-bf61ceb270d3afb7.yaml b/releasenotes/notes/manila-openstackclient-bf61ceb270d3afb7.yaml new file mode 100644 index 000000000..92e02b5fe --- /dev/null +++ b/releasenotes/notes/manila-openstackclient-bf61ceb270d3afb7.yaml @@ -0,0 +1,37 @@ +--- +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 `_ to find command + syntax and usage information. You may also view this documentation + directly in the CLI with ``openstack help share ``. For + example, ``openstack help share create``. +upgrade: + - | + 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. +other: + - | + 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 `_ to make API requests and this may fail in + your deployment if the version is unsupported.