X-Git-Url: https://osm.etsi.org/gitweb/?p=osm%2FN2VC.git;a=blobdiff_plain;f=n2vc%2Fk8s_helm_conn.py;h=01b448b7e97350823f4c7cae81bb0a4874495bea;hp=cd15d73b1d8589260df63bec1fb813619ec1d0df;hb=refs%2Ftags%2Fv7.0.1rc3;hpb=0d648c93b6f03dc221a9e34bfa021003e17f1992 diff --git a/n2vc/k8s_helm_conn.py b/n2vc/k8s_helm_conn.py index cd15d73..01b448b 100644 --- a/n2vc/k8s_helm_conn.py +++ b/n2vc/k8s_helm_conn.py @@ -30,6 +30,7 @@ import yaml from uuid import uuid4 import random from n2vc.k8s_conn import K8sConnector +from n2vc.exceptions import K8sException class K8sHelmConnector(K8sConnector): @@ -83,6 +84,16 @@ class K8sHelmConnector(K8sConnector): self._helm_command = helm_command self._check_file_exists(filename=helm_command, exception_if_not_exists=True) + # initialize helm client-only + self.debug('Initializing helm client-only...') + command = '{} init --client-only'.format(self._helm_command) + try: + asyncio.ensure_future(self._local_async_exec(command=command, raise_exception_on_error=False)) + # loop = asyncio.get_event_loop() + # loop.run_until_complete(self._local_async_exec(command=command, raise_exception_on_error=False)) + except Exception as e: + self.warning(msg='helm init failed (it was already initialized): {}'.format(e)) + self.info('K8S Helm connector initialized') async def init_env( @@ -91,6 +102,17 @@ class K8sHelmConnector(K8sConnector): namespace: str = 'kube-system', reuse_cluster_uuid=None ) -> (str, bool): + """ + It prepares a given K8s cluster environment to run Charts on both sides: + client (OSM) + server (Tiller) + + :param k8s_creds: credentials to access a given K8s cluster, i.e. a valid '.kube/config' + :param namespace: optional namespace to be used for helm. By default, 'kube-system' will be used + :param reuse_cluster_uuid: existing cluster uuid for reuse + :return: uuid of the K8s cluster and True if connector has installed some software in the cluster + (on error, an exception will be raised) + """ cluster_uuid = reuse_cluster_uuid if not cluster_uuid: @@ -186,7 +208,8 @@ class K8sHelmConnector(K8sConnector): kube_dir, helm_dir, config_filename, cluster_dir = \ self._get_paths(cluster_name=cluster_uuid, create_if_not_exist=True) - command = '{} --kubeconfig={} --home={} repo list --output yaml'.format(self._helm_command, config_filename, helm_dir) + command = '{} --kubeconfig={} --home={} repo list --output yaml'\ + .format(self._helm_command, config_filename, helm_dir) output, rc = await self._local_async_exec(command=command, raise_exception_on_error=True) if output and len(output) > 0: @@ -247,7 +270,7 @@ class K8sHelmConnector(K8sConnector): msg = 'Cluster has releases and not force. Cannot reset K8s environment. Cluster uuid: {}'\ .format(cluster_uuid) self.error(msg) - raise Exception(msg) + raise K8sException(msg) if uninstall_sw: @@ -269,7 +292,6 @@ class K8sHelmConnector(K8sConnector): else: msg = 'Tiller deployment not found in cluster {}'.format(cluster_uuid) self.error(msg) - # raise Exception(msg) self.debug('namespace for tiller: {}'.format(namespace)) @@ -310,9 +332,6 @@ class K8sHelmConnector(K8sConnector): self.debug('installing {} in cluster {}'.format(kdu_model, cluster_uuid)) - start = time.time() - end = start + timeout - # config filename kube_dir, helm_dir, config_filename, cluster_dir = \ self._get_paths(cluster_name=cluster_uuid, create_if_not_exist=True) @@ -338,7 +357,7 @@ class K8sHelmConnector(K8sConnector): version_str = '--version {}'.format(parts[1]) kdu_model = parts[0] - # generate a name for the releas. Then, check if already exists + # generate a name for the release. Then, check if already exists kdu_instance = None while kdu_instance is None: kdu_instance = K8sHelmConnector._generate_release_name(kdu_model) @@ -351,7 +370,7 @@ class K8sHelmConnector(K8sConnector): if result is not None: # instance already exists: generate a new one kdu_instance = None - except: + except Exception as e: kdu_instance = None # helm repo install @@ -405,7 +424,7 @@ class K8sHelmConnector(K8sConnector): if rc != 0: msg = 'Error executing command: {}\nOutput: {}'.format(command, output) self.error(msg) - raise Exception(msg) + raise K8sException(msg) self.debug('Returning kdu_instance {}'.format(kdu_instance)) return kdu_instance @@ -450,9 +469,6 @@ class K8sHelmConnector(K8sConnector): self.debug('upgrading {} in cluster {}'.format(kdu_model, cluster_uuid)) - start = time.time() - end = start + timeout - # config filename kube_dir, helm_dir, config_filename, cluster_dir = \ self._get_paths(cluster_name=cluster_uuid, create_if_not_exist=True) @@ -502,7 +518,7 @@ class K8sHelmConnector(K8sConnector): ) # wait for execution task - await asyncio.wait([ exec_task ]) + await asyncio.wait([exec_task]) # cancel status task status_task.cancel() @@ -529,7 +545,7 @@ class K8sHelmConnector(K8sConnector): if rc != 0: msg = 'Error executing command: {}\nOutput: {}'.format(command, output) self.error(msg) - raise Exception(msg) + raise K8sException(msg) # return new revision number instance = await self.get_instance_info(cluster_uuid=cluster_uuid, kdu_instance=kdu_instance) @@ -594,7 +610,7 @@ class K8sHelmConnector(K8sConnector): if rc != 0: msg = 'Error executing command: {}\nOutput: {}'.format(command, output) self.error(msg) - raise Exception(msg) + raise K8sException(msg) # return new revision number instance = await self.get_instance_info(cluster_uuid=cluster_uuid, kdu_instance=kdu_instance) @@ -634,40 +650,47 @@ class K8sHelmConnector(K8sConnector): async def inspect_kdu( self, - kdu_model: str + kdu_model: str, + repo_url: str = None ) -> str: - self.debug('inspect kdu_model {}'.format(kdu_model)) + self.debug('inspect kdu_model {} from (optional) repo: {}'.format(kdu_model, repo_url)) - command = '{} inspect values {}'\ - .format(self._helm_command, kdu_model) + return await self._exec_inspect_comand(inspect_command='', kdu_model=kdu_model, repo_url=repo_url) - output, rc = await self._local_async_exec(command=command) + async def values_kdu( + self, + kdu_model: str, + repo_url: str = None + ) -> str: - return output + self.debug('inspect kdu_model values {} from (optional) repo: {}'.format(kdu_model, repo_url)) + + return await self._exec_inspect_comand(inspect_command='values', kdu_model=kdu_model, repo_url=repo_url) async def help_kdu( self, - kdu_model: str - ): + kdu_model: str, + repo_url: str = None + ) -> str: - self.debug('help kdu_model {}'.format(kdu_model)) + self.debug('inspect kdu_model {} readme.md from repo: {}'.format(kdu_model, repo_url)) - command = '{} inspect readme {}'\ - .format(self._helm_command, kdu_model) - - output, rc = await self._local_async_exec(command=command, raise_exception_on_error=True) - - return output + return await self._exec_inspect_comand(inspect_command='readme', kdu_model=kdu_model, repo_url=repo_url) async def status_kdu( self, cluster_uuid: str, kdu_instance: str - ): - - return await self._status_kdu(cluster_uuid=cluster_uuid, kdu_instance=kdu_instance, show_error_log=True) + ) -> str: + # call internal function + return await self._status_kdu( + cluster_uuid=cluster_uuid, + kdu_instance=kdu_instance, + show_error_log=True, + return_text=True + ) """ ################################################################################################## @@ -675,11 +698,32 @@ class K8sHelmConnector(K8sConnector): ################################################################################################## """ + async def _exec_inspect_comand( + self, + inspect_command: str, + kdu_model: str, + repo_url: str = None + ): + + repo_str = '' + if repo_url: + repo_str = ' --repo {}'.format(repo_url) + idx = kdu_model.find('/') + if idx >= 0: + idx += 1 + kdu_model = kdu_model[idx:] + + inspect_command = '{} inspect {} {}{}'.format(self._helm_command, inspect_command, kdu_model, repo_str) + output, rc = await self._local_async_exec(command=inspect_command, encode_utf8=True) + + return output + async def _status_kdu( self, cluster_uuid: str, kdu_instance: str, - show_error_log: bool = False + show_error_log: bool = False, + return_text: bool = False ): self.debug('status of kdu_instance {}'.format(kdu_instance)) @@ -697,6 +741,9 @@ class K8sHelmConnector(K8sConnector): show_error_log=show_error_log ) + if return_text: + return str(output) + if rc != 0: return None @@ -734,6 +781,15 @@ class K8sHelmConnector(K8sConnector): def _generate_release_name( chart_name: str ): + # check embeded chart (file or dir) + if chart_name.startswith('/'): + # extract file or directory name + chart_name = chart_name[chart_name.rfind('/')+1:] + # check URL + elif '://' in chart_name: + # extract last portion of URL + chart_name = chart_name[chart_name.rfind('/')+1:] + name = '' for c in chart_name: if c.isalpha() or c.isnumeric(): @@ -752,7 +808,7 @@ class K8sHelmConnector(K8sConnector): def get_random_number(): r = random.randrange(start=1, stop=99999999) s = str(r) - s = s.rjust(width=10, fillchar=' ') + s = s.rjust(10, '0') return s name = name + get_random_number() @@ -800,7 +856,7 @@ class K8sHelmConnector(K8sConnector): kdu_instance: str ) -> bool: - status = await self.status_kdu(cluster_uuid=cluster_uuid, kdu_instance=kdu_instance) + status = await self._status_kdu(cluster_uuid=cluster_uuid, kdu_instance=kdu_instance, return_text=False) # extract info.status.resources-> str # format: @@ -877,7 +933,6 @@ class K8sHelmConnector(K8sConnector): # params for use in -f file # returns values file option and filename (in order to delete it at the end) def _params_to_file_option(self, cluster_uuid: str, params: dict) -> (str, str): - params_str = '' if params and len(params) > 0: kube_dir, helm_dir, config_filename, cluster_dir = \ @@ -969,7 +1024,7 @@ class K8sHelmConnector(K8sConnector): if not os.path.exists(cluster_dir): msg = 'Base cluster dir {} does not exist'.format(cluster_dir) self.error(msg) - raise Exception(msg) + raise K8sException(msg) # kube dir kube_dir = cluster_dir + '/' + '.kube' @@ -979,7 +1034,7 @@ class K8sHelmConnector(K8sConnector): if not os.path.exists(kube_dir): msg = 'Kube config dir {} does not exist'.format(kube_dir) self.error(msg) - raise Exception(msg) + raise K8sException(msg) # helm home dir helm_dir = cluster_dir + '/' + '.helm' @@ -989,7 +1044,7 @@ class K8sHelmConnector(K8sConnector): if not os.path.exists(helm_dir): msg = 'Helm config dir {} does not exist'.format(helm_dir) self.error(msg) - raise Exception(msg) + raise K8sException(msg) config_filename = kube_dir + '/config' return kube_dir, helm_dir, config_filename, cluster_dir @@ -1022,7 +1077,8 @@ class K8sHelmConnector(K8sConnector): self, command: str, raise_exception_on_error: bool = False, - show_error_log: bool = True + show_error_log: bool = True, + encode_utf8: bool = False ) -> (str, int): command = K8sHelmConnector._remove_multiple_spaces(command) @@ -1046,8 +1102,10 @@ class K8sHelmConnector(K8sConnector): output = '' if stdout: output = stdout.decode('utf-8').strip() + # output = stdout.decode() if stderr: output = stderr.decode('utf-8').strip() + # output = stderr.decode() if return_code != 0 and show_error_log: self.debug('Return code (FAIL): {}\nOutput:\n{}'.format(return_code, output)) @@ -1057,13 +1115,20 @@ class K8sHelmConnector(K8sConnector): if raise_exception_on_error and return_code != 0: raise Exception(output) + if encode_utf8: + output = output.encode('utf-8').strip() + output = str(output).replace('\\n', '\n') + return output, return_code except Exception as e: msg = 'Exception executing command: {} -> {}'.format(command, e) if show_error_log: self.error(msg) - return '', -1 + if raise_exception_on_error: + raise e + else: + return '', -1 def _remote_exec( self, @@ -1101,5 +1166,4 @@ class K8sHelmConnector(K8sConnector): msg = 'File {} does not exist'.format(filename) if exception_if_not_exists: self.error(msg) - raise Exception(msg) - + raise K8sException(msg)