Alibaba Cloud Deployment

This article will introduce how to install Kato cluster based on Alibaba Cloud ACK managed cluster privatization.

Prerequisites

Before you start, please make sure you have purchased the following Alibaba Cloud resources, all of which are required to be in the same region:

1. Alibaba Cloud ACK Hosting Cluster

  • ACK Kubernetes version is higher than 1.13.0
  • At least 2 nodes in the cluster, and configure the kubectl command to make it available
  • Nodes have public network access capabilities
  • Configuration requires 8 core CPU 32G memory
  • Disk space: root partition 200G data partition (docker partition) 300G

2. SLB Load Balancing

  • Have a public IP address
  • Include nodes in the ACK cluster into the back-end server group
  • Configure the following port mapping: 80 443 6060 7070 30008

3. NAS Storage Service

  • Provide a mount point, the format is similar to 123456789-var48.us-virginia.nas.aliyuncs.com:/
  • Turn off access control (black and white lists), or turn on access permissions for all ACK nodes

4. RDS Database Service

  • Two database instances are generated in advance: console region
  • Generate the database account password and grant all permissions to the above database
  • Turn off access control (black and white lists), or turn on access permissions for all ACK nodes
  • Database version selection 8.0
  • Database disk space is not less than 5G

5. Container Image Service

  • Create a namespace, username, and password
  • Automatic repository creation: on
  • Default repository type: private

Install Kato Operator with Helm 3

It is recommended to use Helm to install Kato Opeartor.

Install Helm 3

Use the following command to mirror the installation (if Helm 3 is already installed, you can skip this step):

wget https://gitlab.com/gridworkz/kato/pkg/helm && chmod +x helm && mv helm /usr/local/bin/

Verify that Helm has been successfully installed in the following ways:

helm version

Install Kato Operator

  1. Create namespace, recommend using rbd-system:
kubectl create ns rbd-system
  1. Add the chart warehouse of Kato Operator:
helm repo add kato https://openchart.gridworkz.com/gridworkz/kato
  1. Install Kato Operator
helm install kato-operator kato/kato-operator \
--namespace rbd-system \
--version 1.1.1
  1. Confirm Status
$ kubectl get pod -n rbd-system
NAME READY STATUS RESTARTS AGE
kato-operator-0 2/2 Running 0 110s

High-availability Kato Installation

Visit Kato Operator to start the installation of Kato.

1. Visit Kato Operator

Open the browser and enter SLB public network IP address: http://<SLB_IP>:30008. You can enter the installation page.

2. Configure Installation Mode

3. Configure Mirror Repository

To select Provide Existing Mirror Repository, the user needs to provide the domain name, space name, user name and password of the existing mirror repository.

4. Configure the Data Center Database

In a highly available installation environment, Alibaba Cloud users must provide an external highly available RDS Mysql 8.0 database. The region database needs to be created in advance in the database, and the RDS domain name, user name, and password accessible to the intranet must be provided:

5. Configure the Console Database

In a highly available installation environment, Alibaba Cloud users must provide an external highly available RDS Mysql 8.0 database. The console database needs to be created in advance in the database, and the RDS domain name, user name, and password accessible to the intranet must be provided:

6. Configure ETCD

Select New installation ETCD (support HA), and the highly available ETCD cluster will be automatically installed during the installation process:

If the user has an available ETCD cluster in the Alibaba Cloud environment, choose Provide Existing ETCD, and the user needs to provide a list of existing ETCD cluster instance addresses:

7. Configure Gateway Node

In a high-availability environment, select at least 2 nodes as cluster gateway nodes. It is recommended to use all nodes as gateway nodes. It is required that the ports 80, 443, 6060, 7070, 8443, 10254, 18080, 18081 of the nodes are not available Occupied.

Tip: If you cannot search and select a gateway IP, please refer to [Cannot select gateway node](/docs/user-operations/install/troubleshooting/#Cannot select gateway node).

8. Configure Build Service Running Node

In a high-availability environment, select at least 2 nodes as the cluster build service running node, and Alibaba Cloud users can search and select 2 node nodes as the build service running node.

9. Configure and Assign Default Domain Name

Enable this function (default), which can assign a pan-resolution domain name to the cluster that can be resolved by the public network.

10. Configure the Gateway Public Network IP

This option is required, fill in the IP address of the load balancing, that is, the Alibaba Cloud SLB public network IP address.

11. Configure Shared Storage

For Alibaba Cloud environment, please use Aliyun NAS:

12. Configure Block Device Storage

This option is not required.

If there is a deployed block device storage driver in the cluster, you can directly select it, such as ceph-rbd block storage.

If it is an Alibaba Cloud environment, you can choose Alibaba Cloud Disk.

After the configuration is complete, click Next.

13. Installation Environment Test

Kato-Operator will automatically detect the installation environment. After all of them are passed, click Passed to start installation.

If the installation is blocked, you can refer to Troubleshooting, or contact the corresponding manager.

Verify Installation

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

The installation is complete. Click Access Address to register and start using Kato.

Install Command Line Tools

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