mogan/mogan/objects/instance.py

187 lines
7.3 KiB
Python

# Copyright 2016 Huawei Technologies Co.,LTD.
# 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.
from oslo_db import exception as db_exc
from oslo_log import log as logging
from oslo_versionedobjects import base as object_base
from mogan.db import api as dbapi
from mogan import objects
from mogan.objects import base
from mogan.objects import fields as object_fields
OPTIONAL_ATTRS = ['nics', 'fault', ]
LOG = logging.getLogger(__name__)
@base.MoganObjectRegistry.register
class Instance(base.MoganObject, object_base.VersionedObjectDictCompat):
# Version 1.0: Initial version
VERSION = '1.0'
dbapi = dbapi.get_instance()
fields = {
'id': object_fields.IntegerField(),
'uuid': object_fields.UUIDField(nullable=True),
'name': object_fields.StringField(nullable=True),
'description': object_fields.StringField(nullable=True),
'project_id': object_fields.UUIDField(nullable=True),
'user_id': object_fields.UUIDField(nullable=True),
'status': object_fields.StringField(nullable=True),
'power_state': object_fields.StringField(nullable=True),
'instance_type_uuid': object_fields.UUIDField(nullable=True),
'availability_zone': object_fields.StringField(nullable=True),
'image_uuid': object_fields.UUIDField(nullable=True),
'nics': object_fields.ObjectField('InstanceNics', nullable=True),
'node_uuid': object_fields.UUIDField(nullable=True),
'launched_at': object_fields.DateTimeField(nullable=True),
'extra': object_fields.FlexibleDictField(nullable=True),
'locked': object_fields.BooleanField(default=False),
'locked_by': object_fields.StringField(nullable=True),
}
def __init__(self, context=None, **kwargs):
instance_nics = kwargs.pop('nics', None)
if instance_nics and isinstance(instance_nics, list):
nics_obj = objects.InstanceNics(context)
for nic in instance_nics:
nic_obj = objects.InstanceNic(
context, instance_uuid=kwargs['uuid'], **nic)
nics_obj.objects.append(nic_obj)
kwargs['nics'] = nics_obj
super(Instance, self).__init__(context=context, **kwargs)
@staticmethod
def _from_db_object(instance, db_inst, expected_attrs=None):
"""Method to help with migration to objects.
Converts a database entity to a formal object.
:param instance: An object of the Instance class.
:param db_inst: A DB Instance model of the object
:return: The object of the class with the database entity added
"""
for field in set(instance.fields) - set(OPTIONAL_ATTRS):
instance[field] = db_inst[field]
if expected_attrs is None:
expected_attrs = []
if 'nics' in expected_attrs:
instance._load_instance_nics(instance._context, instance.uuid)
else:
instance.nics = None
if 'fault' in expected_attrs:
instance._load_fault(instance._context, instance.uuid)
instance.obj_reset_changes()
return instance
def _load_instance_nics(self, context, instance_uuid):
self.nics = objects.InstanceNics.get_by_instance_uuid(
context=context, instance_uuid=instance_uuid)
@staticmethod
def _from_db_object_list(db_objects, cls, context):
"""Converts a list of database entities to a list of formal objects."""
instances = []
for obj in db_objects:
expected_attrs = ['nics']
if obj["status"] == "error":
expected_attrs.append("fault")
instances.append(Instance._from_db_object(cls(context),
obj,
expected_attrs))
return instances
def _load_fault(self, context, instance_uuid):
self.fault = objects.InstanceFault.get_latest_for_instance(
context=context, instance_uuid=instance_uuid)
def _save_nics(self, context):
for nic_obj in self.nics or []:
nic_obj.save(context)
def as_dict(self):
data = super(Instance, self).as_dict()
if 'nics' in data:
data.update(network_info=data['nics'].to_legacy_dict())
return data
@classmethod
def list(cls, context, project_only=False):
"""Return a list of Instance objects."""
db_instances = cls.dbapi.instance_get_all(context,
project_only=project_only)
return Instance._from_db_object_list(db_instances, cls, context)
@classmethod
def get(cls, context, uuid):
"""Find a instance and return a Instance object."""
expected_attrs = ['nics']
db_instance = cls.dbapi.instance_get(context, uuid)
if db_instance["status"] == "error":
expected_attrs.append("fault")
instance = Instance._from_db_object(cls(context),
db_instance,
expected_attrs)
return instance
def create(self, context=None):
"""Create a Instance record in the DB."""
values = self.obj_get_changes()
instance_nics = values.pop('nics', None)
if instance_nics:
values['nics'] = instance_nics.as_list_of_dict()
db_instance = self.dbapi.instance_create(context, values)
expected_attrs = None
if instance_nics:
expected_attrs = ['nics']
self._from_db_object(self, db_instance, expected_attrs)
def destroy(self, context=None):
"""Delete the Instance from the DB."""
self.dbapi.instance_destroy(context, self.uuid)
self.obj_reset_changes()
def save(self, context=None):
"""Save updates to this Instance."""
updates = self.obj_get_changes()
for field in list(updates):
if (self.obj_attr_is_set(field) and
isinstance(self.fields[field], object_fields.ObjectField)
and getattr(self, field, None) is not None):
try:
getattr(self, '_save_%s' % field)(context)
except AttributeError:
LOG.exception('No save handler for %s', field,
instance=self)
except db_exc.DBReferenceError as exp:
if exp.key != 'instance_uuid':
raise
updates.pop(field)
self.dbapi.instance_update(context, self.uuid, updates)
self.obj_reset_changes()
def refresh(self, context=None):
"""Refresh the object by re-fetching from the DB."""
current = self.__class__.get(context, self.uuid)
self.obj_refresh(current)
self.obj_reset_changes()