Deprecate store_add_to_backend()

A replacement, store_add_to_backend_with_multihash(), has been
introduced in Rocky.  The old function is kept in Rocky for
backward compatability.  This deprecation notice registers our
intent to remove it in Stein.

Change-Id: If09ae10ee160e3fbfafce94e4f3607994af63ec5

1 files changed, 15 insertions, 0 deletions

diff --git a/releasenotes/notes/deprecate-store_add_to_backend-f419e5c4210613d2.yaml b/releasenotes/notes/deprecate-store_add_to_backend-f419e5c4210613d2.yaml
new file mode 100644
index 0000000..30b4998
--- /dev/null
+++ b/releasenotes/notes/deprecate-store_add_to_backend-f419e5c4210613d2.yaml
@@ -0,0 +1,15 @@
+---
+deprecations:
+  - |
+    The glance_store function ``store_add_to_backend``, which is a
+    wrapper around each store's ``add()`` method, is deprecated in this
+    release and is subject to removal at the beginning of the Stein
+    development cycle, following the `OpenStack standard deprecation policy
+    <https://governance.openstack.org/reference/tags/assert_follows-standard-deprecation.html>`_.
+
+    The function is replaced by ``store_add_to_backend_with_multihash``,
+    which is a similar wrapper, but which takes an additional argument
+    allowing a caller to specify an secure hashing algorithm.  The
+    hexdigest of this algorithm is returned as one of the multiple
+    values returned by the function.  The function also returns the
+    md5 checksum for backward compatability.