openstack/nova
Code Issues Proposed changes

Deprecate nova-manage vm list command

Browse Source 
The nova-manage vm command is replaced with the nova list command
in python-novaclient, and has been for a long time.

As of microversion 2.3, the fields that are output from
nova-manage vm list are all covered in the REST API for showing server
details, which can also be used via the --fields option of the nova
list command. The nova list command also allows filtering by host.

This sets the timer for deprecation and then removal in Ocata.

Change-Id: Ibce8c3deb24a16019b721d3b91640ca342ae541b
Closes-Bug: #1494841
This commit is contained in:
Matt Riedemann
2016-07-07 16:07:53 -04:00
parent c1d7fc702a
commit 5a5b06fb24
3 changed files with 13 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
doc/source/man/nova-manage.rst
View File

@@ -162,6 +162,9 @@ Nova Images
Nova VM Nova VM
~~~~~~~~~~~ ~~~~~~~~~~~
**DEPRECATED** Use the nova list command from python-novaclient instead.
The vm subcommand will be removed in the 15.0.0 Ocata release.
``nova-manage vm list [host]`` ``nova-manage vm list [host]``
Show a list of all instances. Accepts optional hostname (to show only instances on specific host). Show a list of all instances. Accepts optional hostname (to show only instances on specific host).

6
nova/cmd/manage.py
View File

@@ -662,9 +662,13 @@ class NetworkCommands(object):
class VmCommands(object): class VmCommands(object):
"""Class for managing VM instances.""" """Class for managing VM instances."""
description = ('DEPRECATED: Use the nova list command from '
'python-novaclient instead. The vm subcommand will be '
'removed in the 15.0.0 Ocata release.')
@args('--host', metavar='<host>', help='Host') @args('--host', metavar='<host>', help='Host')
def list(self, host=None): def list(self, host=None):
"""Show a list of all instances.""" """DEPRECATED: Show a list of all instances."""
print(("%-10s %-15s %-10s %-10s %-26s %-9s %-9s %-9s" print(("%-10s %-15s %-10s %-10s %-26s %-9s %-9s %-9s"
" %-10s %-10s %-10s %-5s" % (_('instance'), " %-10s %-10s %-10s %-5s" % (_('instance'),

5
releasenotes/notes/deprecate-nova-manage-vm-list-571162f55173cccc.yaml Normal file
View File

@@ -0,0 +1,5 @@
---
deprecations:
- The ``nova-manage vm list`` command is deprecated and will be removed in
the 15.0.0 Ocata release. Use the ``nova list`` command from
python-novaclient instead.