nova/nova/virt/block_device.py

345 lines
12 KiB
Python

# vim: tabstop=4 shiftwidth=4 softtabstop=4
# All Rights Reserved.
#
# 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.
import functools
import operator
from nova import block_device
from nova.openstack.common.gettextutils import _
from nova.openstack.common import jsonutils
from nova.openstack.common import log as logging
LOG = logging.getLogger(__name__)
class _NotTransformable(Exception):
pass
class _InvalidType(_NotTransformable):
pass
class _NoLegacy(Exception):
pass
class DriverBlockDevice(dict):
def __init__(self, bdm):
if bdm.get('no_device'):
raise _NotTransformable()
# NOTE (ndipanov): Always save the id of the bdm
# so we can use it for db updates.
self.id = bdm.get('id')
self.update(dict((field, None)
for field in self._fields))
self._transform(bdm)
def _transform(self, bdm):
"""Transform bdm to the format that is passed to drivers."""
raise NotImplementedError()
def legacy(self):
"""Basic legacy transformation.
Basic method will just drop the fields that are not in
_legacy_fields set. Override this in subclass if needed.
"""
return dict((key, self.get(key)) for key in self._legacy_fields)
def attach(self, **kwargs):
"""
Make the device available to be used by VMs.
To be overriden in subclasses with the connecting logic for
the type of device the subclass represents.
"""
raise NotImplementedError()
class DriverSwapBlockDevice(DriverBlockDevice):
_fields = set(['device_name', 'swap_size', 'disk_bus'])
_legacy_fields = _fields - set(['disk_bus'])
def _transform(self, bdm):
if not block_device.new_format_is_swap(bdm):
raise _InvalidType
self.update({
'device_name': bdm.get('device_name'),
'swap_size': bdm.get('volume_size') or 0,
'disk_bus': bdm.get('disk_bus')
})
class DriverEphemeralBlockDevice(DriverBlockDevice):
_new_only_fields = set(['disk_bus', 'device_type', 'guest_format'])
_fields = set(['device_name', 'size']) | _new_only_fields
_legacy_fields = (_fields - _new_only_fields |
set(['num', 'virtual_name']))
def _transform(self, bdm):
if not block_device.new_format_is_ephemeral(bdm):
raise _InvalidType
self.update({
'device_name': bdm.get('device_name'),
'size': bdm.get('volume_size') or 0,
'disk_bus': bdm.get('disk_bus'),
'device_type': bdm.get('device_type'),
'guest_format': bdm.get('guest_format')
})
def legacy(self, num=0):
legacy_bdm = super(DriverEphemeralBlockDevice, self).legacy()
legacy_bdm['num'] = num
legacy_bdm['virtual_name'] = 'ephemeral' + str(num)
return legacy_bdm
class DriverVolumeBlockDevice(DriverBlockDevice):
_legacy_fields = set(['connection_info', 'mount_device',
'delete_on_termination'])
_new_fields = set(['guest_format', 'device_type',
'disk_bus', 'boot_index'])
_fields = _legacy_fields | _new_fields
_valid_source = 'volume'
_valid_destination = 'volume'
# Override in subclasses if volume should be created from
# another source.
_source_id_field = None
def _transform(self, bdm):
if not bdm.get('source_type') == self._valid_source\
or not bdm.get('destination_type') == \
self._valid_destination:
raise _InvalidType
# NOTE (ndipanov): Save it as an attribute as we will
# need it for attach()
self.volume_size = bdm.get('volume_size')
self.volume_id = bdm.get('volume_id')
if self._source_id_field:
setattr(self, self._source_id_field,
bdm.get(self._source_id_field, None))
self.update(
dict((k, v) for k, v in bdm.iteritems()
if k in self._new_fields | set(['delete_on_termination']))
)
self['mount_device'] = bdm.get('device_name')
try:
self['connection_info'] = jsonutils.loads(
bdm.get('connection_info'))
except TypeError:
self['connection_info'] = None
def attach(self, context, instance, volume_api, virt_driver, db_api=None):
volume = volume_api.get(context, self.volume_id)
volume_api.check_attach(context, volume, instance=instance)
# Attach a volume to an instance at boot time. So actual attach
# is done by instance creation.
instance_id = instance['id']
instance_uuid = instance['uuid']
volume_id = volume['id']
context = context.elevated()
LOG.audit(_('Booting with volume %(volume_id)s at %(mountpoint)s'),
{'volume_id': volume_id,
'mountpoint': self['mount_device']},
context=context, instance=instance)
connector = virt_driver.get_volume_connector(instance)
connection_info = volume_api.initialize_connection(context,
volume_id,
connector)
volume_api.attach(context, volume_id,
instance_uuid, self['mount_device'])
if 'serial' not in connection_info:
connection_info['serial'] = self.volume_id
self['connection_info'] = connection_info
if db_api:
db_api.block_device_mapping_update(
context, self.id,
{'connection_info': jsonutils.dumps(connection_info)})
def refresh_connection_info(self, context, instance, volume_api,
virt_driver, db_api=None):
# NOTE (ndipanov): A no-op if there is no connection info already
if not self['connection_info']:
return
connector = virt_driver.get_volume_connector(instance)
connection_info = volume_api.initialize_connection(context,
self.volume_id,
connector)
if 'serial' not in connection_info:
connection_info['serial'] = self.volume_id
self['connection_info'] = connection_info
if db_api:
db_api.block_device_mapping_update(context, self.id,
{'connection_info': jsonutils.dumps(connection_info)})
class DriverSnapshotBlockDevice(DriverVolumeBlockDevice):
_valid_source = 'snapshot'
_source_id_field = 'snapshot_id'
def attach(self, context, instance, volume_api, virt_driver,
db_api=None, wait_func=None):
if not self.volume_id:
snapshot = volume_api.get_snapshot(context,
self.snapshot_id)
vol = volume_api.create(context, self.volume_size,
'', '', snapshot)
if wait_func:
wait_func(context, vol['id'])
if db_api:
db_api.block_device_mapping_update(context, self.id,
{'volume_id': vol['id']})
self.volume_id = vol['id']
# Call the volume attach now
super(DriverSnapshotBlockDevice, self).attach(context, instance,
volume_api, virt_driver,
db_api)
class DriverImageBlockDevice(DriverVolumeBlockDevice):
_valid_source = 'image'
_source_id_field = 'image_id'
def attach(self, context, instance, volume_api, virt_driver,
db_api=None, wait_func=None):
if not self.volume_id:
vol = volume_api.create(context, self.volume_size,
'', '', image_id=self.image_id)
if wait_func:
wait_func(context, vol['id'])
if db_api:
db_api.block_device_mapping_update(context, self.id,
{'volume_id': vol['id']})
self.volume_id = vol['id']
super(DriverImageBlockDevice, self).attach(context, instance,
volume_api, virt_driver,
db_api)
def _convert_block_devices(device_type, block_device_mapping):
def _is_transformable(bdm):
try:
device_type(bdm)
except _NotTransformable:
return False
return True
return [device_type(bdm)
for bdm in block_device_mapping
if _is_transformable(bdm)]
convert_swap = functools.partial(_convert_block_devices,
DriverSwapBlockDevice)
convert_ephemerals = functools.partial(_convert_block_devices,
DriverEphemeralBlockDevice)
convert_volumes = functools.partial(_convert_block_devices,
DriverVolumeBlockDevice)
convert_snapshots = functools.partial(_convert_block_devices,
DriverSnapshotBlockDevice)
convert_images = functools.partial(_convert_block_devices,
DriverImageBlockDevice)
def attach_block_devices(block_device_mapping, *attach_args, **attach_kwargs):
map(operator.methodcaller('attach', *attach_args, **attach_kwargs),
block_device_mapping)
return block_device_mapping
def refresh_conn_infos(block_device_mapping, *refresh_args, **refresh_kwargs):
map(operator.methodcaller('refresh_connection_info',
*refresh_args, **refresh_kwargs),
block_device_mapping)
return block_device_mapping
def legacy_block_devices(block_device_mapping):
def _has_legacy(bdm):
try:
bdm.legacy()
except _NoLegacy:
return False
return True
bdms = [bdm.legacy()
for bdm in block_device_mapping
if _has_legacy(bdm)]
# Re-enumerate ephemeral devices
if all(isinstance(bdm, DriverEphemeralBlockDevice)
for bdm in block_device_mapping):
for i, dev in enumerate(bdms):
dev['virtual_name'] = dev['virtual_name'][:-1] + str(i)
dev['num'] = i
return bdms
def get_swap(transformed_list):
"""Get the swap device out of the list context.
The block_device_info needs swap to be a single device,
not a list - otherwise this is a no-op.
"""
if not all(isinstance(device, DriverSwapBlockDevice) or
'swap_size' in device
for device in transformed_list):
return transformed_list
try:
return transformed_list.pop()
except IndexError:
return None
_IMPLEMENTED_CLASSES = (DriverSwapBlockDevice, DriverEphemeralBlockDevice,
DriverVolumeBlockDevice, DriverSnapshotBlockDevice,
DriverImageBlockDevice)
def is_implemented(bdm):
for cls in _IMPLEMENTED_CLASSES:
try:
cls(bdm)
return True
except _NotTransformable:
pass
return False