mas-cli 5.1.4__py3-none-any.whl

mas/cli/update/argParser.py

@@ -0,0 +1,156 @@
+# *****************************************************************************
+# Copyright (c) 2024 IBM Corporation and other Contributors.
+#
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v1.0
+# which accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+#
+# *****************************************************************************
+
+import argparse
+
+from .. import __version__ as packageVersion
+from ..cli import getHelpFormatter
+
+updateArgParser = argparse.ArgumentParser(
+    prog='mas update',
+    description="\n".join([
+        f"IBM Maximo Application Suite Admin CLI v{packageVersion}",
+        "Update the IBM Maximo Operator Catalog, and related MAS dependencies by configuring and launching the MAS Update Tekton Pipeline.\n",
+        "Interactive Mode:",
+        "Omitting the --catalog option will trigger an interactive prompt"
+    ]),
+    epilog="Refer to the online documentation for more information: https://ibm-mas.github.io/cli/",
+    formatter_class=getHelpFormatter(),
+    add_help=False
+)
+
+masArgGroup = updateArgParser.add_argument_group('Catalog Selection')
+masArgGroup.add_argument(
+    '-c', '--catalog',
+    dest='mas_catalog_version',
+    required=False,
+    help="Maximo Operator Catalog Version (e.g. v9-240625-amd64)"
+)
+
+depsArgGroup = updateArgParser.add_argument_group('Update Dependencies')
+depsArgGroup.add_argument(
+    '--db2-namespace',
+    required=False,
+    help="Namespace where Db2u operator and instances will be updated",
+)
+
+depsArgGroup.add_argument(
+    '--mongodb-namespace',
+    required=False,
+    help="Namespace where MongoCE operator and instances will be updated",
+)
+
+depsArgGroup.add_argument(
+    '--mongodb-v5-upgrade',
+    required=False,
+    action="store_const",
+    const="true",
+    help="Required to confirm a major version update for MongoDb to version 5",
+)
+
+depsArgGroup.add_argument(
+    '--mongodb-v6-upgrade',
+    required=False,
+    action="store_const",
+    const="true",
+    help="Required to confirm a major version update for MongoDb to version 6",
+)
+
+depsArgGroup.add_argument(
+    '--mongodb-v7-upgrade',
+    required=False,
+    action="store_const",
+    const="true",
+    help="Required to confirm a major version update for MongoDb to version 7",
+)
+
+depsArgGroup.add_argument(
+    '--kafka-namespace',
+    required=False,
+    help="Namespace where Kafka operator and instances will be updated",
+)
+
+depsArgGroup.add_argument(
+    '--kafka-provider',
+    required=False,
+    choices=["redhat", "strimzi"],
+    help="The type of Kakfa operator installed in the target namespace for updte",
+)
+
+droArgGroup = updateArgParser.add_argument_group('UDS to DRO Migration')
+
+droArgGroup.add_argument(
+    '--dro-migration',
+    required=False,
+    help="Required to confirm the migration from IBM User Data Services (UDS) to IBM Data Reporter Operator (DRO)",
+)
+
+droArgGroup.add_argument(
+    '--dro-storage-class',
+    required=False,
+    help="Set Custom RWO Storage Class name for DRO as part of the update",
+)
+
+droArgGroup.add_argument(
+    '--dro-namespace',
+    required=False,
+    help="Set Custom Namespace for DRO(Default: redhat-marketplace)",
+)
+
+# Development Mode
+# -----------------------------------------------------------------------------
+devArgGroup = updateArgParser.add_argument_group("Development Mode")
+devArgGroup.add_argument(
+    "--artifactory-username",
+    required=False,
+    help="Username for access to development builds on Artifactory"
+)
+devArgGroup.add_argument(
+    "--artifactory-token",
+    required=False,
+    help="API Token for access to development builds on Artifactory"
+)
+
+# More Options
+# -----------------------------------------------------------------------------
+otherArgGroup = updateArgParser.add_argument_group('More')
+otherArgGroup.add_argument(
+    "--dev-mode",
+    required=False,
+    action="store_true",
+    default=False,
+    help="Configure installation for development mode",
+)
+otherArgGroup.add_argument(
+    "--cp4d-version",
+    dest="cpd_product_version",
+    required=False,
+    help="Product version of CP4D to use"
+)
+otherArgGroup.add_argument(
+    '--no-confirm',
+    required=False,
+    action='store_true',
+    default=False,
+    help="Launch the upgrade without prompting for confirmation",
+)
+otherArgGroup.add_argument(
+    '--skip-pre-check',
+    required=False,
+    action='store_true',
+    default=False,
+    help="Skips the 'pre-update-check' and 'post-update-verify' tasks in the update pipeline",
+)
+otherArgGroup.add_argument(
+    '-h', "--help",
+    action='help',
+    default=False,
+    help="Show this help message and exit",
+)

