How to's
Initial Setup
11min
below you will find the step by step guide for the initial setup as well as the typical operational flow please make sure to follow the installation guide docid\ f b2z9q2btzrpc8nttw7h here before the initial setup step 1 login go to your preferred browser and access the kubeark platform at https //yourdomain kubeark com enter your credentials received from the organzation administrator (or directly from kubeark) if the authentication is successful, you will be taken to the kubeark's platform dashboard where you will see all possible menus and actions according to your role step 2 cluster configuration according to the operational flow, the first logical step to take in developing your specific deployment is to define the cluster configuration on the left hand side of the main platform interface, go to the cluster management menu select clusters and here you will find a list with all predefined clusters according to your license and organizational settings look for your preferred cluster in the list and make sure the status is set to active here you will also find the add existing cluster option this menu will open a configuration page where you will be able to add all the attributes for your new cluster detailed information about creating a cluster is available here clusters docid\ icq1cxzqv6obezzz ynve step 3 template management once you have selected your clusters, you will need to setup your deployment templates, which can be organized in template groups kubeark uses groups as a fundamental aspect of the deployment management system this acts as a top layer which allows you to track and manage multiple connected apps and deployments in a single, manageable unit go to the template management menu on the left hand side of your platform interface here you will find the groups and the deployments menus first, letโs create a new template group select groups > create template group detailed information for creating a new template group as well as the mandatory and optional attributes, can be found here template groups docid\ k kbpnulstc8byjkkhttx once you have added all the attributes, click on save your newly created template group will appear on the list now, letโs start adding templates to the newly created group select your new group from the list and here you will see the templates list select the create template option templates can be added to your group in multiple ways kubeark platform will display the following options create template this is the option for creating a template from scratch, using text fields and attributes detailed information for creating a new template, as well as an explanation of the mandatory and optional attributes, can be found here templates (kubernetes) docid\ eud4ozb9ivs8 u3ww7 fa upload template this option allows you to create a new template by uploading a configuration file click or drag a file to the highlighted area and select upload raw edit this option opens an on screen code editor for manually adding your configuration attributes once you have added your configuration, click on validate template and then save for uploading a template from a configuration file, the only accepted format is json for manually configuring the templates using the raw edit option, the accepted configuration formats are yaml and json great! we have created a new template group and we have now added our preferred templates to the group all of our templates will show on the list under the groups menu next, letโs learn how to deploy the templates we have just created letโs deploy our new template step 1 select your preferred group the groups option on the main template management menu displays a list of all your template groups step 2 select your preferred template from the list once you have selected a group, a list of all your templates will display step 3 select the deploy template option this is the template details page which shows relevant status information about each deployment step 4 manage your deployments from the templates management main menu, select deployments here you will see a list of all your deployments as well as relevant information such as status, resource utilization and others select your newly created deployment and validate all your deployment details for consistency the available menu displays information about the resources , details , update , revision and metrics resources this category displays information about the deployment status, name, api version, type and offers a set of actions for editing details this menu shows relevant information about your deployment, including deployment id, template id, status and output update this category allows you to update the settings and configurations of your deployment revision this category displays information about the revision history of your deployment metrics this category displays various metrics related to your deployment, such as usage total cost, total cpu cost, total efficiency, total active hours cpu average running cpu cores, cpu core request avg , cumulative cpu core hours allocated ram avg ram allocated, ram request avg , ram usage avg , ram efficiency, cumulative ram byte hours allocated