Merge "nova-manage: Deprecate 'agent' commands"

nova/cmd/manage.py

@@ -823,6 +823,11 @@ class ApiDbCommands(object):
 class AgentBuildCommands(object):
     """Class for managing agent builds."""
 
+    # TODO(stephenfin): Remove this during the Queens cycle
+    description = ('DEPRECATED: The agent commands are deprecated since '
+                   'Pike as this information is available over the API. They '
+                   'will be removed in an upcoming release.')
+
     @args('--os', metavar='<os>', help='os')
     @args('--architecture', dest='architecture',
             metavar='<architecture>', help='architecture')

releasenotes/notes/deprecate-nova-manage-commands-9de1abbc94e06d16.yaml

@@ -4,6 +4,12 @@ deprecations:
     A number of `nova-manage` commands have been deprecated. The commands,
     along with the reasons for their deprecation, are listed below:
 
+    `agent`
+
+      This allows for the creation, deletion, update and listing of "agent
+      builds". Operators should use the equivalent resources in the `REST
+      API`__ instead.
+
     `shell`
 
       This starts the Python interactive interpreter. It is a clone of the same
@@ -12,3 +18,5 @@ deprecations:
       simply be removed.
 
     These commands will be removed in their entirety during the Queens cycle.
+
+    __ https://developer.openstack.org/api-ref/compute/#guest-agents-os-agents