mas/cli/upgrade/__init__.py

@@ -0,0 +1,11 @@
+# *****************************************************************************
+# Copyright (c) 2024 IBM Corporation and other Contributors.
+#
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v1.0
+# which accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+#
+# *****************************************************************************
+
+from ..cli import BaseApp  # noqa: F401

mas/cli/upgrade/app.py

@@ -0,0 +1,164 @@
+#!/usr/bin/env python
+# *****************************************************************************
+# Copyright (c) 2024 IBM Corporation and other Contributors.
+#
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v1.0
+# which accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+#
+# *****************************************************************************
+
+import sys
+import logging
+import logging.handlers
+from prompt_toolkit import prompt, print_formatted_text, HTML
+from prompt_toolkit.completion import WordCompleter
+
+from halo import Halo
+
+from ..cli import BaseApp
+from ..validators import InstanceIDValidator
+from .argParser import upgradeArgParser
+from .settings import UpgradeSettingsMixin
+
+from mas.devops.ocp import createNamespace
+from mas.devops.mas import listMasInstances, getMasChannel, getWorkspaceId, verifyAppInstance
+from mas.devops.tekton import installOpenShiftPipelines, updateTektonDefinitions, launchUpgradePipeline
+
+logger = logging.getLogger(__name__)
+
+
+class UpgradeApp(BaseApp, UpgradeSettingsMixin):
+    def upgrade(self, argv):
+        """
+        Upgrade MAS instance
+        """
+        args = upgradeArgParser.parse_args(args=argv)
+        instanceId = args.mas_instance_id
+        self.noConfirm = args.no_confirm
+        self.skipPreCheck = args.skip_pre_check
+        self.licenseAccepted = args.accept_license
+        self.devMode = args.dev_mode
+
+        if instanceId is None:
+            self.printH1("Set Target OpenShift Cluster")
+            # Connect to the target cluster
+            self.connect()
+        else:
+            logger.debug("MAS instance ID is set, so we assume already connected to the desired OCP")
+            # Need to lookup target architecture because configDb2 will try to access self.architecture
+            self.lookupTargetArchitecture()
+
+        if self.dynamicClient is None:
+            print_formatted_text(HTML("<Red>Error: The Kubernetes dynamic Client is not available.  See log file for details</Red>"))
+            sys.exit(1)
+
+        if instanceId is None:
+            # Interactive mode
+            self.printH1("Instance Selection")
+            print_formatted_text(HTML("<LightSlateGrey>Select a MAS instance to upgrade from the list below:</LightSlateGrey>"))
+            suites = listMasInstances(self.dynamicClient)
+            suiteOptions = []
+
+            if len(suites) == 0:
+                print_formatted_text(HTML("<Red>Error: No MAS instances detected on this cluster</Red>"))
+                sys.exit(1)
+
+            for suite in suites:
+                print_formatted_text(HTML(f"- <u>{suite['metadata']['name']}</u> v{suite['status']['versions']['reconciled']}"))
+                suiteOptions.append(suite['metadata']['name'])
+
+            suiteCompleter = WordCompleter(suiteOptions)
+            print()
+            instanceId = prompt(HTML('<Yellow>Enter MAS instance ID: </Yellow>'), completer=suiteCompleter, validator=InstanceIDValidator(), validate_while_typing=False)
+
+        currentChannel = getMasChannel(self.dynamicClient, instanceId)
+        if currentChannel is not None:
+            if self.devMode:
+                # This is mainly used for the scenario where Manage Foundation would be installed, because core-upgrade does not use the value of nextChannel,
+                # it uses a compatibility_matrix object in ansible-devops to determine the next channel, so nextChannel is only informative for core upgrade purposes
+                nextChannel = prompt(HTML('<Yellow>Custom channel</Yellow> '))
+            else:
+                if currentChannel not in self.upgrade_path:
+                    self.fatalError(f"No upgrade available, {instanceId} is are already on the latest release {currentChannel}")
+                nextChannel = self.upgrade_path[currentChannel]
+        else:
+            # We still allow the upgrade to proceed even though we can't detect the MAS instance.  The upgrade may be being
+            # queued up to run after install for instance
+            currentChannel = "Unknown"
+            nextChannel = "Unknown"
+
+        if not self.licenseAccepted and not self.devMode:
+            self.printH1("License Terms")
+            self.printDescription([
+                "To continue with the upgrade, you must accept the license terms:",
+                self.licenses[nextChannel]
+            ])
+
+            if self.noConfirm:
+                self.fatalError("You must accept the license terms with --accept-license when using the --no-confirm flag")
+            else:
+                if not self.yesOrNo("Do you accept the license terms"):
+                    exit(1)
+
+        # The only scenario where Manage Foundation needs to be installed during an upgrade is from 9.0.x to 9.1.x (if Manage was not already installed in 9.0.x).
+        self.setParam("should_install_manage_foundation", "false")
+        if nextChannel.startswith("9.1") and not verifyAppInstance(self.dynamicClient, instanceId, "manage"):
+            self.manageAppName = "Manage foundation"
+            self.showAdvancedOptions = False
+            self.installIoT = False
+            self.installFacilities = False
+            self.installManage = True
+            self.isManageFoundation = True
+            self.printDescription([f"{self.manageAppName} installs the following capabilities: User, Security groups, Application configurator and Mobile configurator."])
+            self.printH1("Configure IBM Container Registry")
+            self.promptForString("IBM entitlement key", "ibm_entitlement_key", isPassword=True)
+            if self.devMode:
+                self.promptForString("Artifactory username", "artifactory_username")
+                self.promptForString("Artifactory token", "artifactory_token", isPassword=True)
+            self.setParam("should_install_manage_foundation", "true")
+            self.setParam("mas_appws_components", "")
+            self.setParam("mas_app_settings_aio_flag", "false")
+            self.setParam("mas_app_channel_manage", nextChannel)
+            self.setParam("mas_workspace_id", getWorkspaceId(self.dynamicClient, instanceId))
+            # It has been decided that we don't need to ask for any specific Manage Settings
+            # self.manageSettings()
+            self.configDb2(silentMode=True)
+
+        self.printH1("Review Settings")
+        print_formatted_text(HTML(f"<LightSlateGrey>Instance ID ..................... {instanceId}</LightSlateGrey>"))
+        print_formatted_text(HTML(f"<LightSlateGrey>Current MAS Channel ............. {currentChannel}</LightSlateGrey>"))
+        print_formatted_text(HTML(f"<LightSlateGrey>Next MAS Channel ................ {nextChannel}</LightSlateGrey>"))
+        print_formatted_text(HTML(f"<LightSlateGrey>Skip Pre-Upgrade Checks ......... {self.skipPreCheck}</LightSlateGrey>"))
+
+        if not self.noConfirm:
+            print()
+            continueWithUpgrade = self.yesOrNo("Proceed with these settings")
+
+        if self.noConfirm or continueWithUpgrade:
+            self.createTektonFileWithDigest()
+
+            self.printH1("Launch Upgrade")
+            pipelinesNamespace = f"mas-{instanceId}-pipelines"
+
+            with Halo(text='Validating OpenShift Pipelines installation', spinner=self.spinner) as h:
+                installOpenShiftPipelines(self.dynamicClient)
+                h.stop_and_persist(symbol=self.successIcon, text="OpenShift Pipelines Operator is installed and ready to use")
+
+            with Halo(text=f'Preparing namespace ({pipelinesNamespace})', spinner=self.spinner) as h:
+                createNamespace(self.dynamicClient, pipelinesNamespace)
+                h.stop_and_persist(symbol=self.successIcon, text=f"Namespace is ready ({pipelinesNamespace})")
+
+            with Halo(text=f'Installing latest Tekton definitions (v{self.version})', spinner=self.spinner) as h:
+                updateTektonDefinitions(pipelinesNamespace, self.tektonDefsPath)
+                h.stop_and_persist(symbol=self.successIcon, text=f"Latest Tekton definitions are installed (v{self.version})")
+
+            with Halo(text='Submitting PipelineRun for {instanceId} upgrade', spinner=self.spinner) as h:
+                pipelineURL = launchUpgradePipeline(self.dynamicClient, instanceId, self.skipPreCheck, params=self.params)
+                if pipelineURL is not None:
+                    h.stop_and_persist(symbol=self.successIcon, text=f"PipelineRun for {instanceId} upgrade submitted")
+                    print_formatted_text(HTML(f"\nView progress:\n  <Cyan><u>{pipelineURL}</u></Cyan>\n"))
+                else:
+                    h.stop_and_persist(symbol=self.failureIcon, text=f"Failed to submit PipelineRun for {instanceId} upgrade, see log file for details")
+                    print()

