Tencent Cloud Connect to Kato

This article mainly explains how to install Kato on Tencent Kubernetes Engine (TKE) and connect to Gridworkz Cloud.


Before you begin, please check the following prerequisites:

  1. Understand Kato Cloud and proceed to register and Login.
  2. Make sure that your Tencent Cloud account supports on-demand purchase of resources, such as account balance greater than 100 dollars and real-name authentication.

Prepare a TKE Cluster

Before installing Kato, a standard kubernetes on TKE is required. Choose 1.18.4 for the version of our cluster, S3.MEDIUM8 for the specification of Worker nodes, and 2 for the number of nodes.

  1. S3.MEDIUM8, 2 nodes is the minimum configuration. In a production environment, it is recommended to choose a higher configuration according to the actual situation.
  2. Kato’s minimum requirement for Kubernetes version is 1.13. It is recommended to select the highest version 1.18.4 supported by TKE.

Prepare an Elastic Load Balancing ELB

In order to ensure the high availability of the Kato cluster, it is necessary to add a layer of load balancing before the traffic enters the gateway node of Kato. For details, please refer to Cloud Load Balancer (CLB).

ELB needs to open the 4 ports 80, 443, 8443, and 6060.

Prepare an RDS

Prepare a cloud database MySQL, the version selection is 5.7.

In addition, you need to create a database for Kato, the database name is region.

Install Kato Operator

Use the application function of TKE to create a Kato Operator.

Application functions refer to Helm 3.0 related functions integrated with Tencent Cloud Container Service (Tencent Kubernetes Engine, TKE), which provide the ability to create various products and services such as helm charts, container images, and software services. For details, please refer to here.

  1. Create namespace: rbd-system:
 kubectl create ns rbd-system
  1. Install Kato Operator
 # Add repository
 helm repo add kato https://openchart.gridworkz.com/gridworkz/kato
 # Installation
 helm install kato-operator-cloud kato/kato-operator \
 --namespace rbd-system \
 --version 1.1.0-cloud

Wait for a while (depending on the specific network environment) until the status of kato-operator-0 becomes Running.

Install Kato

Visit Kato Operator to start the installation of Kato.

Visit Kato Operator

Open the browser and enter the host IP address: http://<SERVER_IP>:30008. You can obtain SERVER_IP through the following command:

echo $(kubectl get po kato-operator-0 -n rbd-system -o jsonpath="{..hostIP}")

Note that the obtained SERVER_IP is an internal network address, please use it directly or replace it with an external network address according to the actual situation.

Parameter Configuration

  1. Installation Mode select high availability
  2. Fill in the prepared MySQL information into Data Center Database
  3. Gateway node, Build service running node Select the two prepared computing nodes
  4. Gateway public IP fill in the prepared CLB
  5. Shared storage: Select Choose an existing storage driver in the cluster -> cfs
  6. Block storage: Select Select the existing storage driver of the cluster -> cfs
  7. After completing the above configuration, click Configure ready to start the installation

cfs is the file storage of Tencent Cloud, please refer to File Storage for details.

Verify Installation

When the installation progress is completed, it will jump to the following page:

The installation is complete.

Install Command Line Tools

To facilitate the operation and maintenance of the cluster, please refer to document to install the grctl command line tool.

After the installation is complete, execute grctl config to obtain Region Config. Region Config is used in the next step of Connecting to Kato Cloud.

Connect with Kato Cloud

The specific docking method is as follows, add a cluster in the enterprise view cluster interface of the registered enterprise; the process is as follows:

  1. Click on Add Cluster

  2. Select Import:

  3. Fill in the relevant information:

    Cluster ID: Custom, cannot be modified after the cluster is added

    Cluster name: The name of the currently added cluster, customized, and can be modified after adding

    Remarks: The current cluster remarks information, just customize

    Region Config: The Region Config file defines the current cluster configuration information, including cluster API address, Web Socket communication address, HTTP application default domain name suffix, TCP application default access IP, etc. After adding the Region Config file when adding a cluster, the above information will be automatically read.

How to Use the Cluster

Select the cluster in Create Team and create a team belonging to the cluster. Since then, the resources of the cluster will be used when creating components under the team .