Deprecate Windows SMB share driver

This feature was added and maintained by Cloudbase as part of effort to
support Windows-only OpenStack but Winstackers project was retired and
there seems to be no on requiring this deployment architecture now.

Because the driver hasn't been get any meaningful update for some time
and we no longer have Hyper-V CI active, this proposes deprecating
the driver so that we can retire it in 2024.2 at the earliest.

[1] d9c0bda0b7

Change-Id: Icec29f5512d4c4ce8c8d7ccb1f2d3823bffa7ed9

doc/source/admin/generic_driver.rst

@@ -259,6 +259,9 @@ Windows SMB driver when Windows VMs are preferred.
 For more details, please check out the following page:
 :ref:`windows_smb_driver`.
 
+.. note::
+   This driver has been deprecated in 18.0.0 release.
+
 The :mod:`manila.share.drivers.generic` Module
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

manila/share/drivers/windows/windows_smb_driver.py

@@ -35,6 +35,8 @@ class WindowsSMBDriver(generic.GenericShareDriver):
 
     def __init__(self, *args, **kwargs):
         super(WindowsSMBDriver, self).__init__(*args, **kwargs)
+        LOG.warning('Windows SMB share driver has been deprecated and is '
+                    'expected to be removed in a future release.')
 
         self._remote_execute = winrm_helper.WinRMHelper(
             configuration=self.configuration).execute

releasenotes/notes/deprecate-windows-smb-654983cf22856e31.yaml

@@ -0,0 +1,5 @@
+---
+deprecations:
+  - |
+    The Windows SMB share driver has been deprecated and will be removed in
+    a future release.