mas/cli/upgrade/argParser.py

@@ -0,0 +1,68 @@
+# *****************************************************************************
+# Copyright (c) 2024 IBM Corporation and other Contributors.
+#
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v1.0
+# which accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+#
+# *****************************************************************************
+
+import argparse
+
+from .. import __version__ as packageVersion
+from ..cli import getHelpFormatter
+
+upgradeArgParser = argparse.ArgumentParser(
+    prog='mas upgrade',
+    description="\n".join([
+        f"IBM Maximo Application Suite Admin CLI v{packageVersion}",
+        "Upgrade MAS by configuring and launching the MAS Upgrade Tekton Pipeline.\n",
+        "Interactive Mode:",
+        "Omitting the --instance-id option will trigger an interactive prompt"
+    ]),
+    epilog="Refer to the online documentation for more information: https://ibm-mas.github.io/cli/",
+    formatter_class=getHelpFormatter(),
+    add_help=False
+)
+
+masArgGroup = upgradeArgParser.add_argument_group('MAS Instance Selection')
+masArgGroup.add_argument(
+    '--mas-instance-id',
+    required=False,
+    help="The MAS instance ID to be upgraded"
+)
+otherArgGroup = upgradeArgParser.add_argument_group('More')
+otherArgGroup.add_argument(
+    '--skip-pre-check',
+    required=False,
+    action='store_true',
+    default=False,
+    help="Disable the 'pre-upgrade-check' and 'post-upgrade-verify' tasks in the upgrade pipeline"
+)
+otherArgGroup.add_argument(
+    '--no-confirm',
+    required=False,
+    action='store_true',
+    default=False,
+    help="Launch the upgrade without prompting for confirmation",
+)
+otherArgGroup.add_argument(
+    "--accept-license",
+    action="store_true",
+    default=False,
+    help="Accept all license terms without prompting"
+)
+otherArgGroup.add_argument(
+    "--dev-mode",
+    required=False,
+    action="store_true",
+    default=False,
+    help="Configure upgrade for development mode",
+)
+otherArgGroup.add_argument(
+    '-h', "--help",
+    action='help',
+    default=False,
+    help="Show this help message and exit",
+)

