Attention

You are viewing an older version of the documentation. The latest version is v3.3.

Deploy a RKE Cluster

This section explains the procedure to configure and run the Edge Conductor tool to deploy a RKE cluster.

RKE Cluster - Preparation

Follow the Hardware and Software Requirements for Edge Conductor Day-0 Host to prepare the Day-0 host hardware and software.

Follow the instructions in Build and Install Edge Conductor Tool to build and install the Edge Conductor tool. Go to the _workspace folder to run the Edge Conductor tool.

Before deploying RKE cluster:

RKE Cluster - Top Config

Create rke-top-config.yml for RKE cluster as shown in the following example:

Cluster:
 type: "rke"
 config: "config/cluster/rke_cluster.yml"

Services:
 client: dev-rke

The config/cluster/rke_cluster.yml is generated during RKE Cluster - Preparation.

The client dev-rke is specified in the Services section to deploy a list of tested services on RKE.

For other config sections and detailed description, refer to Top Config.

RKE Cluster - Custom Config

Prepare a custom config file customcfg.yml based on Custom Config. Note that the custom config file is a mandatory parameter for conductor init.

RKE Cluster - Initialize Edge Conductor Environment

Run the following command to initialize the Edge Conductor environment:

./conductor init -c rke-top-config.yml -m customcfg.yml

RKE Cluster - Install Certificate Authority Certificate

If you are using a local registry with TLS enabled, you should distribute the Certificate Authority (CA) certificate to each RKE node.

Copy a CA certification from Day-0 machine to each RKE node.

  • Source file (Day-0 machine): cert/pki/ca.pem

  • Target file (RKE node): /etc/docker/certs.d/< local registry IP:local registry port >/ca.crt

RKE Cluster - Build and Deploy

Run the following commands to build and deploy the RKE cluster:

./conductor cluster build
 ./conductor cluster deploy

The kubeconfig will be copied to the default path ~/.kube/config.

Check the RKE Cluster

Install the kubectl tool (v1.20.0) to interact with the target cluster.

kubectl get nodes

For more details, refer to Interact with Nodes.