From cf90ebf53862dc653b840789ef89d230bb0f35f4 Mon Sep 17 00:00:00 2001
From: Cyril Roelandt <cyril@redhat.com>
Date: Wed, 30 Oct 2024 16:49:59 +0100
Subject: [PATCH] Deprecate the glance-cache-{cleaner,prefetcher,pruner}
 commands

Change-Id: I9b8b387f62ceac45846194cd0b62ee6331b77c04
---
 glance/cmd/cache_cleaner.py                              | 4 ++++
 glance/cmd/cache_prefetcher.py                           | 4 ++++
 glance/cmd/cache_pruner.py                               | 4 ++++
 .../deprecate-glance-cache-tools-8498bfe8d4edd2b2.yaml   | 9 +++++++++
 4 files changed, 21 insertions(+)
 create mode 100644 releasenotes/notes/deprecate-glance-cache-tools-8498bfe8d4edd2b2.yaml

diff --git a/glance/cmd/cache_cleaner.py b/glance/cmd/cache_cleaner.py
index 7ea7778449..62071c6018 100644
--- a/glance/cmd/cache_cleaner.py
+++ b/glance/cmd/cache_cleaner.py
@@ -51,6 +51,10 @@ CONF.set_default(name='use_stderr', default=True)
 
 
 def main():
+    print('The Glance cache cleaner has been deprecated since the Epoxy '
+          '(2025.1) release. It will be removed in the G (2026.1) release. '
+          'The Cache API should be used instead.',
+          file=sys.stderr)
     try:
         config.parse_cache_args()
         logging.setup(CONF, 'glance')
diff --git a/glance/cmd/cache_prefetcher.py b/glance/cmd/cache_prefetcher.py
index f6e35e8086..b553e92a88 100644
--- a/glance/cmd/cache_prefetcher.py
+++ b/glance/cmd/cache_prefetcher.py
@@ -46,6 +46,10 @@ CONF.set_default(name='use_stderr', default=True)
 
 
 def main():
+    print('The Glance cache prefetcher has been deprecated since the Epoxy '
+          '(2025.1) release. It will be removed in the G (2026.1) release. '
+          'The Cache API should be used instead.',
+          file=sys.stderr)
     try:
         config.parse_cache_args()
         logging.setup(CONF, 'glance')
diff --git a/glance/cmd/cache_pruner.py b/glance/cmd/cache_pruner.py
index 45d1bc9627..93c67b5e46 100644
--- a/glance/cmd/cache_pruner.py
+++ b/glance/cmd/cache_pruner.py
@@ -43,6 +43,10 @@ CONF.set_default(name='use_stderr', default=True)
 
 
 def main():
+    print('The Glance cache pruner has been deprecated since the Epoxy '
+          '(2025.1) release. It will be removed in the G (2026.1) release. '
+          'The Cache API should be used instead.',
+          file=sys.stderr)
     try:
         config.parse_cache_args()
         logging.setup(CONF, 'glance')
diff --git a/releasenotes/notes/deprecate-glance-cache-tools-8498bfe8d4edd2b2.yaml b/releasenotes/notes/deprecate-glance-cache-tools-8498bfe8d4edd2b2.yaml
new file mode 100644
index 0000000000..832dc51dcf
--- /dev/null
+++ b/releasenotes/notes/deprecate-glance-cache-tools-8498bfe8d4edd2b2.yaml
@@ -0,0 +1,9 @@
+---
+deprecations:
+  - |
+    The glance-cache-cleaner, glance-cache-prefetcher and glance-cache-pruner
+    commands are deprecated in the 2025.1 release (Epoxy) and are subject to
+    removal at the beginning of the 2026.1 (G) development cycle, following
+    the `OpenStack standard deprecation policy
+    <https://governance.openstack.org/reference/tags/assert_follows-standard-deprecation.html>`_.
+    The Cache API should be used instead.