mas/cli/upgrade/settings/__init__.py

@@ -0,0 +1,19 @@
+# *****************************************************************************
+# Copyright (c) 2025 IBM Corporation and other Contributors.
+#
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v1.0
+# which accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+#
+# *****************************************************************************
+
+from ...install.settings.db2Settings import Db2SettingsMixin
+from ...install.settings.manageSettings import ManageSettingsMixin
+
+
+class UpgradeSettingsMixin(Db2SettingsMixin, ManageSettingsMixin):
+    """
+    This class collects all the Mixins providing interactive prompts for mas-upgrade
+    """
+    pass

mas/cli/validators.py

@@ -0,0 +1,151 @@
+# *****************************************************************************
+# Copyright (c) 2024 IBM Corporation and other Contributors.
+#
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v1.0
+# which accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+#
+# *****************************************************************************
+
+from re import match
+from os import path
+from json import loads, JSONDecodeError
+
+# Use of the openshift client rather than the kubernetes client allows us access to "apply"
+from openshift import dynamic
+from kubernetes import config
+from kubernetes.client import api_client
+
+from prompt_toolkit.validation import Validator, ValidationError
+
+from mas.devops.ocp import getStorageClass
+from mas.devops.mas import verifyMasInstance
+
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+class InstanceIDFormatValidator(Validator):
+    def validate(self, document):
+        """
+        Validate that a MAS instance ID exists on the target cluster
+        """
+        instanceId = document.text
+
+        if not match(r"^[a-z][a-z0-9-]{1,10}[a-z0-9]$", instanceId):
+            raise ValidationError(message='MAS instance ID does not meet the requirements', cursor_position=len(instanceId))
+
+
+class WorkspaceIDFormatValidator(Validator):
+    def validate(self, document):
+        """
+        Validate that a MAS instance ID exists on the target cluster
+        """
+        instanceId = document.text
+
+        if not match(r"^[a-z][a-z0-9]{2,11}$", instanceId):
+            raise ValidationError(message='Workspace ID does not meet the requirements', cursor_position=len(instanceId))
+
+
+class TimeoutFormatValidator(Validator):
+    def validate(self, document):
+        """
+        Validate that a MAS instance ID exists on the target cluster
+        """
+        string_to_validate = document.text
+        if string_to_validate != "" and not match(r'^([0-9]+)([hm])$', string_to_validate):
+            message = f"Error: Your input: {string_to_validate} does not meet the required pattern. Please use it in hours or minutes format (e.g., 12h, 12m)."
+            raise ValidationError(message=message, cursor_position=len(string_to_validate))
+
+
+class WorkspaceNameFormatValidator(Validator):
+    def validate(self, document):
+        """
+        Validate that a MAS instance ID exists on the target cluster
+        """
+        instanceId = document.text
+
+        if not match(r"^.{3,300}$", instanceId):
+            raise ValidationError(message='Workspace name does not meet the requirements', cursor_position=len(instanceId))
+
+
+class InstanceIDValidator(Validator):
+    def validate(self, document):
+        """
+        Validate that a MAS instance ID exists on the target cluster
+        """
+        instanceId = document.text
+
+        dynClient = dynamic.DynamicClient(
+            api_client.ApiClient(configuration=config.load_kube_config())
+        )
+        if not verifyMasInstance(dynClient, instanceId):
+            raise ValidationError(message='Not a valid MAS instance ID on this cluster', cursor_position=len(instanceId))
+
+
+class StorageClassValidator(Validator):
+    def validate(self, document):
+        """
+        Validate that a StorageClass exists on the target cluster
+        """
+        name = document.text
+
+        dynClient = dynamic.DynamicClient(
+            api_client.ApiClient(configuration=config.load_kube_config())
+        )
+        if getStorageClass(dynClient, name) is None:
+            raise ValidationError(message='Specified storage class is not available on this cluster', cursor_position=len(name))
+
+
+class YesNoValidator(Validator):
+    def validate(self, document):
+        """
+        Validate that a response is understandable as a yes/no response
+        """
+        response = document.text
+        if response.lower() not in ["y", "n", "yes", "no"]:
+            raise ValidationError(message='Enter a valid response: y(es), n(o)', cursor_position=len(response))
+
+
+class FileExistsValidator(Validator):
+    def validate(self, document):
+        """
+        Validate that a file exists on the local system
+        """
+        response = document.text
+        if not path.isfile(response):
+            raise ValidationError(message=f"{response} does not exist, or is not a file", cursor_position=len(response))
+
+
+class DirectoryExistsValidator(Validator):
+    def validate(self, document):
+        """
+        Validate that a file exists on the local system
+        """
+        response = document.text
+        if not path.isdir(response):
+            raise ValidationError(message=f"{response} does not exist, or is not a directory", cursor_position=len(response))
+
+
+class OptimizerInstallPlanValidator(Validator):
+    def validate(self, document):
+        """
+        Validate that a response is a valid install plan for Optimizer
+        """
+        response = document.text
+        if response not in ["full", "limited"]:
+            raise ValidationError(message='Enter a valid response: full, limited', cursor_position=len(response))
+
+
+class JsonValidator(Validator):
+    def validate(self, document):
+        """
+        Validate that a response is a valid JSON
+        """
+        inputJson = document.text
+        try:
+            loads(inputJson)
+        except JSONDecodeError:
+            raise (ValidationError(message='Enter a valid JSON', cursor_position=len(inputJson)))

