Merge "Deprecate the "location_strategy" option"

glance/common/location_strategy/__init__.py

@@ -23,6 +23,13 @@ from glance.i18n import _, _LE
 
 location_strategy_opts = [
     cfg.StrOpt('location_strategy',
+               deprecated_for_removal=True,
+               deprecated_since="Caracal",
+               deprecated_reason=_("""
+In Bobcat, a new weighing mechanism has been introduced, which makes the
+location strategy obsolete.  This option is scheduled to be removed during the
+Dalmatian development cycle.
+"""),
                default='location_order',
                choices=('location_order', 'store_type'),
                help=_("""

glance/common/location_strategy/store_type.py

@@ -24,6 +24,13 @@ from glance.i18n import _
 store_type_opts = [
     cfg.ListOpt('store_type_preference',
                 default=[],
+                deprecated_for_removal=True,
+                deprecated_since="Caracal",
+                deprecated_reason=_("""
+In Bobcat, a new weighing mechanism has been introduced, which makes the
+location strategy obsolete.  This option is scheduled to be removed during the
+Dalmatian development cycle.
+"""),
                 help=_("""
 Preference order of storage backends.
 

releasenotes/notes/deprecate-location_strategy-f658e69700204bbf.yaml

@@ -0,0 +1,11 @@
+---
+deprecations:
+  - |
+    The Glance API configuration options ``location_strategy`` and
+    ``store_type_preference`` are deprecated in this release and are subject to
+    removal at the beginning of the Dalmatian development cycle, following the
+    `OpenStack standard deprecation policy
+    <https://governance.openstack.org/reference/tags/assert_follows-standard-deprecation.html>`_.
+
+    The weighing mechanism introduced in the Bobcat development cycle can be
+    used by operators who would like to prioritize certain stores over others.