Documentation

First Steps

From Login to production Cluster #

I am new in Taikun and I want to create Kubernetes cluster for my application.  
This is the way how to.

Invitation Mail from Taikun, Reset Password & Login #

 👤User  👥Manager  🤝Partner

If you are completely new to Taikun, you will receive an invitation to your organization. First you need to reset your password (through Visit button in received mail) and then you are redirected right to Taikun login page. By filling E-mail and newly created Password, you will login to Taikun. First page you see is the Dashboard of your organization.

If Keycloak is set for your organization, you can use it to login. 

First Login
Figure.1: First login

If you forget your password, you can reset it. 

See how to change your password here and how to change your e-mail here.

Add Cloud Credentials #

 Manager  Partner

Before you can create your own project, you have to add a cloud. Now you can choose from OpenStack, AWS or Azure. 
You just have to fill in correct credentials from your account and Taikun will connect with them.

OpenStack #

Before connecting the openstack cloud, you have to fulfill the requirements.

OpenStack Cloud Credentials
Figure.2: Openstack cloud credentials

If you have trouble adding openstack credentials, see how fill the fields and where to find credentials.

AWS #

AWS Cloud Credentials
Figure.3: AWS cloud credentials

If you have trouble adding AWS credentials, see how fill the fields and where to find credentials.

Azure #

Before connecting the cloud you have to create application registration through commands.

Azure Cloud credentials
Figure.4: Azure cloud credentials

If you have trouble adding Azure credentials, see how fill the fields (at the bottom of the page) and where to find credentials.

Project Creation #

 Manager  Partner

After you have successfully added cloud credentials, you can add a project! During project creation, you can choose a lot of features.

Add Project
Figure.5: Add project

In Access ProfileAlerting Profile and Kubernetes Profile you have by default option default. These profiles are created with every new organization. You can also create a new profile and then choose from drop-down selection. If you want to enable backup, you have to add backup credentials first, same with policy profile. 

Some of these features can be added/enabled after project is created: add/detach alerting or policy profile, enable monitoring or backup, add expiration date.

⚠️
Warning

ACCESS PROFILE If you want to use your access profile in a project, you have to create it BEFORE and choose it from drop down selection DURING project creation. After the project is created you cannot add an ACCESS PROFILE

Project can be created only by manager or partner, who then has to assign the project to the user (if they want them to have access to the project). 
More information about project creation for Manager and Partner.

Creating a Cluster #

 User  Manager  Partner

For a functional cluster you need one bastion, at least one kubemaster and at least one kubeworker.

ℹ️
Info

Recommendation for sizing: – bastion recommended 2 vCPU + 2GB of RAM – masters recommended 4 vCPU + 8GB of RAM

Create Cluster
Figure.6: Create cluster

You can add and delete servers until you are satisfied with the cluster, then you can commit your changes.

You can update some of the features either directly from Project Details (depend on role permissions – UserManagerPartner) like enable backup, enable/disable monitoring, attach/detach alerting profile or under specific tabs like updating Access ProfileKubernetes Profile.

Please keep in mind that some changes need Repair, which takes some time (e.g. updating Access Profile).

See more information about cluster creation.

Kubeconfigs #

 👤User  👥Manager  🤝Partner

Add kubeconfig to organize information about clusters, users, namespaces, and authentication mechanisms.

Add Kubeconfig
Figure.7: Add kubeconfig

More about kubeconfigs for UserManager and Partner.

What are your feelings