mas_cli-5.1.4.data/scripts/mas-cli

@@ -0,0 +1,87 @@
+#!python
+# *****************************************************************************
+# Copyright (c) 2024 IBM Corporation and other Contributors.
+#
+# All rights reserved. This program and the accompanying materials
+# are made available under the terms of the Eclipse Public License v1.0
+# which accompanies this distribution, and is available at
+# http://www.eclipse.org/legal/epl-v10.html
+#
+# *****************************************************************************
+
+import logging
+import logging.handlers
+from sys import argv
+
+from mas.cli import __version__ as VERSION
+from mas.cli.install.app import InstallApp
+from mas.cli.aiservice.install.app import AiServiceInstallApp
+from mas.cli.update.app import UpdateApp
+from mas.cli.upgrade.app import UpgradeApp
+from mas.cli.uninstall.app import UninstallApp
+
+from prompt_toolkit import HTML, print_formatted_text
+from urllib3.exceptions import MaxRetryError
+from jinja2.exceptions import TemplateNotFound
+from kubeconfig.exceptions import KubectlCommandError
+from kubernetes.client.exceptions import ApiException
+
+logger = logging.getLogger(__name__)
+
+
+def usage():
+    print_formatted_text(HTML(""))
+
+    print_formatted_text(HTML(f"\n<u>IBM Maximo Application Suite Admin CLI v{VERSION}</u>"))
+    print_formatted_text(HTML("Powered by <DarkGoldenRod><u>https://github.com/ibm-mas/ansible-devops/</u></DarkGoldenRod> and <DarkGoldenRod><u>https://tekton.dev/</u></DarkGoldenRod>"))
+    print("")
+    print_formatted_text(HTML("Important Notice:\nThis standalone CLI (<ForestGreen>mas-cli</ForestGreen>) is still in beta state, not all functions supported by the <ForestGreen>mas</ForestGreen> function in quay.io/ibmmas/cli are supported yet"))
+    print("")
+    print_formatted_text(HTML(
+        "<b>MAS Management Actions:</b>\n"
+        + " - <ForestGreen>mas-cli install</ForestGreen>   Install IBM Maximo Application Suite\n"  # noqa: W503
+        + " - <ForestGreen>mas-cli update</ForestGreen>    Apply updates and security fixes\n"  # noqa: W503
+        + " - <ForestGreen>mas-cli upgrade</ForestGreen>   Upgrade to a new MAS release\n"  # noqa: W503
+        + " - <ForestGreen>mas-cli uninstall</ForestGreen> Remove MAS from the cluster\n"  # noqa: W503
+
+    ))
+    print_formatted_text(HTML("For usage information run <ForestGreen>mas-cli [action] --help</ForestGreen>\n"))
+
+
+if __name__ == '__main__':
+    try:
+        function = argv[1]
+
+        if function == "install":
+            app = InstallApp()
+            app.install(argv[2:])
+        elif function == "aiservice-install":
+            app = AiServiceInstallApp()
+            app.install(argv[2:])
+        elif function == "uninstall":
+            app = UninstallApp()
+            app.uninstall(argv[2:])
+        elif function == "update":
+            app = UpdateApp()
+            app.update(argv[2:])
+        elif function == "upgrade":
+            app = UpgradeApp()
+            app.upgrade(argv[2:])
+        elif function in ["-h", "--help"]:
+            usage()
+            exit(0)
+        else:
+            usage()
+            print_formatted_text(HTML(f"<Red>Unknown action: {function}</Red>\n"))
+            exit(1)
+
+    except KeyboardInterrupt:
+        pass
+    except ApiException as e:
+        app.fatalError(message=f"[{e.status}:{e.reason}] {e.summary()}")
+    except MaxRetryError as e:
+        app.fatalError(message="Unable to connect to API server", exception=e)
+    except TemplateNotFound as e:
+        app.fatalError("Could not find template", exception=e)
+    except KubectlCommandError as e:
+        app.fatalError("Could not execute kubectl command", exception=e)