Merge "Deprecate the glance-cache-{cleaner,prefetcher,pruner} commands"

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')

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')

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')

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.