| # -*- coding: utf-8 -*- |
| |
| ## |
| # Copyright 2018 Telefonica S.A. |
| # |
| # 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 asyncio |
| from collections import OrderedDict |
| # from osm_common.dbbase import DbException |
| |
| __author__ = "Alfonso Tierno" |
| |
| |
| class LcmException(Exception): |
| pass |
| |
| |
| class LcmExceptionNoMgmtIP(LcmException): |
| pass |
| |
| |
| class LcmExceptionExit(LcmException): |
| pass |
| |
| |
| def versiontuple(v): |
| """utility for compare dot separate versions. Fills with zeros to proper number comparison |
| package version will be something like 4.0.1.post11+gb3f024d.dirty-1. Where 4.0.1 is the git tag, postXX is the |
| number of commits from this tag, and +XXXXXXX is the git commit short id. Total length is 16 with until 999 commits |
| """ |
| filled = [] |
| for point in v.split("."): |
| point, _, _ = point.partition("+") |
| point, _, _ = point.partition("-") |
| filled.append(point.zfill(20)) |
| return tuple(filled) |
| |
| |
| # LcmBase must be listed before TaskRegistry, as it is a dependency. |
| class LcmBase: |
| |
| def __init__(self, db, msg, fs, logger): |
| """ |
| |
| :param db: database connection |
| """ |
| self.db = db |
| self.msg = msg |
| self.fs = fs |
| self.logger = logger |
| |
| def update_db_2(self, item, _id, _desc): |
| """ |
| Updates database with _desc information. If success _desc is cleared |
| :param item: |
| :param _id: |
| :param _desc: dictionary with the content to update. Keys are dot separated keys for |
| :return: None. Exception is raised on error |
| """ |
| if not _desc: |
| return |
| self.db.set_one(item, {"_id": _id}, _desc) |
| _desc.clear() |
| # except DbException as e: |
| # self.logger.error("Updating {} _id={} with '{}'. Error: {}".format(item, _id, _desc, e)) |
| |
| |
| class TaskRegistry(LcmBase): |
| """ |
| Implements a registry of task needed for later cancelation, look for related tasks that must be completed before |
| etc. It stores a four level dict |
| First level is the topic, ns, vim_account, sdn |
| Second level is the _id |
| Third level is the operation id |
| Fourth level is a descriptive name, the value is the task class |
| |
| The HA (High-Availability) methods are used when more than one LCM instance is running. |
| To register the current task in the external DB, use LcmBase as base class, to be able |
| to reuse LcmBase.update_db_2() |
| The DB registry uses the following fields to distinguish a task: |
| - op_type: operation type ("nslcmops" or "nsilcmops") |
| - op_id: operation ID |
| - worker: the worker ID for this process |
| """ |
| |
| # NS/NSI: "services" VIM/WIM/SDN: "accounts" |
| topic_service_list = ['ns', 'nsi'] |
| topic_account_list = ['vim', 'wim', 'sdn'] |
| |
| # Map topic to InstanceID |
| topic2instid_dict = { |
| 'ns': 'nsInstanceId', |
| 'nsi': 'netsliceInstanceId'} |
| |
| # Map topic to DB table name |
| topic2dbtable_dict = { |
| 'ns': 'nslcmops', |
| 'nsi': 'nsilcmops', |
| 'vim': 'vim_accounts', |
| 'wim': 'wim_accounts', |
| 'sdn': 'sdns'} |
| |
| def __init__(self, worker_id=None, db=None, logger=None): |
| self.task_registry = { |
| "ns": {}, |
| "nsi": {}, |
| "vim_account": {}, |
| "wim_account": {}, |
| "sdn": {}, |
| } |
| self.worker_id = worker_id |
| self.db = db |
| self.logger = logger |
| |
| def register(self, topic, _id, op_id, task_name, task): |
| """ |
| Register a new task |
| :param topic: Can be "ns", "nsi", "vim_account", "sdn" |
| :param _id: _id of the related item |
| :param op_id: id of the operation of the related item |
| :param task_name: Task descriptive name, as create, instantiate, terminate. Must be unique in this op_id |
| :param task: Task class |
| :return: none |
| """ |
| if _id not in self.task_registry[topic]: |
| self.task_registry[topic][_id] = OrderedDict() |
| if op_id not in self.task_registry[topic][_id]: |
| self.task_registry[topic][_id][op_id] = {task_name: task} |
| else: |
| self.task_registry[topic][_id][op_id][task_name] = task |
| # print("registering task", topic, _id, op_id, task_name, task) |
| |
| def remove(self, topic, _id, op_id, task_name=None): |
| """ |
| When task is ended, it should be removed. It ignores missing tasks. It also removes tasks done with this _id |
| :param topic: Can be "ns", "nsi", "vim_account", "sdn" |
| :param _id: _id of the related item |
| :param op_id: id of the operation of the related item |
| :param task_name: Task descriptive name. If none it deletes all tasks with same _id and op_id |
| :return: None |
| """ |
| if not self.task_registry[topic].get(_id): |
| return |
| if not task_name: |
| self.task_registry[topic][_id].pop(op_id, None) |
| elif self.task_registry[topic][_id].get(op_id): |
| self.task_registry[topic][_id][op_id].pop(task_name, None) |
| |
| # delete done tasks |
| for op_id_ in list(self.task_registry[topic][_id]): |
| for name, task in self.task_registry[topic][_id][op_id_].items(): |
| if not task.done(): |
| break |
| else: |
| del self.task_registry[topic][_id][op_id_] |
| if not self.task_registry[topic][_id]: |
| del self.task_registry[topic][_id] |
| |
| def lookfor_related(self, topic, _id, my_op_id=None): |
| task_list = [] |
| task_name_list = [] |
| if _id not in self.task_registry[topic]: |
| return "", task_name_list |
| for op_id in reversed(self.task_registry[topic][_id]): |
| if my_op_id: |
| if my_op_id == op_id: |
| my_op_id = None # so that the next task is taken |
| continue |
| |
| for task_name, task in self.task_registry[topic][_id][op_id].items(): |
| if not task.done(): |
| task_list.append(task) |
| task_name_list.append(task_name) |
| break |
| return ", ".join(task_name_list), task_list |
| |
| def cancel(self, topic, _id, target_op_id=None, target_task_name=None): |
| """ |
| Cancel all active tasks of a concrete ns, nsi, vim_account, sdn identified for _id. If op_id is supplied only |
| this is cancelled, and the same with task_name |
| """ |
| if not self.task_registry[topic].get(_id): |
| return |
| for op_id in reversed(self.task_registry[topic][_id]): |
| if target_op_id and target_op_id != op_id: |
| continue |
| for task_name, task in self.task_registry[topic][_id][op_id].items(): |
| if target_task_name and target_task_name != task_name: |
| continue |
| # result = |
| task.cancel() |
| # if result: |
| # self.logger.debug("{} _id={} order_id={} task={} cancelled".format(topic, _id, op_id, task_name)) |
| |
| # Is topic NS/NSI? |
| def _is_service_type_HA(self, topic): |
| return topic in self.topic_service_list |
| |
| # Is topic VIM/WIM/SDN? |
| def _is_account_type_HA(self, topic): |
| return topic in self.topic_account_list |
| |
| # Input: op_id, example: 'abc123def:3' Output: account_id='abc123def', op_index=3 |
| def _get_account_and_op_HA(self, op_id): |
| if not op_id: |
| return (None, None) |
| account_id, _, op_index = op_id.rpartition(':') |
| if not account_id: |
| return (None, None) |
| if not op_index.isdigit(): |
| return (None, None) |
| return account_id, op_index |
| |
| # Get '_id' for any topic and operation |
| def _get_instance_id_HA(self, topic, op_type, op_id): |
| _id = None |
| # Special operation 'ANY', for SDN account associated to a VIM account: op_id as '_id' |
| if op_type == 'ANY': |
| _id = op_id |
| # NS/NSI: Use op_id as '_id' |
| elif self._is_service_type_HA(topic): |
| _id = op_id |
| # VIM/SDN/WIM: Split op_id to get Account ID and Operation Index, use Account ID as '_id' |
| elif self._is_account_type_HA(topic): |
| _id, _ = self._get_account_and_op_HA(op_id) |
| return _id |
| |
| # Set DB _filter for querying any related process state |
| def _get_waitfor_filter_HA(self, db_lcmop, topic, op_type, op_id): |
| _filter = {} |
| # Special operation 'ANY', for SDN account associated to a VIM account: op_id as '_id' |
| # In this special case, the timestamp is ignored |
| if op_type == 'ANY': |
| _filter = {'operationState': 'PROCESSING'} |
| # Otherwise, get 'startTime' timestamp for this operation |
| else: |
| # NS/NSI |
| if self._is_service_type_HA(topic): |
| starttime_this_op = db_lcmop.get("startTime") |
| instance_id_label = self.topic2instid_dict.get(topic) |
| instance_id = db_lcmop.get(instance_id_label) |
| _filter = {instance_id_label: instance_id, |
| 'operationState': 'PROCESSING', |
| 'startTime.lt': starttime_this_op} |
| # VIM/WIM/SDN |
| elif self._is_account_type_HA(topic): |
| _, op_index = self._get_account_and_op_HA(op_id) |
| _ops = db_lcmop['_admin']['operations'] |
| _this_op = _ops[int(op_index)] |
| starttime_this_op = _this_op.get('startTime', None) |
| _filter = {'operationState': 'PROCESSING', |
| 'startTime.lt': starttime_this_op} |
| return _filter |
| |
| # Get DB params for any topic and operation |
| def _get_dbparams_for_lock_HA(self, topic, op_type, op_id): |
| q_filter = {} |
| update_dict = {} |
| # NS/NSI |
| if self._is_service_type_HA(topic): |
| q_filter = {'_id': op_id, '_admin.worker': None} |
| update_dict = {'_admin.worker': self.worker_id} |
| # VIM/WIM/SDN |
| elif self._is_account_type_HA(topic): |
| account_id, op_index = self._get_account_and_op_HA(op_id) |
| if not account_id: |
| return None, None |
| if op_type == 'create': |
| # Creating a VIM/WIM/SDN account implies setting '_admin.current_operation' = 0 |
| op_index = 0 |
| q_filter = {'_id': account_id, "_admin.operations.{}.worker".format(op_index): None} |
| update_dict = {'_admin.operations.{}.worker'.format(op_index): self.worker_id, |
| '_admin.current_operation': op_index} |
| return q_filter, update_dict |
| |
| def lock_HA(self, topic, op_type, op_id): |
| """ |
| Lock a task, if possible, to indicate to the HA system that |
| the task will be executed in this LCM instance. |
| :param topic: Can be "ns", "nsi", "vim", "wim", or "sdn" |
| :param op_type: Operation type, can be "nslcmops", "nsilcmops", "create", "edit", "delete" |
| :param op_id: NS, NSI: Operation ID VIM,WIM,SDN: Account ID + ':' + Operation Index |
| :return: |
| True=lock was successful => execute the task (not registered by any other LCM instance) |
| False=lock failed => do NOT execute the task (already registered by another LCM instance) |
| |
| HA tasks and backward compatibility: |
| If topic is "account type" (VIM/WIM/SDN) and op_id is None, 'op_id' was not provided by NBI. |
| This means that the running NBI instance does not support HA. |
| In such a case this method should always return True, to always execute |
| the task in this instance of LCM, without querying the DB. |
| """ |
| |
| # Backward compatibility for VIM/WIM/SDN without op_id |
| if self._is_account_type_HA(topic) and op_id is None: |
| return True |
| |
| # Try to lock this task |
| db_table_name = self.topic2dbtable_dict.get(topic) |
| q_filter, update_dict = self._get_dbparams_for_lock_HA(topic, op_type, op_id) |
| db_lock_task = self.db.set_one(db_table_name, |
| q_filter=q_filter, |
| update_dict=update_dict, |
| fail_on_empty=False) |
| if db_lock_task is None: |
| self.logger.debug("Task {} operation={} already locked by another worker".format(topic, op_id)) |
| return False |
| else: |
| # Set 'detailed-status' to 'In progress' for VIM/WIM/SDN operations |
| if self._is_account_type_HA(topic): |
| detailed_status = 'In progress' |
| account_id, op_index = self._get_account_and_op_HA(op_id) |
| q_filter = {'_id': account_id} |
| update_dict = {'_admin.operations.{}.detailed-status'.format(op_index): detailed_status} |
| self.db.set_one(db_table_name, |
| q_filter=q_filter, |
| update_dict=update_dict, |
| fail_on_empty=False) |
| return True |
| |
| def register_HA(self, topic, op_type, op_id, operationState, detailed_status): |
| """ |
| Register a task, done when finished a VIM/WIM/SDN 'create' operation. |
| :param topic: Can be "vim", "wim", or "sdn" |
| :param op_type: Operation type, can be "create", "edit", "delete" |
| :param op_id: Account ID + ':' + Operation Index |
| :return: nothing |
| """ |
| |
| # Backward compatibility |
| if not self._is_account_type_HA(topic) or (self._is_account_type_HA(topic) and op_id is None): |
| return |
| |
| # Get Account ID and Operation Index |
| account_id, op_index = self._get_account_and_op_HA(op_id) |
| db_table_name = self.topic2dbtable_dict.get(topic) |
| |
| # If this is a 'delete' operation, the account may have been deleted (SUCCESS) or may still exist (FAILED) |
| # If the account exist, register the HA task. |
| # Update DB for HA tasks |
| q_filter = {'_id': account_id} |
| update_dict = {'_admin.operations.{}.operationState'.format(op_index): operationState, |
| '_admin.operations.{}.detailed-status'.format(op_index): detailed_status} |
| self.db.set_one(db_table_name, |
| q_filter=q_filter, |
| update_dict=update_dict, |
| fail_on_empty=False) |
| return |
| |
| async def waitfor_related_HA(self, topic, op_type, op_id=None): |
| """ |
| Wait for any pending related HA tasks |
| """ |
| |
| # Backward compatibility |
| if not (self._is_service_type_HA(topic) or self._is_account_type_HA(topic)) and (op_id is None): |
| return |
| |
| # Get DB table name |
| db_table_name = self.topic2dbtable_dict.get(topic) |
| |
| # Get instance ID |
| _id = self._get_instance_id_HA(topic, op_type, op_id) |
| _filter = {"_id": _id} |
| db_lcmop = self.db.get_one(db_table_name, |
| _filter, |
| fail_on_empty=False) |
| if not db_lcmop: |
| return |
| |
| # Set DB _filter for querying any related process state |
| _filter = self._get_waitfor_filter_HA(db_lcmop, topic, op_type, op_id) |
| |
| # For HA, get list of tasks from DB instead of from dictionary (in-memory) variable. |
| timeout_wait_for_task = 3600 # Max time (seconds) to wait for a related task to finish |
| # interval_wait_for_task = 30 # A too long polling interval slows things down considerably |
| interval_wait_for_task = 10 # Interval in seconds for polling related tasks |
| time_left = timeout_wait_for_task |
| old_num_related_tasks = 0 |
| while True: |
| # Get related tasks (operations within the same instance as this) which are |
| # still running (operationState='PROCESSING') and which were started before this task. |
| # In the case of op_type='ANY', get any related tasks with operationState='PROCESSING', ignore timestamps. |
| db_waitfor_related_task = self.db.get_list(db_table_name, |
| q_filter=_filter) |
| new_num_related_tasks = len(db_waitfor_related_task) |
| # If there are no related tasks, there is nothing to wait for, so return. |
| if not new_num_related_tasks: |
| return |
| # If number of pending related tasks have changed, |
| # update the 'detailed-status' field and log the change. |
| # Do NOT update the 'detailed-status' for SDNC-associated-to-VIM operations ('ANY'). |
| if (op_type != 'ANY') and (new_num_related_tasks != old_num_related_tasks): |
| step = "Waiting for {} related tasks to be completed.".format(new_num_related_tasks) |
| update_dict = {} |
| q_filter = {'_id': _id} |
| # NS/NSI |
| if self._is_service_type_HA(topic): |
| update_dict = {'detailed-status': step} |
| # VIM/WIM/SDN |
| elif self._is_account_type_HA(topic): |
| _, op_index = self._get_account_and_op_HA(op_id) |
| update_dict = {'_admin.operations.{}.detailed-status'.format(op_index): step} |
| self.logger.debug("Task {} operation={} {}".format(topic, _id, step)) |
| self.db.set_one(db_table_name, |
| q_filter=q_filter, |
| update_dict=update_dict, |
| fail_on_empty=False) |
| old_num_related_tasks = new_num_related_tasks |
| time_left -= interval_wait_for_task |
| if time_left < 0: |
| raise LcmException( |
| "Timeout ({}) when waiting for related tasks to be completed".format( |
| timeout_wait_for_task)) |
| await asyncio.sleep(interval_wait_for_task) |
| |
| return |