| ## |
| # Copyright 2019 Telefonica Investigacion y Desarrollo, S.A.U. |
| # This file is part of OSM |
| # 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. |
| # |
| # For those usages not covered by the Apache License, Version 2.0 please |
| # contact with: nfvlabs@tid.es |
| ## |
| |
| import asyncio |
| import logging |
| import os |
| |
| from n2vc.config import ModelConfig |
| from n2vc.exceptions import ( |
| N2VCBadArgumentsException, |
| N2VCException, |
| N2VCConnectionException, |
| N2VCExecutionException, |
| # N2VCNotFound, |
| MethodNotImplemented, |
| JujuK8sProxycharmNotSupported, |
| ) |
| from n2vc.n2vc_conn import N2VCConnector |
| from n2vc.n2vc_conn import obj_to_dict, obj_to_yaml |
| from n2vc.libjuju import Libjuju |
| from n2vc.utils import base64_to_cacert |
| |
| |
| class N2VCJujuConnector(N2VCConnector): |
| |
| """ |
| #################################################################################### |
| ################################### P U B L I C #################################### |
| #################################################################################### |
| """ |
| |
| BUILT_IN_CLOUDS = ["localhost", "microk8s"] |
| |
| def __init__( |
| self, |
| db: object, |
| fs: object, |
| log: object = None, |
| loop: object = None, |
| url: str = "127.0.0.1:17070", |
| username: str = "admin", |
| vca_config: dict = None, |
| on_update_db=None, |
| ): |
| """Initialize juju N2VC connector |
| """ |
| |
| # parent class constructor |
| N2VCConnector.__init__( |
| self, |
| db=db, |
| fs=fs, |
| log=log, |
| loop=loop, |
| url=url, |
| username=username, |
| vca_config=vca_config, |
| on_update_db=on_update_db, |
| ) |
| |
| # silence websocket traffic log |
| logging.getLogger("websockets.protocol").setLevel(logging.INFO) |
| logging.getLogger("juju.client.connection").setLevel(logging.WARN) |
| logging.getLogger("model").setLevel(logging.WARN) |
| |
| self.log.info("Initializing N2VC juju connector...") |
| |
| """ |
| ############################################################## |
| # check arguments |
| ############################################################## |
| """ |
| |
| # juju URL |
| if url is None: |
| raise N2VCBadArgumentsException("Argument url is mandatory", ["url"]) |
| url_parts = url.split(":") |
| if len(url_parts) != 2: |
| raise N2VCBadArgumentsException( |
| "Argument url: bad format (localhost:port) -> {}".format(url), ["url"] |
| ) |
| self.hostname = url_parts[0] |
| try: |
| self.port = int(url_parts[1]) |
| except ValueError: |
| raise N2VCBadArgumentsException( |
| "url port must be a number -> {}".format(url), ["url"] |
| ) |
| |
| # juju USERNAME |
| if username is None: |
| raise N2VCBadArgumentsException( |
| "Argument username is mandatory", ["username"] |
| ) |
| |
| # juju CONFIGURATION |
| if vca_config is None: |
| raise N2VCBadArgumentsException( |
| "Argument vca_config is mandatory", ["vca_config"] |
| ) |
| |
| if "secret" in vca_config: |
| self.secret = vca_config["secret"] |
| else: |
| raise N2VCBadArgumentsException( |
| "Argument vca_config.secret is mandatory", ["vca_config.secret"] |
| ) |
| |
| # pubkey of juju client in osm machine: ~/.local/share/juju/ssh/juju_id_rsa.pub |
| # if exists, it will be written in lcm container: _create_juju_public_key() |
| if "public_key" in vca_config: |
| self.public_key = vca_config["public_key"] |
| else: |
| self.public_key = None |
| |
| # TODO: Verify ca_cert is valid before using. VCA will crash |
| # if the ca_cert isn't formatted correctly. |
| |
| self.ca_cert = vca_config.get("ca_cert") |
| if self.ca_cert: |
| self.ca_cert = base64_to_cacert(vca_config["ca_cert"]) |
| |
| if "api_proxy" in vca_config and vca_config["api_proxy"] != "": |
| self.api_proxy = vca_config["api_proxy"] |
| self.log.debug( |
| "api_proxy for native charms configured: {}".format(self.api_proxy) |
| ) |
| else: |
| self.warning( |
| "api_proxy is not configured" |
| ) |
| self.api_proxy = None |
| |
| model_config = ModelConfig(vca_config) |
| |
| self.cloud = vca_config.get('cloud') |
| self.k8s_cloud = None |
| if "k8s_cloud" in vca_config: |
| self.k8s_cloud = vca_config.get("k8s_cloud") |
| self.log.debug('Arguments have been checked') |
| |
| # juju data |
| self.controller = None # it will be filled when connect to juju |
| self.juju_models = {} # model objects for every model_name |
| self.juju_observers = {} # model observers for every model_name |
| self._connecting = ( |
| False # while connecting to juju (to avoid duplicate connections) |
| ) |
| self._authenticated = ( |
| False # it will be True when juju connection be stablished |
| ) |
| self._creating_model = False # True during model creation |
| self.libjuju = Libjuju( |
| endpoint=self.url, |
| api_proxy=self.api_proxy, |
| username=self.username, |
| password=self.secret, |
| cacert=self.ca_cert, |
| loop=self.loop, |
| log=self.log, |
| db=self.db, |
| n2vc=self, |
| model_config=model_config, |
| ) |
| |
| # create juju pub key file in lcm container at |
| # ./local/share/juju/ssh/juju_id_rsa.pub |
| self._create_juju_public_key() |
| |
| self.log.info("N2VC juju connector initialized") |
| |
| async def get_status(self, namespace: str, yaml_format: bool = True): |
| |
| # self.log.info('Getting NS status. namespace: {}'.format(namespace)) |
| |
| _nsi_id, ns_id, _vnf_id, _vdu_id, _vdu_count = self._get_namespace_components( |
| namespace=namespace |
| ) |
| # model name is ns_id |
| model_name = ns_id |
| if model_name is None: |
| msg = "Namespace {} not valid".format(namespace) |
| self.log.error(msg) |
| raise N2VCBadArgumentsException(msg, ["namespace"]) |
| |
| status = {} |
| models = await self.libjuju.list_models(contains=ns_id) |
| |
| for m in models: |
| status[m] = await self.libjuju.get_model_status(m) |
| if yaml_format: |
| return obj_to_yaml(status) |
| else: |
| return obj_to_dict(status) |
| |
| async def update_vca_status(self, vcastatus: dict): |
| """ |
| Add all configs, actions, executed actions of all applications in a model to vcastatus dict. |
| :param vcastatus: dict containing vcaStatus |
| :return: None |
| """ |
| try: |
| for model_name in vcastatus: |
| # Adding executed actions |
| vcastatus[model_name]["executedActions"] = \ |
| await self.libjuju.get_executed_actions(model_name) |
| for application in vcastatus[model_name]["applications"]: |
| # Adding application actions |
| vcastatus[model_name]["applications"][application]["actions"] = \ |
| await self.libjuju.get_actions(application, model_name) |
| # Adding application configs |
| vcastatus[model_name]["applications"][application]["configs"] = \ |
| await self.libjuju.get_application_configs(model_name, application) |
| except Exception as e: |
| self.log.debug("Error in updating vca status: {}".format(str(e))) |
| |
| async def create_execution_environment( |
| self, |
| namespace: str, |
| db_dict: dict, |
| reuse_ee_id: str = None, |
| progress_timeout: float = None, |
| total_timeout: float = None, |
| cloud_name: str = None, |
| credential_name: str = None, |
| ) -> (str, dict): |
| |
| self.log.info( |
| "Creating execution environment. namespace: {}, reuse_ee_id: {}".format( |
| namespace, reuse_ee_id |
| ) |
| ) |
| |
| machine_id = None |
| if reuse_ee_id: |
| model_name, application_name, machine_id = self._get_ee_id_components( |
| ee_id=reuse_ee_id |
| ) |
| else: |
| ( |
| _nsi_id, |
| ns_id, |
| _vnf_id, |
| _vdu_id, |
| _vdu_count, |
| ) = self._get_namespace_components(namespace=namespace) |
| # model name is ns_id |
| model_name = ns_id |
| # application name |
| application_name = self._get_application_name(namespace=namespace) |
| |
| self.log.debug( |
| "model name: {}, application name: {}, machine_id: {}".format( |
| model_name, application_name, machine_id |
| ) |
| ) |
| |
| # create or reuse a new juju machine |
| try: |
| if not await self.libjuju.model_exists(model_name): |
| cloud = cloud_name or self.cloud |
| credential = credential_name or cloud_name if cloud_name else self.cloud |
| await self.libjuju.add_model( |
| model_name, |
| cloud_name=cloud, |
| credential_name=credential |
| ) |
| machine, new = await self.libjuju.create_machine( |
| model_name=model_name, |
| machine_id=machine_id, |
| db_dict=db_dict, |
| progress_timeout=progress_timeout, |
| total_timeout=total_timeout, |
| ) |
| # id for the execution environment |
| ee_id = N2VCJujuConnector._build_ee_id( |
| model_name=model_name, |
| application_name=application_name, |
| machine_id=str(machine.entity_id), |
| ) |
| self.log.debug("ee_id: {}".format(ee_id)) |
| |
| if new: |
| # write ee_id in database |
| self._write_ee_id_db(db_dict=db_dict, ee_id=ee_id) |
| |
| except Exception as e: |
| message = "Error creating machine on juju: {}".format(e) |
| self.log.error(message) |
| raise N2VCException(message=message) |
| |
| # new machine credentials |
| credentials = { |
| "hostname": machine.dns_name, |
| } |
| |
| self.log.info( |
| "Execution environment created. ee_id: {}, credentials: {}".format( |
| ee_id, credentials |
| ) |
| ) |
| |
| return ee_id, credentials |
| |
| async def register_execution_environment( |
| self, |
| namespace: str, |
| credentials: dict, |
| db_dict: dict, |
| progress_timeout: float = None, |
| total_timeout: float = None, |
| cloud_name: str = None, |
| credential_name: str = None, |
| ) -> str: |
| |
| self.log.info( |
| "Registering execution environment. namespace={}, credentials={}".format( |
| namespace, credentials |
| ) |
| ) |
| |
| if credentials is None: |
| raise N2VCBadArgumentsException( |
| message="credentials are mandatory", bad_args=["credentials"] |
| ) |
| if credentials.get("hostname"): |
| hostname = credentials["hostname"] |
| else: |
| raise N2VCBadArgumentsException( |
| message="hostname is mandatory", bad_args=["credentials.hostname"] |
| ) |
| if credentials.get("username"): |
| username = credentials["username"] |
| else: |
| raise N2VCBadArgumentsException( |
| message="username is mandatory", bad_args=["credentials.username"] |
| ) |
| if "private_key_path" in credentials: |
| private_key_path = credentials["private_key_path"] |
| else: |
| # if not passed as argument, use generated private key path |
| private_key_path = self.private_key_path |
| |
| _nsi_id, ns_id, _vnf_id, _vdu_id, _vdu_count = self._get_namespace_components( |
| namespace=namespace |
| ) |
| |
| # model name |
| model_name = ns_id |
| # application name |
| application_name = self._get_application_name(namespace=namespace) |
| |
| # register machine on juju |
| try: |
| if not await self.libjuju.model_exists(model_name): |
| cloud = cloud_name or self.cloud |
| credential = credential_name or cloud_name if cloud_name else self.cloud |
| await self.libjuju.add_model( |
| model_name, |
| cloud_name=cloud, |
| credential_name=credential |
| ) |
| machine_id = await self.libjuju.provision_machine( |
| model_name=model_name, |
| hostname=hostname, |
| username=username, |
| private_key_path=private_key_path, |
| db_dict=db_dict, |
| progress_timeout=progress_timeout, |
| total_timeout=total_timeout, |
| ) |
| except Exception as e: |
| self.log.error("Error registering machine: {}".format(e)) |
| raise N2VCException( |
| message="Error registering machine on juju: {}".format(e) |
| ) |
| |
| self.log.info("Machine registered: {}".format(machine_id)) |
| |
| # id for the execution environment |
| ee_id = N2VCJujuConnector._build_ee_id( |
| model_name=model_name, |
| application_name=application_name, |
| machine_id=str(machine_id), |
| ) |
| |
| self.log.info("Execution environment registered. ee_id: {}".format(ee_id)) |
| |
| return ee_id |
| |
| async def install_configuration_sw( |
| self, |
| ee_id: str, |
| artifact_path: str, |
| db_dict: dict, |
| progress_timeout: float = None, |
| total_timeout: float = None, |
| config: dict = None, |
| num_units: int = 1, |
| ): |
| |
| self.log.info( |
| ( |
| "Installing configuration sw on ee_id: {}, " |
| "artifact path: {}, db_dict: {}" |
| ).format(ee_id, artifact_path, db_dict) |
| ) |
| |
| # check arguments |
| if ee_id is None or len(ee_id) == 0: |
| raise N2VCBadArgumentsException( |
| message="ee_id is mandatory", bad_args=["ee_id"] |
| ) |
| if artifact_path is None or len(artifact_path) == 0: |
| raise N2VCBadArgumentsException( |
| message="artifact_path is mandatory", bad_args=["artifact_path"] |
| ) |
| if db_dict is None: |
| raise N2VCBadArgumentsException( |
| message="db_dict is mandatory", bad_args=["db_dict"] |
| ) |
| |
| try: |
| ( |
| model_name, |
| application_name, |
| machine_id, |
| ) = N2VCJujuConnector._get_ee_id_components(ee_id=ee_id) |
| self.log.debug( |
| "model: {}, application: {}, machine: {}".format( |
| model_name, application_name, machine_id |
| ) |
| ) |
| except Exception: |
| raise N2VCBadArgumentsException( |
| message="ee_id={} is not a valid execution environment id".format( |
| ee_id |
| ), |
| bad_args=["ee_id"], |
| ) |
| |
| # remove // in charm path |
| while artifact_path.find("//") >= 0: |
| artifact_path = artifact_path.replace("//", "/") |
| |
| # check charm path |
| if not self.fs.file_exists(artifact_path, mode="dir"): |
| msg = "artifact path does not exist: {}".format(artifact_path) |
| raise N2VCBadArgumentsException(message=msg, bad_args=["artifact_path"]) |
| |
| if artifact_path.startswith("/"): |
| full_path = self.fs.path + artifact_path |
| else: |
| full_path = self.fs.path + "/" + artifact_path |
| |
| try: |
| await self.libjuju.deploy_charm( |
| model_name=model_name, |
| application_name=application_name, |
| path=full_path, |
| machine_id=machine_id, |
| db_dict=db_dict, |
| progress_timeout=progress_timeout, |
| total_timeout=total_timeout, |
| config=config, |
| num_units=num_units, |
| ) |
| except Exception as e: |
| raise N2VCException( |
| message="Error desploying charm into ee={} : {}".format(ee_id, e) |
| ) |
| |
| self.log.info("Configuration sw installed") |
| |
| async def install_k8s_proxy_charm( |
| self, |
| charm_name: str, |
| namespace: str, |
| artifact_path: str, |
| db_dict: dict, |
| progress_timeout: float = None, |
| total_timeout: float = None, |
| config: dict = None, |
| cloud_name: str = None, |
| credential_name: str = None, |
| ) -> str: |
| """ |
| Install a k8s proxy charm |
| |
| :param charm_name: Name of the charm being deployed |
| :param namespace: collection of all the uuids related to the charm. |
| :param str artifact_path: where to locate the artifacts (parent folder) using |
| the self.fs |
| the final artifact path will be a combination of this artifact_path and |
| additional string from the config_dict (e.g. charm name) |
| :param dict db_dict: where to write into database when the status changes. |
| It contains a dict with |
| {collection: <str>, filter: {}, path: <str>}, |
| e.g. {collection: "nsrs", filter: |
| {_id: <nsd-id>, path: "_admin.deployed.VCA.3"} |
| :param float progress_timeout: |
| :param float total_timeout: |
| :param config: Dictionary with additional configuration |
| :param cloud_name: Cloud Name in which the charms will be deployed |
| :param credential_name: Credential Name to use in the cloud_name. |
| If not set, cloud_name will be used as credential_name |
| |
| :returns ee_id: execution environment id. |
| """ |
| self.log.info('Installing k8s proxy charm: {}, artifact path: {}, db_dict: {}' |
| .format(charm_name, artifact_path, db_dict)) |
| |
| if not self.k8s_cloud: |
| raise JujuK8sProxycharmNotSupported("There is not k8s_cloud available") |
| |
| if artifact_path is None or len(artifact_path) == 0: |
| raise N2VCBadArgumentsException( |
| message="artifact_path is mandatory", bad_args=["artifact_path"] |
| ) |
| if db_dict is None: |
| raise N2VCBadArgumentsException(message='db_dict is mandatory', bad_args=['db_dict']) |
| |
| # remove // in charm path |
| while artifact_path.find('//') >= 0: |
| artifact_path = artifact_path.replace('//', '/') |
| |
| # check charm path |
| if not self.fs.file_exists(artifact_path, mode="dir"): |
| msg = 'artifact path does not exist: {}'.format(artifact_path) |
| raise N2VCBadArgumentsException(message=msg, bad_args=['artifact_path']) |
| |
| if artifact_path.startswith('/'): |
| full_path = self.fs.path + artifact_path |
| else: |
| full_path = self.fs.path + '/' + artifact_path |
| |
| _, ns_id, _, _, _ = self._get_namespace_components(namespace=namespace) |
| model_name = '{}-k8s'.format(ns_id) |
| if not await self.libjuju.model_exists(model_name): |
| cloud = cloud_name or self.k8s_cloud |
| credential = credential_name or cloud_name if cloud_name else self.k8s_cloud |
| await self.libjuju.add_model( |
| model_name, |
| cloud_name=cloud, |
| credential_name=credential |
| ) |
| application_name = self._get_application_name(namespace) |
| |
| try: |
| await self.libjuju.deploy_charm( |
| model_name=model_name, |
| application_name=application_name, |
| path=full_path, |
| machine_id=None, |
| db_dict=db_dict, |
| progress_timeout=progress_timeout, |
| total_timeout=total_timeout, |
| config=config |
| ) |
| except Exception as e: |
| raise N2VCException(message='Error deploying charm: {}'.format(e)) |
| |
| self.log.info('K8s proxy charm installed') |
| ee_id = N2VCJujuConnector._build_ee_id( |
| model_name=model_name, |
| application_name=application_name, |
| machine_id="k8s", |
| ) |
| |
| self._write_ee_id_db(db_dict=db_dict, ee_id=ee_id) |
| |
| return ee_id |
| |
| async def get_ee_ssh_public__key( |
| self, |
| ee_id: str, |
| db_dict: dict, |
| progress_timeout: float = None, |
| total_timeout: float = None, |
| ) -> str: |
| |
| self.log.info( |
| ( |
| "Generating priv/pub key pair and get pub key on ee_id: {}, db_dict: {}" |
| ).format(ee_id, db_dict) |
| ) |
| |
| # check arguments |
| if ee_id is None or len(ee_id) == 0: |
| raise N2VCBadArgumentsException( |
| message="ee_id is mandatory", bad_args=["ee_id"] |
| ) |
| if db_dict is None: |
| raise N2VCBadArgumentsException( |
| message="db_dict is mandatory", bad_args=["db_dict"] |
| ) |
| |
| try: |
| ( |
| model_name, |
| application_name, |
| machine_id, |
| ) = N2VCJujuConnector._get_ee_id_components(ee_id=ee_id) |
| self.log.debug( |
| "model: {}, application: {}, machine: {}".format( |
| model_name, application_name, machine_id |
| ) |
| ) |
| except Exception: |
| raise N2VCBadArgumentsException( |
| message="ee_id={} is not a valid execution environment id".format( |
| ee_id |
| ), |
| bad_args=["ee_id"], |
| ) |
| |
| # try to execute ssh layer primitives (if exist): |
| # generate-ssh-key |
| # get-ssh-public-key |
| |
| output = None |
| |
| application_name = N2VCJujuConnector._format_app_name(application_name) |
| |
| # execute action: generate-ssh-key |
| try: |
| output, _status = await self.libjuju.execute_action( |
| model_name=model_name, |
| application_name=application_name, |
| action_name="generate-ssh-key", |
| db_dict=db_dict, |
| progress_timeout=progress_timeout, |
| total_timeout=total_timeout, |
| ) |
| except Exception as e: |
| self.log.info( |
| "Skipping exception while executing action generate-ssh-key: {}".format( |
| e |
| ) |
| ) |
| |
| # execute action: get-ssh-public-key |
| try: |
| output, _status = await self.libjuju.execute_action( |
| model_name=model_name, |
| application_name=application_name, |
| action_name="get-ssh-public-key", |
| db_dict=db_dict, |
| progress_timeout=progress_timeout, |
| total_timeout=total_timeout, |
| ) |
| except Exception as e: |
| msg = "Cannot execute action get-ssh-public-key: {}\n".format(e) |
| self.log.info(msg) |
| raise N2VCExecutionException(e, primitive_name="get-ssh-public-key") |
| |
| # return public key if exists |
| return output["pubkey"] if "pubkey" in output else output |
| |
| async def get_metrics(self, model_name: str, application_name: str) -> dict: |
| return await self.libjuju.get_metrics(model_name, application_name) |
| |
| async def add_relation( |
| self, ee_id_1: str, ee_id_2: str, endpoint_1: str, endpoint_2: str |
| ): |
| |
| self.log.debug( |
| "adding new relation between {} and {}, endpoints: {}, {}".format( |
| ee_id_1, ee_id_2, endpoint_1, endpoint_2 |
| ) |
| ) |
| |
| # check arguments |
| if not ee_id_1: |
| message = "EE 1 is mandatory" |
| self.log.error(message) |
| raise N2VCBadArgumentsException(message=message, bad_args=["ee_id_1"]) |
| if not ee_id_2: |
| message = "EE 2 is mandatory" |
| self.log.error(message) |
| raise N2VCBadArgumentsException(message=message, bad_args=["ee_id_2"]) |
| if not endpoint_1: |
| message = "endpoint 1 is mandatory" |
| self.log.error(message) |
| raise N2VCBadArgumentsException(message=message, bad_args=["endpoint_1"]) |
| if not endpoint_2: |
| message = "endpoint 2 is mandatory" |
| self.log.error(message) |
| raise N2VCBadArgumentsException(message=message, bad_args=["endpoint_2"]) |
| |
| # get the model, the applications and the machines from the ee_id's |
| model_1, app_1, _machine_1 = self._get_ee_id_components(ee_id_1) |
| model_2, app_2, _machine_2 = self._get_ee_id_components(ee_id_2) |
| |
| # model must be the same |
| if model_1 != model_2: |
| message = "EE models are not the same: {} vs {}".format(ee_id_1, ee_id_2) |
| self.log.error(message) |
| raise N2VCBadArgumentsException( |
| message=message, bad_args=["ee_id_1", "ee_id_2"] |
| ) |
| |
| # add juju relations between two applications |
| try: |
| await self.libjuju.add_relation( |
| model_name=model_1, |
| endpoint_1="{}:{}".format(app_1, endpoint_1), |
| endpoint_2="{}:{}".format(app_2, endpoint_2), |
| ) |
| except Exception as e: |
| message = "Error adding relation between {} and {}: {}".format( |
| ee_id_1, ee_id_2, e |
| ) |
| self.log.error(message) |
| raise N2VCException(message=message) |
| |
| async def remove_relation(self): |
| # TODO |
| self.log.info("Method not implemented yet") |
| raise MethodNotImplemented() |
| |
| async def deregister_execution_environments(self): |
| self.log.info("Method not implemented yet") |
| raise MethodNotImplemented() |
| |
| async def delete_namespace( |
| self, namespace: str, db_dict: dict = None, total_timeout: float = None |
| ): |
| self.log.info("Deleting namespace={}".format(namespace)) |
| |
| # check arguments |
| if namespace is None: |
| raise N2VCBadArgumentsException( |
| message="namespace is mandatory", bad_args=["namespace"] |
| ) |
| |
| _nsi_id, ns_id, _vnf_id, _vdu_id, _vdu_count = self._get_namespace_components( |
| namespace=namespace |
| ) |
| if ns_id is not None: |
| try: |
| models = await self.libjuju.list_models(contains=ns_id) |
| for model in models: |
| await self.libjuju.destroy_model( |
| model_name=model, total_timeout=total_timeout |
| ) |
| except Exception as e: |
| raise N2VCException( |
| message="Error deleting namespace {} : {}".format(namespace, e) |
| ) |
| else: |
| raise N2VCBadArgumentsException( |
| message="only ns_id is permitted to delete yet", bad_args=["namespace"] |
| ) |
| |
| self.log.info("Namespace {} deleted".format(namespace)) |
| |
| async def delete_execution_environment( |
| self, ee_id: str, db_dict: dict = None, total_timeout: float = None, |
| scaling_in: bool = False |
| ): |
| self.log.info("Deleting execution environment ee_id={}".format(ee_id)) |
| |
| # check arguments |
| if ee_id is None: |
| raise N2VCBadArgumentsException( |
| message="ee_id is mandatory", bad_args=["ee_id"] |
| ) |
| |
| model_name, application_name, _machine_id = self._get_ee_id_components( |
| ee_id=ee_id |
| ) |
| try: |
| if not scaling_in: |
| # destroy the model |
| # TODO: should this be removed? |
| await self.libjuju.destroy_model( |
| model_name=model_name, total_timeout=total_timeout |
| ) |
| else: |
| # get juju model and observer |
| controller = await self.libjuju.get_controller() |
| model = await self.libjuju.get_model(controller, model_name) |
| # destroy the application |
| await self.libjuju.destroy_application( |
| model=model, application_name=application_name) |
| except Exception as e: |
| raise N2VCException( |
| message=( |
| "Error deleting execution environment {} (application {}) : {}" |
| ).format(ee_id, application_name, e) |
| ) |
| |
| self.log.info("Execution environment {} deleted".format(ee_id)) |
| |
| async def exec_primitive( |
| self, |
| ee_id: str, |
| primitive_name: str, |
| params_dict: dict, |
| db_dict: dict = None, |
| progress_timeout: float = None, |
| total_timeout: float = None, |
| ) -> str: |
| |
| self.log.info( |
| "Executing primitive: {} on ee: {}, params: {}".format( |
| primitive_name, ee_id, params_dict |
| ) |
| ) |
| |
| # check arguments |
| if ee_id is None or len(ee_id) == 0: |
| raise N2VCBadArgumentsException( |
| message="ee_id is mandatory", bad_args=["ee_id"] |
| ) |
| if primitive_name is None or len(primitive_name) == 0: |
| raise N2VCBadArgumentsException( |
| message="action_name is mandatory", bad_args=["action_name"] |
| ) |
| if params_dict is None: |
| params_dict = dict() |
| |
| try: |
| ( |
| model_name, |
| application_name, |
| _machine_id, |
| ) = N2VCJujuConnector._get_ee_id_components(ee_id=ee_id) |
| except Exception: |
| raise N2VCBadArgumentsException( |
| message="ee_id={} is not a valid execution environment id".format( |
| ee_id |
| ), |
| bad_args=["ee_id"], |
| ) |
| |
| if primitive_name == "config": |
| # Special case: config primitive |
| try: |
| await self.libjuju.configure_application( |
| model_name=model_name, |
| application_name=application_name, |
| config=params_dict, |
| ) |
| actions = await self.libjuju.get_actions( |
| application_name=application_name, model_name=model_name, |
| ) |
| self.log.debug( |
| "Application {} has these actions: {}".format( |
| application_name, actions |
| ) |
| ) |
| if "verify-ssh-credentials" in actions: |
| # execute verify-credentials |
| num_retries = 20 |
| retry_timeout = 15.0 |
| for _ in range(num_retries): |
| try: |
| self.log.debug("Executing action verify-ssh-credentials...") |
| output, ok = await self.libjuju.execute_action( |
| model_name=model_name, |
| application_name=application_name, |
| action_name="verify-ssh-credentials", |
| db_dict=db_dict, |
| progress_timeout=progress_timeout, |
| total_timeout=total_timeout, |
| ) |
| |
| if ok == "failed": |
| self.log.debug( |
| "Error executing verify-ssh-credentials: {}. Retrying..." |
| ) |
| await asyncio.sleep(retry_timeout) |
| |
| continue |
| self.log.debug("Result: {}, output: {}".format(ok, output)) |
| break |
| except asyncio.CancelledError: |
| raise |
| else: |
| self.log.error( |
| "Error executing verify-ssh-credentials after {} retries. ".format( |
| num_retries |
| ) |
| ) |
| else: |
| msg = "Action verify-ssh-credentials does not exist in application {}".format( |
| application_name |
| ) |
| self.log.debug(msg=msg) |
| except Exception as e: |
| self.log.error("Error configuring juju application: {}".format(e)) |
| raise N2VCExecutionException( |
| message="Error configuring application into ee={} : {}".format( |
| ee_id, e |
| ), |
| primitive_name=primitive_name, |
| ) |
| return "CONFIG OK" |
| else: |
| try: |
| output, status = await self.libjuju.execute_action( |
| model_name=model_name, |
| application_name=application_name, |
| action_name=primitive_name, |
| db_dict=db_dict, |
| progress_timeout=progress_timeout, |
| total_timeout=total_timeout, |
| **params_dict |
| ) |
| if status == "completed": |
| return output |
| else: |
| raise Exception("status is not completed: {}".format(status)) |
| except Exception as e: |
| self.log.error( |
| "Error executing primitive {}: {}".format(primitive_name, e) |
| ) |
| raise N2VCExecutionException( |
| message="Error executing primitive {} into ee={} : {}".format( |
| primitive_name, ee_id, e |
| ), |
| primitive_name=primitive_name, |
| ) |
| |
| async def disconnect(self): |
| self.log.info("closing juju N2VC...") |
| try: |
| await self.libjuju.disconnect() |
| except Exception as e: |
| raise N2VCConnectionException( |
| message="Error disconnecting controller: {}".format(e), url=self.url |
| ) |
| |
| """ |
| #################################################################################### |
| ################################### P R I V A T E ################################## |
| #################################################################################### |
| """ |
| |
| def _write_ee_id_db(self, db_dict: dict, ee_id: str): |
| |
| # write ee_id to database: _admin.deployed.VCA.x |
| try: |
| the_table = db_dict["collection"] |
| the_filter = db_dict["filter"] |
| the_path = db_dict["path"] |
| if not the_path[-1] == ".": |
| the_path = the_path + "." |
| update_dict = {the_path + "ee_id": ee_id} |
| # self.log.debug('Writing ee_id to database: {}'.format(the_path)) |
| self.db.set_one( |
| table=the_table, |
| q_filter=the_filter, |
| update_dict=update_dict, |
| fail_on_empty=True, |
| ) |
| except asyncio.CancelledError: |
| raise |
| except Exception as e: |
| self.log.error("Error writing ee_id to database: {}".format(e)) |
| |
| @staticmethod |
| def _build_ee_id(model_name: str, application_name: str, machine_id: str): |
| """ |
| Build an execution environment id form model, application and machine |
| :param model_name: |
| :param application_name: |
| :param machine_id: |
| :return: |
| """ |
| # id for the execution environment |
| return "{}.{}.{}".format(model_name, application_name, machine_id) |
| |
| @staticmethod |
| def _get_ee_id_components(ee_id: str) -> (str, str, str): |
| """ |
| Get model, application and machine components from an execution environment id |
| :param ee_id: |
| :return: model_name, application_name, machine_id |
| """ |
| |
| if ee_id is None: |
| return None, None, None |
| |
| # split components of id |
| parts = ee_id.split(".") |
| model_name = parts[0] |
| application_name = parts[1] |
| machine_id = parts[2] |
| return model_name, application_name, machine_id |
| |
| def _get_application_name(self, namespace: str) -> str: |
| """ |
| Build application name from namespace |
| :param namespace: |
| :return: app-vnf-<vnf id>-vdu-<vdu-id>-cnt-<vdu-count> |
| """ |
| |
| # TODO: Enforce the Juju 50-character application limit |
| |
| # split namespace components |
| _, _, vnf_id, vdu_id, vdu_count = self._get_namespace_components( |
| namespace=namespace |
| ) |
| |
| if vnf_id is None or len(vnf_id) == 0: |
| vnf_id = "" |
| else: |
| # Shorten the vnf_id to its last twelve characters |
| vnf_id = "vnf-" + vnf_id[-12:] |
| |
| if vdu_id is None or len(vdu_id) == 0: |
| vdu_id = "" |
| else: |
| # Shorten the vdu_id to its last twelve characters |
| vdu_id = "-vdu-" + vdu_id[-12:] |
| |
| if vdu_count is None or len(vdu_count) == 0: |
| vdu_count = "" |
| else: |
| vdu_count = "-cnt-" + vdu_count |
| |
| application_name = "app-{}{}{}".format(vnf_id, vdu_id, vdu_count) |
| |
| return N2VCJujuConnector._format_app_name(application_name) |
| |
| def _create_juju_public_key(self): |
| """Recreate the Juju public key on lcm container, if needed |
| Certain libjuju commands expect to be run from the same machine as Juju |
| is bootstrapped to. This method will write the public key to disk in |
| that location: ~/.local/share/juju/ssh/juju_id_rsa.pub |
| """ |
| |
| # Make sure that we have a public key before writing to disk |
| if self.public_key is None or len(self.public_key) == 0: |
| if "OSMLCM_VCA_PUBKEY" in os.environ: |
| self.public_key = os.getenv("OSMLCM_VCA_PUBKEY", "") |
| if len(self.public_key) == 0: |
| return |
| else: |
| return |
| |
| pk_path = "{}/.local/share/juju/ssh".format(os.path.expanduser("~")) |
| file_path = "{}/juju_id_rsa.pub".format(pk_path) |
| self.log.debug( |
| "writing juju public key to file:\n{}\npublic key: {}".format( |
| file_path, self.public_key |
| ) |
| ) |
| if not os.path.exists(pk_path): |
| # create path and write file |
| os.makedirs(pk_path) |
| with open(file_path, "w") as f: |
| self.log.debug("Creating juju public key file: {}".format(file_path)) |
| f.write(self.public_key) |
| else: |
| self.log.debug("juju public key file already exists: {}".format(file_path)) |
| |
| @staticmethod |
| def _format_model_name(name: str) -> str: |
| """Format the name of the model. |
| |
| Model names may only contain lowercase letters, digits and hyphens |
| """ |
| |
| return name.replace("_", "-").replace(" ", "-").lower() |
| |
| @staticmethod |
| def _format_app_name(name: str) -> str: |
| """Format the name of the application (in order to assure valid application name). |
| |
| Application names have restrictions (run juju deploy --help): |
| - contains lowercase letters 'a'-'z' |
| - contains numbers '0'-'9' |
| - contains hyphens '-' |
| - starts with a lowercase letter |
| - not two or more consecutive hyphens |
| - after a hyphen, not a group with all numbers |
| """ |
| |
| def all_numbers(s: str) -> bool: |
| for c in s: |
| if not c.isdigit(): |
| return False |
| return True |
| |
| new_name = name.replace("_", "-") |
| new_name = new_name.replace(" ", "-") |
| new_name = new_name.lower() |
| while new_name.find("--") >= 0: |
| new_name = new_name.replace("--", "-") |
| groups = new_name.split("-") |
| |
| # find 'all numbers' groups and prefix them with a letter |
| app_name = "" |
| for i in range(len(groups)): |
| group = groups[i] |
| if all_numbers(group): |
| group = "z" + group |
| if i > 0: |
| app_name += "-" |
| app_name += group |
| |
| if app_name[0].isdigit(): |
| app_name = "z" + app_name |
| |
| return app_name |