1047 lines
47 KiB
Python
1047 lines
47 KiB
Python
# Copyright 2013 Red Hat, Inc.
|
|
# Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
# not use this file except in compliance with the License. You may obtain
|
|
# a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
# License for the specific language governing permissions and limitations
|
|
# under the License.
|
|
|
|
"""
|
|
Client side of the compute RPC API.
|
|
"""
|
|
|
|
from oslo_config import cfg
|
|
from oslo_log import log as logging
|
|
import oslo_messaging as messaging
|
|
from oslo_serialization import jsonutils
|
|
|
|
from nova import context
|
|
from nova import exception
|
|
from nova.i18n import _, _LI, _LE
|
|
from nova import objects
|
|
from nova.objects import base as objects_base
|
|
from nova.objects import migrate_data as migrate_data_obj
|
|
from nova.objects import service as service_obj
|
|
from nova import rpc
|
|
|
|
rpcapi_opts = [
|
|
cfg.StrOpt('compute_topic',
|
|
default='compute',
|
|
help='The topic compute nodes listen on'),
|
|
]
|
|
|
|
CONF = cfg.CONF
|
|
CONF.register_opts(rpcapi_opts)
|
|
|
|
rpcapi_cap_opt = cfg.StrOpt('compute',
|
|
help='Set a version cap for messages sent to compute services. '
|
|
'Set this option to "auto" if you want to let the compute RPC '
|
|
'module automatically determine what version to use based on '
|
|
'the service versions in the deployment. '
|
|
'Otherwise, you can set this to a specific version to pin this '
|
|
'service to messages at a particular level. '
|
|
'All services of a single type (i.e. compute) should be '
|
|
'configured to use the same version, and it should be set '
|
|
'to the minimum commonly-supported version of all those '
|
|
'services in the deployment.')
|
|
|
|
|
|
CONF.register_opt(rpcapi_cap_opt, 'upgrade_levels')
|
|
|
|
LOG = logging.getLogger(__name__)
|
|
LAST_VERSION = None
|
|
|
|
|
|
def _compute_host(host, instance):
|
|
'''Get the destination host for a message.
|
|
|
|
:param host: explicit host to send the message to.
|
|
:param instance: If an explicit host was not specified, use
|
|
instance['host']
|
|
|
|
:returns: A host
|
|
'''
|
|
if host:
|
|
return host
|
|
if not instance:
|
|
raise exception.NovaException(_('No compute host specified'))
|
|
if not instance.host:
|
|
raise exception.NovaException(_('Unable to find host for '
|
|
'Instance %s') % instance.uuid)
|
|
return instance.host
|
|
|
|
|
|
class ComputeAPI(object):
|
|
'''Client side of the compute rpc API.
|
|
|
|
API version history:
|
|
|
|
* 1.0 - Initial version.
|
|
* 1.1 - Adds get_host_uptime()
|
|
* 1.2 - Adds check_can_live_migrate_[destination|source]
|
|
* 1.3 - Adds change_instance_metadata()
|
|
* 1.4 - Remove instance_uuid, add instance argument to
|
|
reboot_instance()
|
|
* 1.5 - Remove instance_uuid, add instance argument to
|
|
pause_instance(), unpause_instance()
|
|
* 1.6 - Remove instance_uuid, add instance argument to
|
|
suspend_instance()
|
|
* 1.7 - Remove instance_uuid, add instance argument to
|
|
get_console_output()
|
|
* 1.8 - Remove instance_uuid, add instance argument to
|
|
add_fixed_ip_to_instance()
|
|
* 1.9 - Remove instance_uuid, add instance argument to attach_volume()
|
|
* 1.10 - Remove instance_id, add instance argument to
|
|
check_can_live_migrate_destination()
|
|
* 1.11 - Remove instance_id, add instance argument to
|
|
check_can_live_migrate_source()
|
|
* 1.12 - Remove instance_uuid, add instance argument to
|
|
confirm_resize()
|
|
* 1.13 - Remove instance_uuid, add instance argument to detach_volume()
|
|
* 1.14 - Remove instance_uuid, add instance argument to finish_resize()
|
|
* 1.15 - Remove instance_uuid, add instance argument to
|
|
finish_revert_resize()
|
|
* 1.16 - Remove instance_uuid, add instance argument to
|
|
get_diagnostics()
|
|
* 1.17 - Remove instance_uuid, add instance argument to
|
|
get_vnc_console()
|
|
* 1.18 - Remove instance_uuid, add instance argument to inject_file()
|
|
* 1.19 - Remove instance_uuid, add instance argument to
|
|
inject_network_info()
|
|
* 1.20 - Remove instance_id, add instance argument to
|
|
post_live_migration_at_destination()
|
|
* 1.21 - Remove instance_uuid, add instance argument to
|
|
power_off_instance() and stop_instance()
|
|
* 1.22 - Remove instance_uuid, add instance argument to
|
|
power_on_instance() and start_instance()
|
|
* 1.23 - Remove instance_id, add instance argument to
|
|
pre_live_migration()
|
|
* 1.24 - Remove instance_uuid, add instance argument to
|
|
rebuild_instance()
|
|
* 1.25 - Remove instance_uuid, add instance argument to
|
|
remove_fixed_ip_from_instance()
|
|
* 1.26 - Remove instance_id, add instance argument to
|
|
remove_volume_connection()
|
|
* 1.27 - Remove instance_uuid, add instance argument to
|
|
rescue_instance()
|
|
* 1.28 - Remove instance_uuid, add instance argument to reset_network()
|
|
* 1.29 - Remove instance_uuid, add instance argument to
|
|
resize_instance()
|
|
* 1.30 - Remove instance_uuid, add instance argument to
|
|
resume_instance()
|
|
* 1.31 - Remove instance_uuid, add instance argument to revert_resize()
|
|
* 1.32 - Remove instance_id, add instance argument to
|
|
rollback_live_migration_at_destination()
|
|
* 1.33 - Remove instance_uuid, add instance argument to
|
|
set_admin_password()
|
|
* 1.34 - Remove instance_uuid, add instance argument to
|
|
snapshot_instance()
|
|
* 1.35 - Remove instance_uuid, add instance argument to
|
|
unrescue_instance()
|
|
* 1.36 - Remove instance_uuid, add instance argument to
|
|
change_instance_metadata()
|
|
* 1.37 - Remove instance_uuid, add instance argument to
|
|
terminate_instance()
|
|
* 1.38 - Changes to prep_resize():
|
|
* remove instance_uuid, add instance
|
|
* remove instance_type_id, add instance_type
|
|
* remove topic, it was unused
|
|
* 1.39 - Remove instance_uuid, add instance argument to run_instance()
|
|
* 1.40 - Remove instance_id, add instance argument to live_migration()
|
|
* 1.41 - Adds refresh_instance_security_rules()
|
|
* 1.42 - Add reservations arg to prep_resize(), resize_instance(),
|
|
finish_resize(), confirm_resize(), revert_resize() and
|
|
finish_revert_resize()
|
|
* 1.43 - Add migrate_data to live_migration()
|
|
* 1.44 - Adds reserve_block_device_name()
|
|
|
|
* 2.0 - Remove 1.x backwards compat
|
|
* 2.1 - Adds orig_sys_metadata to rebuild_instance()
|
|
* 2.2 - Adds slave_info parameter to add_aggregate_host() and
|
|
remove_aggregate_host()
|
|
* 2.3 - Adds volume_id to reserve_block_device_name()
|
|
* 2.4 - Add bdms to terminate_instance
|
|
* 2.5 - Add block device and network info to reboot_instance
|
|
* 2.6 - Remove migration_id, add migration to resize_instance
|
|
* 2.7 - Remove migration_id, add migration to confirm_resize
|
|
* 2.8 - Remove migration_id, add migration to finish_resize
|
|
* 2.9 - Add publish_service_capabilities()
|
|
* 2.10 - Adds filter_properties and request_spec to prep_resize()
|
|
* 2.11 - Adds soft_delete_instance() and restore_instance()
|
|
* 2.12 - Remove migration_id, add migration to revert_resize
|
|
* 2.13 - Remove migration_id, add migration to finish_revert_resize
|
|
* 2.14 - Remove aggregate_id, add aggregate to add_aggregate_host
|
|
* 2.15 - Remove aggregate_id, add aggregate to remove_aggregate_host
|
|
* 2.16 - Add instance_type to resize_instance
|
|
* 2.17 - Add get_backdoor_port()
|
|
* 2.18 - Add bdms to rebuild_instance
|
|
* 2.19 - Add node to run_instance
|
|
* 2.20 - Add node to prep_resize
|
|
* 2.21 - Add migrate_data dict param to pre_live_migration()
|
|
* 2.22 - Add recreate, on_shared_storage and host arguments to
|
|
rebuild_instance()
|
|
* 2.23 - Remove network_info from reboot_instance
|
|
* 2.24 - Added get_spice_console method
|
|
* 2.25 - Add attach_interface() and detach_interface()
|
|
* 2.26 - Add validate_console_port to ensure the service connects to
|
|
vnc on the correct port
|
|
* 2.27 - Adds 'reservations' to terminate_instance() and
|
|
soft_delete_instance()
|
|
|
|
... Grizzly supports message version 2.27. So, any changes to existing
|
|
methods in 2.x after that point should be done such that they can
|
|
handle the version_cap being set to 2.27.
|
|
|
|
* 2.28 - Adds check_instance_shared_storage()
|
|
* 2.29 - Made start_instance() and stop_instance() take new-world
|
|
instance objects
|
|
* 2.30 - Adds live_snapshot_instance()
|
|
* 2.31 - Adds shelve_instance(), shelve_offload_instance, and
|
|
unshelve_instance()
|
|
* 2.32 - Make reboot_instance take a new world instance object
|
|
* 2.33 - Made suspend_instance() and resume_instance() take new-world
|
|
instance objects
|
|
* 2.34 - Added swap_volume()
|
|
* 2.35 - Made terminate_instance() and soft_delete_instance() take
|
|
new-world instance objects
|
|
* 2.36 - Made pause_instance() and unpause_instance() take new-world
|
|
instance objects
|
|
* 2.37 - Added the legacy_bdm_in_spec parameter to run_instance
|
|
* 2.38 - Made check_can_live_migrate_[destination|source] take
|
|
new-world instance objects
|
|
* 2.39 - Made revert_resize() and confirm_resize() take new-world
|
|
instance objects
|
|
* 2.40 - Made reset_network() take new-world instance object
|
|
* 2.41 - Make inject_network_info take new-world instance object
|
|
* 2.42 - Splits snapshot_instance() into snapshot_instance() and
|
|
backup_instance() and makes them take new-world instance
|
|
objects.
|
|
* 2.43 - Made prep_resize() take new-world instance object
|
|
* 2.44 - Add volume_snapshot_create(), volume_snapshot_delete()
|
|
* 2.45 - Made resize_instance() take new-world objects
|
|
* 2.46 - Made finish_resize() take new-world objects
|
|
* 2.47 - Made finish_revert_resize() take new-world objects
|
|
|
|
... Havana supports message version 2.47. So, any changes to existing
|
|
methods in 2.x after that point should be done such that they can
|
|
handle the version_cap being set to 2.47.
|
|
|
|
* 2.48 - Make add_aggregate_host() and remove_aggregate_host() take
|
|
new-world objects
|
|
* ... - Remove live_snapshot() that was never actually used
|
|
|
|
* 3.0 - Remove 2.x compatibility
|
|
* 3.1 - Update get_spice_console() to take an instance object
|
|
* 3.2 - Update get_vnc_console() to take an instance object
|
|
* 3.3 - Update validate_console_port() to take an instance object
|
|
* 3.4 - Update rebuild_instance() to take an instance object
|
|
* 3.5 - Pass preserve_ephemeral flag to rebuild_instance()
|
|
* 3.6 - Make volume_snapshot_{create,delete} use new-world objects
|
|
* 3.7 - Update change_instance_metadata() to take an instance object
|
|
* 3.8 - Update set_admin_password() to take an instance object
|
|
* 3.9 - Update rescue_instance() to take an instance object
|
|
* 3.10 - Added get_rdp_console method
|
|
* 3.11 - Update unrescue_instance() to take an object
|
|
* 3.12 - Update add_fixed_ip_to_instance() to take an object
|
|
* 3.13 - Update remove_fixed_ip_from_instance() to take an object
|
|
* 3.14 - Update post_live_migration_at_destination() to take an object
|
|
* 3.15 - Adds filter_properties and node to unshelve_instance()
|
|
* 3.16 - Make reserve_block_device_name and attach_volume use new-world
|
|
objects, and add disk_bus and device_type params to
|
|
reserve_block_device_name, and bdm param to attach_volume
|
|
* 3.17 - Update attach_interface and detach_interface to take an object
|
|
* 3.18 - Update get_diagnostics() to take an instance object
|
|
* Removed inject_file(), as it was unused.
|
|
* 3.19 - Update pre_live_migration to take instance object
|
|
* 3.20 - Make restore_instance take an instance object
|
|
* 3.21 - Made rebuild take new-world BDM objects
|
|
* 3.22 - Made terminate_instance take new-world BDM objects
|
|
* 3.23 - Added external_instance_event()
|
|
* build_and_run_instance was added in Havana and not used or
|
|
documented.
|
|
|
|
... Icehouse supports message version 3.23. So, any changes to
|
|
existing methods in 3.x after that point should be done such that they
|
|
can handle the version_cap being set to 3.23.
|
|
|
|
* 3.24 - Update rescue_instance() to take optional rescue_image_ref
|
|
* 3.25 - Make detach_volume take an object
|
|
* 3.26 - Make live_migration() and
|
|
rollback_live_migration_at_destination() take an object
|
|
* ... Removed run_instance()
|
|
* 3.27 - Make run_instance() accept a new-world object
|
|
* 3.28 - Update get_console_output() to accept a new-world object
|
|
* 3.29 - Make check_instance_shared_storage accept a new-world object
|
|
* 3.30 - Make remove_volume_connection() accept a new-world object
|
|
* 3.31 - Add get_instance_diagnostics
|
|
* 3.32 - Add destroy_disks and migrate_data optional parameters to
|
|
rollback_live_migration_at_destination()
|
|
* 3.33 - Make build_and_run_instance() take a NetworkRequestList object
|
|
* 3.34 - Add get_serial_console method
|
|
* 3.35 - Make reserve_block_device_name return a BDM object
|
|
|
|
... Juno supports message version 3.35. So, any changes to
|
|
existing methods in 3.x after that point should be done such that they
|
|
can handle the version_cap being set to 3.35.
|
|
|
|
* 3.36 - Make build_and_run_instance() send a Flavor object
|
|
* 3.37 - Add clean_shutdown to stop, resize, rescue, shelve, and
|
|
shelve_offload
|
|
* 3.38 - Add clean_shutdown to prep_resize
|
|
* 3.39 - Add quiesce_instance and unquiesce_instance methods
|
|
* 3.40 - Make build_and_run_instance() take a new-world topology
|
|
limits object
|
|
|
|
... Kilo supports messaging version 3.40. So, any changes to
|
|
existing methods in 3.x after that point should be done so that they
|
|
can handle the version_cap being set to 3.40
|
|
|
|
... Version 4.0 is equivalent to 3.40. Kilo sends version 4.0 by
|
|
default, can accept 3.x calls from Juno nodes, and can be pinned to
|
|
3.x for Juno compatibility. All new changes should go against 4.x.
|
|
|
|
* 4.0 - Remove 3.x compatibility
|
|
* 4.1 - Make prep_resize() and resize_instance() send Flavor object
|
|
* 4.2 - Add migration argument to live_migration()
|
|
* 4.3 - Added get_mks_console method
|
|
* 4.4 - Make refresh_instance_security_rules send an instance object
|
|
* 4.5 - Add migration, scheduler_node and limits arguments to
|
|
rebuild_instance()
|
|
|
|
... Liberty supports messaging version 4.5. So, any changes to
|
|
existing methods in 4.x after that point should be done so that they
|
|
can handle the version_cap being set to 4.5
|
|
|
|
* ... - Remove refresh_security_group_members()
|
|
* ... - Remove refresh_security_group_rules()
|
|
* 4.6 - Add trigger_crash_dump()
|
|
* 4.7 - Add attachment_id argument to detach_volume()
|
|
* 4.8 - Send migrate_data in object format for live_migration,
|
|
rollback_live_migration_at_destination, and
|
|
pre_live_migration.
|
|
* ... - Remove refresh_provider_fw_rules()
|
|
* 4.9 - Add live_migration_force_complete()
|
|
'''
|
|
|
|
VERSION_ALIASES = {
|
|
'icehouse': '3.23',
|
|
'juno': '3.35',
|
|
'kilo': '4.0',
|
|
'liberty': '4.5',
|
|
}
|
|
|
|
def __init__(self):
|
|
super(ComputeAPI, self).__init__()
|
|
target = messaging.Target(topic=CONF.compute_topic, version='4.0')
|
|
upgrade_level = CONF.upgrade_levels.compute
|
|
if upgrade_level == 'auto':
|
|
version_cap = self._determine_version_cap(target)
|
|
else:
|
|
version_cap = self.VERSION_ALIASES.get(upgrade_level,
|
|
upgrade_level)
|
|
serializer = objects_base.NovaObjectSerializer()
|
|
self.client = self.get_client(target, version_cap, serializer)
|
|
|
|
def _determine_version_cap(self, target):
|
|
global LAST_VERSION
|
|
if LAST_VERSION:
|
|
return LAST_VERSION
|
|
service_version = objects.Service.get_minimum_version(
|
|
context.get_admin_context(), 'nova-compute')
|
|
history = service_obj.SERVICE_VERSION_HISTORY
|
|
try:
|
|
version_cap = history[service_version]['compute_rpc']
|
|
except IndexError:
|
|
LOG.error(_LE('Failed to extract compute RPC version from '
|
|
'service history because I am too '
|
|
'old (minimum version is now %(version)i)'),
|
|
{'version': service_version})
|
|
raise exception.ServiceTooOld(thisver=service_obj.SERVICE_VERSION,
|
|
minver=service_version)
|
|
except KeyError:
|
|
LOG.error(_LE('Failed to extract compute RPC version from '
|
|
'service history for version %(version)i'),
|
|
{'version': service_version})
|
|
return target.version
|
|
LAST_VERSION = version_cap
|
|
LOG.info(_LI('Automatically selected compute RPC version %(rpc)s '
|
|
'from minimum service version %(service)i'),
|
|
{'rpc': version_cap,
|
|
'service': service_version})
|
|
return version_cap
|
|
|
|
def _compat_ver(self, current, legacy):
|
|
if self.client.can_send_version(current):
|
|
return current
|
|
else:
|
|
return legacy
|
|
|
|
# Cells overrides this
|
|
def get_client(self, target, version_cap, serializer):
|
|
return rpc.get_client(target,
|
|
version_cap=version_cap,
|
|
serializer=serializer)
|
|
|
|
def add_aggregate_host(self, ctxt, aggregate, host_param, host,
|
|
slave_info=None):
|
|
'''Add aggregate host.
|
|
|
|
:param ctxt: request context
|
|
:param aggregate:
|
|
:param host_param: This value is placed in the message to be the 'host'
|
|
parameter for the remote method.
|
|
:param host: This is the host to send the message to.
|
|
'''
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
cctxt.cast(ctxt, 'add_aggregate_host',
|
|
aggregate=aggregate, host=host_param,
|
|
slave_info=slave_info)
|
|
|
|
def add_fixed_ip_to_instance(self, ctxt, instance, network_id):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'add_fixed_ip_to_instance',
|
|
instance=instance, network_id=network_id)
|
|
|
|
def attach_interface(self, ctxt, instance, network_id, port_id,
|
|
requested_ip):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'attach_interface',
|
|
instance=instance, network_id=network_id,
|
|
port_id=port_id, requested_ip=requested_ip)
|
|
|
|
def attach_volume(self, ctxt, instance, bdm):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'attach_volume', instance=instance, bdm=bdm)
|
|
|
|
def change_instance_metadata(self, ctxt, instance, diff):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'change_instance_metadata',
|
|
instance=instance, diff=diff)
|
|
|
|
def check_can_live_migrate_destination(self, ctxt, instance, destination,
|
|
block_migration, disk_over_commit):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=destination, version=version)
|
|
result = cctxt.call(ctxt, 'check_can_live_migrate_destination',
|
|
instance=instance,
|
|
block_migration=block_migration,
|
|
disk_over_commit=disk_over_commit)
|
|
if isinstance(result, migrate_data_obj.LiveMigrateData):
|
|
return result
|
|
elif result:
|
|
return migrate_data_obj.LiveMigrateData.detect_implementation(
|
|
result)
|
|
else:
|
|
return result
|
|
|
|
def check_can_live_migrate_source(self, ctxt, instance, dest_check_data):
|
|
dest_check_data_obj = dest_check_data
|
|
version = '4.8'
|
|
if not self.client.can_send_version(version):
|
|
version = '4.0'
|
|
if dest_check_data:
|
|
dest_check_data = dest_check_data.to_legacy_dict()
|
|
source = _compute_host(None, instance)
|
|
cctxt = self.client.prepare(server=source, version=version)
|
|
result = cctxt.call(ctxt, 'check_can_live_migrate_source',
|
|
instance=instance,
|
|
dest_check_data=dest_check_data)
|
|
if isinstance(result, migrate_data_obj.LiveMigrateData):
|
|
return result
|
|
elif dest_check_data_obj and result:
|
|
dest_check_data_obj.from_legacy_dict(result)
|
|
return dest_check_data_obj
|
|
else:
|
|
return result
|
|
|
|
def check_instance_shared_storage(self, ctxt, instance, data, host=None):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(host, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'check_instance_shared_storage',
|
|
instance=instance,
|
|
data=data)
|
|
|
|
def confirm_resize(self, ctxt, instance, migration, host,
|
|
reservations=None, cast=True):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(host, instance),
|
|
version=version)
|
|
rpc_method = cctxt.cast if cast else cctxt.call
|
|
return rpc_method(ctxt, 'confirm_resize',
|
|
instance=instance, migration=migration,
|
|
reservations=reservations)
|
|
|
|
def detach_interface(self, ctxt, instance, port_id):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'detach_interface',
|
|
instance=instance, port_id=port_id)
|
|
|
|
def detach_volume(self, ctxt, instance, volume_id, attachment_id=None):
|
|
extra = {'attachment_id': attachment_id}
|
|
version = '4.7'
|
|
if not self.client.can_send_version(version):
|
|
version = '4.0'
|
|
extra.pop('attachment_id')
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'detach_volume',
|
|
instance=instance, volume_id=volume_id, **extra)
|
|
|
|
def finish_resize(self, ctxt, instance, migration, image, disk_info,
|
|
host, reservations=None):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
cctxt.cast(ctxt, 'finish_resize',
|
|
instance=instance, migration=migration,
|
|
image=image, disk_info=disk_info, reservations=reservations)
|
|
|
|
def finish_revert_resize(self, ctxt, instance, migration, host,
|
|
reservations=None):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
cctxt.cast(ctxt, 'finish_revert_resize',
|
|
instance=instance, migration=migration,
|
|
reservations=reservations)
|
|
|
|
def get_console_output(self, ctxt, instance, tail_length):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'get_console_output',
|
|
instance=instance, tail_length=tail_length)
|
|
|
|
def get_console_pool_info(self, ctxt, console_type, host):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
return cctxt.call(ctxt, 'get_console_pool_info',
|
|
console_type=console_type)
|
|
|
|
def get_console_topic(self, ctxt, host):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
return cctxt.call(ctxt, 'get_console_topic')
|
|
|
|
def get_diagnostics(self, ctxt, instance):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'get_diagnostics', instance=instance)
|
|
|
|
def get_instance_diagnostics(self, ctxt, instance):
|
|
# TODO(danms): This needs to be fixed for objects
|
|
instance_p = jsonutils.to_primitive(instance)
|
|
kwargs = {'instance': instance_p}
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'get_instance_diagnostics', **kwargs)
|
|
|
|
def get_vnc_console(self, ctxt, instance, console_type):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'get_vnc_console',
|
|
instance=instance, console_type=console_type)
|
|
|
|
def get_spice_console(self, ctxt, instance, console_type):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'get_spice_console',
|
|
instance=instance, console_type=console_type)
|
|
|
|
def get_rdp_console(self, ctxt, instance, console_type):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'get_rdp_console',
|
|
instance=instance, console_type=console_type)
|
|
|
|
def get_mks_console(self, ctxt, instance, console_type):
|
|
version = '4.3'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'get_mks_console',
|
|
instance=instance, console_type=console_type)
|
|
|
|
def get_serial_console(self, ctxt, instance, console_type):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'get_serial_console',
|
|
instance=instance, console_type=console_type)
|
|
|
|
def validate_console_port(self, ctxt, instance, port, console_type):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'validate_console_port',
|
|
instance=instance, port=port,
|
|
console_type=console_type)
|
|
|
|
def host_maintenance_mode(self, ctxt, host_param, mode, host):
|
|
'''Set host maintenance mode
|
|
|
|
:param ctxt: request context
|
|
:param host_param: This value is placed in the message to be the 'host'
|
|
parameter for the remote method.
|
|
:param mode:
|
|
:param host: This is the host to send the message to.
|
|
'''
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
return cctxt.call(ctxt, 'host_maintenance_mode',
|
|
host=host_param, mode=mode)
|
|
|
|
def host_power_action(self, ctxt, action, host):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
return cctxt.call(ctxt, 'host_power_action', action=action)
|
|
|
|
def inject_network_info(self, ctxt, instance):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'inject_network_info', instance=instance)
|
|
|
|
def live_migration(self, ctxt, instance, dest, block_migration, host,
|
|
migration, migrate_data=None):
|
|
args = {'migration': migration}
|
|
version = '4.8'
|
|
if not self.client.can_send_version(version):
|
|
version = '4.2'
|
|
if migrate_data:
|
|
migrate_data = migrate_data.to_legacy_dict(
|
|
pre_migration_result=True)
|
|
if not self.client.can_send_version(version):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
cctxt.cast(ctxt, 'live_migration', instance=instance,
|
|
dest=dest, block_migration=block_migration,
|
|
migrate_data=migrate_data, **args)
|
|
|
|
def live_migration_force_complete(self, ctxt, instance, migration_id):
|
|
version = '4.9'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'live_migration_force_complete', instance=instance,
|
|
migration_id=migration_id)
|
|
|
|
def pause_instance(self, ctxt, instance):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'pause_instance', instance=instance)
|
|
|
|
def post_live_migration_at_destination(self, ctxt, instance,
|
|
block_migration, host):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
cctxt.cast(ctxt, 'post_live_migration_at_destination',
|
|
instance=instance, block_migration=block_migration)
|
|
|
|
def pre_live_migration(self, ctxt, instance, block_migration, disk,
|
|
host, migrate_data=None):
|
|
migrate_data_orig = migrate_data
|
|
version = '4.8'
|
|
if not self.client.can_send_version(version):
|
|
version = '4.0'
|
|
if migrate_data:
|
|
migrate_data = migrate_data.to_legacy_dict()
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
result = cctxt.call(ctxt, 'pre_live_migration',
|
|
instance=instance,
|
|
block_migration=block_migration,
|
|
disk=disk, migrate_data=migrate_data)
|
|
if isinstance(result, migrate_data_obj.LiveMigrateData):
|
|
return result
|
|
elif migrate_data_orig and result:
|
|
migrate_data_orig.from_legacy_dict(result)
|
|
return migrate_data_orig
|
|
else:
|
|
return result
|
|
|
|
def prep_resize(self, ctxt, image, instance, instance_type, host,
|
|
reservations=None, request_spec=None,
|
|
filter_properties=None, node=None,
|
|
clean_shutdown=True):
|
|
image_p = jsonutils.to_primitive(image)
|
|
msg_args = {'instance': instance,
|
|
'instance_type': instance_type,
|
|
'image': image_p,
|
|
'reservations': reservations,
|
|
'request_spec': request_spec,
|
|
'filter_properties': filter_properties,
|
|
'node': node,
|
|
'clean_shutdown': clean_shutdown}
|
|
version = '4.1'
|
|
if not self.client.can_send_version(version):
|
|
version = '4.0'
|
|
msg_args['instance_type'] = objects_base.obj_to_primitive(
|
|
instance_type)
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
cctxt.cast(ctxt, 'prep_resize', **msg_args)
|
|
|
|
def reboot_instance(self, ctxt, instance, block_device_info,
|
|
reboot_type):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'reboot_instance',
|
|
instance=instance,
|
|
block_device_info=block_device_info,
|
|
reboot_type=reboot_type)
|
|
|
|
def rebuild_instance(self, ctxt, instance, new_pass, injected_files,
|
|
image_ref, orig_image_ref, orig_sys_metadata, bdms,
|
|
recreate=False, on_shared_storage=False, host=None, node=None,
|
|
preserve_ephemeral=False, migration=None, limits=None,
|
|
kwargs=None):
|
|
# NOTE(danms): kwargs is only here for cells compatibility, don't
|
|
# actually send it to compute
|
|
extra = {'preserve_ephemeral': preserve_ephemeral,
|
|
'migration': migration,
|
|
'scheduled_node': node,
|
|
'limits': limits}
|
|
version = '4.5'
|
|
if not self.client.can_send_version(version):
|
|
version = '4.0'
|
|
extra.pop('migration')
|
|
extra.pop('scheduled_node')
|
|
extra.pop('limits')
|
|
cctxt = self.client.prepare(server=_compute_host(host, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'rebuild_instance',
|
|
instance=instance, new_pass=new_pass,
|
|
injected_files=injected_files, image_ref=image_ref,
|
|
orig_image_ref=orig_image_ref,
|
|
orig_sys_metadata=orig_sys_metadata, bdms=bdms,
|
|
recreate=recreate, on_shared_storage=on_shared_storage,
|
|
**extra)
|
|
|
|
def remove_aggregate_host(self, ctxt, aggregate, host_param, host,
|
|
slave_info=None):
|
|
'''Remove aggregate host.
|
|
|
|
:param ctxt: request context
|
|
:param aggregate:
|
|
:param host_param: This value is placed in the message to be the 'host'
|
|
parameter for the remote method.
|
|
:param host: This is the host to send the message to.
|
|
'''
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
cctxt.cast(ctxt, 'remove_aggregate_host',
|
|
aggregate=aggregate, host=host_param,
|
|
slave_info=slave_info)
|
|
|
|
def remove_fixed_ip_from_instance(self, ctxt, instance, address):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'remove_fixed_ip_from_instance',
|
|
instance=instance, address=address)
|
|
|
|
def remove_volume_connection(self, ctxt, volume_id, instance, host):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
return cctxt.call(ctxt, 'remove_volume_connection',
|
|
instance=instance, volume_id=volume_id)
|
|
|
|
def rescue_instance(self, ctxt, instance, rescue_password,
|
|
rescue_image_ref=None, clean_shutdown=True):
|
|
version = '4.0'
|
|
msg_args = {'rescue_password': rescue_password,
|
|
'clean_shutdown': clean_shutdown,
|
|
'rescue_image_ref': rescue_image_ref,
|
|
'instance': instance,
|
|
}
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'rescue_instance', **msg_args)
|
|
|
|
def reset_network(self, ctxt, instance):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'reset_network', instance=instance)
|
|
|
|
def resize_instance(self, ctxt, instance, migration, image, instance_type,
|
|
reservations=None, clean_shutdown=True):
|
|
msg_args = {'instance': instance, 'migration': migration,
|
|
'image': image, 'reservations': reservations,
|
|
'instance_type': instance_type,
|
|
'clean_shutdown': clean_shutdown,
|
|
}
|
|
version = '4.1'
|
|
if not self.client.can_send_version(version):
|
|
msg_args['instance_type'] = objects_base.obj_to_primitive(
|
|
instance_type)
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'resize_instance', **msg_args)
|
|
|
|
def resume_instance(self, ctxt, instance):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'resume_instance', instance=instance)
|
|
|
|
def revert_resize(self, ctxt, instance, migration, host,
|
|
reservations=None):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(host, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'revert_resize',
|
|
instance=instance, migration=migration,
|
|
reservations=reservations)
|
|
|
|
def rollback_live_migration_at_destination(self, ctxt, instance, host,
|
|
destroy_disks=True,
|
|
migrate_data=None):
|
|
version = '4.8'
|
|
if not self.client.can_send_version(version):
|
|
version = '4.0'
|
|
if migrate_data:
|
|
migrate_data = migrate_data.to_legacy_dict()
|
|
extra = {'destroy_disks': destroy_disks,
|
|
'migrate_data': migrate_data,
|
|
}
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
cctxt.cast(ctxt, 'rollback_live_migration_at_destination',
|
|
instance=instance, **extra)
|
|
|
|
def set_admin_password(self, ctxt, instance, new_pass):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'set_admin_password',
|
|
instance=instance, new_pass=new_pass)
|
|
|
|
def set_host_enabled(self, ctxt, enabled, host):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
return cctxt.call(ctxt, 'set_host_enabled', enabled=enabled)
|
|
|
|
def swap_volume(self, ctxt, instance, old_volume_id, new_volume_id):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'swap_volume',
|
|
instance=instance, old_volume_id=old_volume_id,
|
|
new_volume_id=new_volume_id)
|
|
|
|
def get_host_uptime(self, ctxt, host):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
return cctxt.call(ctxt, 'get_host_uptime')
|
|
|
|
def reserve_block_device_name(self, ctxt, instance, device, volume_id,
|
|
disk_bus=None, device_type=None):
|
|
kw = {'instance': instance, 'device': device,
|
|
'volume_id': volume_id, 'disk_bus': disk_bus,
|
|
'device_type': device_type}
|
|
version = '4.0'
|
|
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'reserve_block_device_name', **kw)
|
|
|
|
def backup_instance(self, ctxt, instance, image_id, backup_type,
|
|
rotation):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'backup_instance',
|
|
instance=instance,
|
|
image_id=image_id,
|
|
backup_type=backup_type,
|
|
rotation=rotation)
|
|
|
|
def snapshot_instance(self, ctxt, instance, image_id):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'snapshot_instance',
|
|
instance=instance,
|
|
image_id=image_id)
|
|
|
|
def start_instance(self, ctxt, instance):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'start_instance', instance=instance)
|
|
|
|
def stop_instance(self, ctxt, instance, do_cast=True, clean_shutdown=True):
|
|
msg_args = {'instance': instance,
|
|
'clean_shutdown': clean_shutdown}
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
rpc_method = cctxt.cast if do_cast else cctxt.call
|
|
return rpc_method(ctxt, 'stop_instance', **msg_args)
|
|
|
|
def suspend_instance(self, ctxt, instance):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'suspend_instance', instance=instance)
|
|
|
|
def terminate_instance(self, ctxt, instance, bdms, reservations=None,
|
|
delete_type=None):
|
|
# NOTE(rajesht): The `delete_type` parameter is passed because
|
|
# the method signature has to match with `terminate_instance()`
|
|
# method of cells rpcapi.
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'terminate_instance',
|
|
instance=instance, bdms=bdms,
|
|
reservations=reservations)
|
|
|
|
def unpause_instance(self, ctxt, instance):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'unpause_instance', instance=instance)
|
|
|
|
def unrescue_instance(self, ctxt, instance):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'unrescue_instance', instance=instance)
|
|
|
|
def soft_delete_instance(self, ctxt, instance, reservations=None):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'soft_delete_instance',
|
|
instance=instance, reservations=reservations)
|
|
|
|
def restore_instance(self, ctxt, instance):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'restore_instance', instance=instance)
|
|
|
|
def shelve_instance(self, ctxt, instance, image_id=None,
|
|
clean_shutdown=True):
|
|
msg_args = {'instance': instance, 'image_id': image_id,
|
|
'clean_shutdown': clean_shutdown}
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'shelve_instance', **msg_args)
|
|
|
|
def shelve_offload_instance(self, ctxt, instance,
|
|
clean_shutdown=True):
|
|
msg_args = {'instance': instance, 'clean_shutdown': clean_shutdown}
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'shelve_offload_instance', **msg_args)
|
|
|
|
def unshelve_instance(self, ctxt, instance, host, image=None,
|
|
filter_properties=None, node=None):
|
|
version = '4.0'
|
|
msg_kwargs = {
|
|
'instance': instance,
|
|
'image': image,
|
|
'filter_properties': filter_properties,
|
|
'node': node,
|
|
}
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
cctxt.cast(ctxt, 'unshelve_instance', **msg_kwargs)
|
|
|
|
def volume_snapshot_create(self, ctxt, instance, volume_id,
|
|
create_info):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'volume_snapshot_create', instance=instance,
|
|
volume_id=volume_id, create_info=create_info)
|
|
|
|
def volume_snapshot_delete(self, ctxt, instance, volume_id, snapshot_id,
|
|
delete_info):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'volume_snapshot_delete', instance=instance,
|
|
volume_id=volume_id, snapshot_id=snapshot_id,
|
|
delete_info=delete_info)
|
|
|
|
def external_instance_event(self, ctxt, instances, events):
|
|
cctxt = self.client.prepare(
|
|
server=_compute_host(None, instances[0]),
|
|
version='4.0')
|
|
cctxt.cast(ctxt, 'external_instance_event', instances=instances,
|
|
events=events)
|
|
|
|
def build_and_run_instance(self, ctxt, instance, host, image, request_spec,
|
|
filter_properties, admin_password=None, injected_files=None,
|
|
requested_networks=None, security_groups=None,
|
|
block_device_mapping=None, node=None, limits=None):
|
|
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=host, version=version)
|
|
cctxt.cast(ctxt, 'build_and_run_instance', instance=instance,
|
|
image=image, request_spec=request_spec,
|
|
filter_properties=filter_properties,
|
|
admin_password=admin_password,
|
|
injected_files=injected_files,
|
|
requested_networks=requested_networks,
|
|
security_groups=security_groups,
|
|
block_device_mapping=block_device_mapping, node=node,
|
|
limits=limits)
|
|
|
|
def quiesce_instance(self, ctxt, instance):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.call(ctxt, 'quiesce_instance', instance=instance)
|
|
|
|
def unquiesce_instance(self, ctxt, instance, mapping=None):
|
|
version = '4.0'
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'unquiesce_instance', instance=instance,
|
|
mapping=mapping)
|
|
|
|
def refresh_instance_security_rules(self, ctxt, host, instance):
|
|
version = '4.4'
|
|
if not self.client.can_send_version(version):
|
|
version = '4.0'
|
|
instance = objects_base.obj_to_primitive(instance)
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
cctxt.cast(ctxt, 'refresh_instance_security_rules',
|
|
instance=instance)
|
|
|
|
def trigger_crash_dump(self, ctxt, instance):
|
|
version = '4.6'
|
|
|
|
if not self.client.can_send_version(version):
|
|
raise exception.TriggerCrashDumpNotSupported()
|
|
|
|
cctxt = self.client.prepare(server=_compute_host(None, instance),
|
|
version=version)
|
|
return cctxt.cast(ctxt, "trigger_crash_dump", instance=instance)
|