Skip to content

Latest commit

 

History

History
198 lines (139 loc) · 5.67 KB

creating-rke-cluster.md

File metadata and controls

198 lines (139 loc) · 5.67 KB
Raw

Create a RKE cluster

The following guide is based on the Rancher's documentation.

Goal: Create RKE cluster.

This workshop creates an RKE cluster with Linux containers on GCP.

Prerequisite Tasks

  • Have docker enabled in Linux server

  • Start the Docker Runtime

    sudo systemctl start docker
sudo /usr/sbin/usermod -aG docker $USER
sudo chown $USER:docker /var/run/docker.sock

  • Install Rancher Server

    sudo docker run --privileged -d --restart=unless-stopped -p 80:80 -p 443:443 rancher/rancher

  • Find the container ID

    docker ps

  • Find the bootstrap password required for login:

    docker logs <container ID> 2>&1 | grep "Bootstrap Password:"

  • Login your Rancher server with IP and password, for example:

    https://<Rancher_Server_IP>/dashboard/auth/login

Steps

  1. Provisioning compute instances in GCP. Refer to "creating kubeadm cluster" for provisioning VPC & subnet & firewalls

    gcloud compute instances create rancher-master \
 --async \
 --boot-disk-size 200GB \
 --can-ip-forward \
 --image-family ubuntu-2004-lts \
 --image-project ubuntu-os-cloud \
 --machine-type e2-standard-4 \
 --private-network-ip 10.240.0.222 \
 --scopes compute-rw,storage-ro,service-management,service-control,logging-write,monitoring \
 --subnet k8s-nodes \
 --zone us-east1-b \
 --tags calicocloud,rancher,master
    for i in 0 1; do
gcloud compute instances create rancher-worker${i} \
 --async \
 --boot-disk-size 200GB \
 --can-ip-forward \
 --image-family ubuntu-2004-lts \
 --image-project ubuntu-os-cloud \
 --machine-type e2-standard-4 \
 --private-network-ip 10.240.0.22${i} \
 --scopes compute-rw,storage-ro,service-management,service-control,logging-write,monitoring \
 --subnet k8s-nodes \
 --zone us-east1-b \
 --tags calicocloud,rancher,worker
done

  2. Install Docker on each VM instances

    gcloud compute instances list --filter="tags.items=rancher"

    Output as example with GCE instances.

    NAME             ZONE        MACHINE_TYPE   PREEMPTIBLE  INTERNAL_IP   EXTERNAL_IP    STATUS
rancher-master   us-east1-b  e2-standard-4               10.240.0.222  <EXTERNAL_A>   RUNNING
rancher-server   us-east1-b  e2-standard-4               10.240.0.111  <EXTERNAL_X>  RUNNING
rancher-worker0  us-east1-b  e2-standard-4               10.240.0.220  <EXTERNAL_B>   RUNNING
rancher-worker1  us-east1-b  e2-standard-4               10.240.0.221  <EXTERNAL_C>   RUNNING
    sudo su
apt-get update
apt-get install \
apt-transport-https \
ca-certificates \
curl \
gnupg \
lsb-release -y

  3. Add Docker’s official GPG key and install Docker Engine on each instances:

    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
    echo \
"deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
    sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io -y

  4. Go to Rancher UI, create a custom cluster with calico cni.

Note: Use the default option with PSP disable.

create rke cluster

choose custom cluster

choose calico cni

disable authorized endpoint

  1. Rancher UI will generate a slightly different install script for control plane and workers, run these script in different nodes.

    a. For Master

    rancher master script

    b. For Worker

    rancher worker script

  2. Download the Kubeconfig file from Rancher UI

    download kubeconf

    You should now be able to see your 3 nodes (if the docker install command was used on each EC2 instance):

    kubectl get nodes --kubeconfig=~/Downloads/calicocloud-workshop.yaml

    output

    NAME              STATUS   ROLES                      AGE   VERSION
rancher-master    Ready    controlplane,etcd,worker   21m   v1.21.5
rancher-worker0   Ready    worker                     19m   v1.21.5
rancher-worker1   Ready    worker                     18m   v1.21.5

  3. Download this repo into your environment:

    git clone https://github.com/tigera-solutions/calicocloud-kaas-workshop-demo.git

cd calicocloud-kaas-workshop-demo

  4. [Optional] Merge this kubeconfg to your current KUBECONFIG environment.

    export KUBECONFIG_SAVED=$KUBECONFIG

CALICO=~/Downloads/calicocloud-workshop.yaml

export KUBECONFIG=$CALICO:$HOME/.kube/config

kubectl config use-context calicocloud-workshop

  5. [Optional] Return your KUBECONFIG environment variable to its original value

    export KUBECONFIG=$KUBECONFIG_SAVED

Next steps

You should now have an RKE cluster running with 3 nodes. The Control Plane services which manage the Kubernetes cluster such as scheduling, API access, configuration data store and object controllers are all provided as services to the nodes.

➡️ Join the cluster to Calico Cloud

↩️ README.md - STEP 1 - Create a compatible k8s cluster