Deploy Kubernetes

In this section, you will learn how to deploy a Kubernetes cluster using kubespray. Now that you have a few VMs running, you can use them as nodes for the Kubernetes cluster.

Kubespray is a set of Ansible playbooks that you can use to deploy a Kubernetes cluster. It is designed to be used in a variety of environments, including bare metal, virtual machines, and cloud providers. In this case, you will use it to deploy a Kubernetes cluster on VMs running on your local machine.

What you’ll need

To complete this guide, you will need the following:

A set of running VMs. You can use the VMs you created in the previous sections.

Procedure

Follow the steps below to deploy a Kubernetes cluster:

Clone the kubespray repository:

user:~$ git clone https://github.com/kubernetes-sigs/kubespray.git

Navigate to the kubespray directory:
```
user:~$ cd kubespray
```

Install the Python requirements:

user:~/kubespray$ pip install -r requirements.txt

Copy the inventory/sample file as inventory/mycluster:

user:~/kubespray$ cp -rfp inventory/sample inventory/mycluster

Update the Ansible inventory file using the inventory builder script:

user:~/kubespray$ declare -a IPS=(192.168.20.101 192.168.20.102 192.168.20.103 192.168.20.104 192.168.20.105)

Note

Replace the IP addresses with the ones of your VMs.

user:~/kubespray$ CONFIG_FILE=inventory/mycluster/hosts.yaml python3 contrib/inventory_builder/inventory.py ${IPS[@]}
DEBUG: Adding group all
DEBUG: Adding group kube_control_plane
DEBUG: Adding group kube_node
DEBUG: Adding group etcd
DEBUG: Adding group k8s_cluster
DEBUG: Adding group calico_rr
... (output omitted)

Review and change parameters under inventory/mycluster/group_vars:

user:~/kubespray$ cat inventory/mycluster/group_vars/all/all.yml

user:~/kubespray$ cat inventory/mycluster/group_vars/k8s_cluster/k8s-cluster.yml

Deploy Kubespray with Ansible Playbook:
```
user:~/kubespray$ ansible-playbook -i inventory/mycluster/hosts.yaml --user=root cluster.yml
```
Note

This command will deploy a Kubernetes cluster on the VMs you specified in the inventory file.
Copy the admin.conf file to your local machine:
```
user:~/kubespray$ scp root@node1:/etc/kubernetes/admin.conf ~/.kube/config
```
Note

Replace node1 with the IP address of the first node in your cluster.
Create an SSH tunnel to the Kubernetes API server:
```
user:~/kubespray$ ssh -L 6443:localhost:6443 root@node1
```
Note

Replace node1 with the IP address of the first node in your cluster.

Verify

Follow the steps below to verify the Kubernetes deployment:

Verify that the Kubernetes cluster is up and running:

user:~/kubespray$ kubectl get nodes
NAME       STATUS   ROLES           AGE   VERSION
node1      Ready    control-plane   1m    v1.29.3
node2      Ready    control-plane   1m    v1.29.3
node3      Ready    <none>          1m    v1.29.3
node4      Ready    <none>          1m    v1.29.3

Note

The output should show the nodes in the cluster and their status. What you care about is that all nodes are Ready.