Deprecate support for glance v1

Nova dropped support for glance v1 in Ocata and we're going
to disable glance v1 in CI runs for Pike. The glance v1
API is deprecated so we should start burning it out of the
system in all of the projects.

Closes-Bug: #1670423

Change-Id: I1398f81b28e1b000ee110c159e498b72e3746109

etc/ironic/ironic.conf.sample

@@ -1434,9 +1434,14 @@
 # [hostname|IP]:port. (list value)
 #glance_api_servers = <None>
 
-# Glance API version (1 or 2) to use. (integer value)
+# DEPRECATED: Glance API version (1 or 2) to use. (integer
+# value)
 # Minimum value: 1
 # Maximum value: 2
+# This option is deprecated for removal.
+# Its value may be silently ignored in the future.
+# Reason: Ironic will only support using Glance API version 2
+# in the Queens release.
 #glance_api_version = 2
 
 # Optional path to a CA certificate bundle to be used to

ironic/conf/glance.py

@@ -143,7 +143,10 @@ opts = [
                       'used when glance_api_insecure is set to False.')),
     cfg.IntOpt('glance_api_version',
                help=_('Glance API version (1 or 2) to use.'),
-               min=1, max=2, default=2),
+               min=1, max=2, default=2,
+               deprecated_for_removal=True,
+               deprecated_reason=_('Ironic will only support using Glance API '
+                                   'version 2 in the Queens release.')),
 ]
 
 

releasenotes/notes/deprecate-support-for-glance-v1-8b194e6b20cbfebb.yaml

@@ -0,0 +1,6 @@
+---
+deprecations:
+  - |
+    Support for the Image service v1 API has been deprecated along with the
+    ``[glance]/glance_api_version`` configuration option and will be removed in
+    the `Queens` release.