https://github.com/moukoublen/kubernetes-cluster

kubernetes cluster with multipass and ansible
https://github.com/moukoublen/kubernetes-cluster

ansible k8s kubernetes kubernetes-cluster multipass

Last synced: about 12 hours ago
JSON representation

kubernetes cluster with multipass and ansible

• Host: GitHub
• URL: https://github.com/moukoublen/kubernetes-cluster
• Owner: moukoublen
• Created: 2020-06-28T13:19:09.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2024-01-18T17:27:43.000Z (10 months ago)
• Last Synced: 2024-01-18T19:29:35.958Z (10 months ago)
• Topics: ansible, k8s, kubernetes, kubernetes-cluster, multipass
• Language: Shell
• Homepage:
• Size: 33.2 KB
• Stars: 1
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Kubernetes Cluster

Create a kubernetes cluster from scratch with [multipass](https://multipass.run/install) vms and [ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html).

## A) Create the ubuntu vms with multipass

To create the vms run the `up` script (`./up`)

This script will:

* Create and start 3 vms (with names `kube-node-0`, `kube-node-1`, `kube-node-2`)

* Add the public key `./keys/key.pub` in each vm's `authorized_keys`

* Create the ansible `inventory` file by getting each vm's ip.

## B) Create kubernetes cluster with ansible

Every ansible playbook must be run from `./ansible` directory (`cd ansible`).

### Install ansible and virtual environment

 - Create and activate virtual env (optional)

```bash

python3 -m venv --clear ./venv

source ./venv/bin/activate

pip install -U pip setuptools wheel # Optionally

```

- Install ansible and tools

```bash

pip install -U ansible-core ansible ansible-lint ansible-navigator

```

* `./bin/install-ansible-collections-and-roles` Installs ansible collections and roles.

* `./bin/ansible-playbook 00-requirements.yml` Installs basic configuration requirements for each node.

* `./bin/ansible-playbook 01-crio.yml` Installs [cri-o](https://cri-o.io/) as [container runtime](https://kubernetes.io/docs/setup/production-environment/container-runtimes/)

* `./bin/ansible-playbook 02-kube-install.yml` Installs kubernetes deployment tools ([kubeadm, kubelet, kubectl](https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/#installing-kubeadm-kubelet-and-kubectl)).

* `./bin/ansible-playbook 03-kube-cluster.yml` Setups the kubernetes cluster into the first node kube-node-0.

* (cni option 1) `./bin/ansible-playbook 04-cilium.yml` Setups [cilium](https://cilium.io/) (cni) networking add-on.

* (cni option 2) `./bin/ansible-playbook 04-calico.yml` Setups [calico](https://docs.tigera.io/calico/latest/about/) (cni) networking add-on.

* `./bin/ansible-playbook 05-kube-join-nodes.yml` Joins the rest vms to kubernetes cluster as nodes.

_______________________

## Access cluster

### A) From kube-node-0 (`multipass shell kube-node-0`)

You can access kubernetes cluster through `kube-node-0` by opening a shell to it with `multipass shell kube-node-0`.

```bash

multipass shell kube-node-0

kubectl get nodes

```

### B) From host (get .kube/config from `kube-node-0`)

You can access the cluster directly with `kubectl` from the host machine by getting the `~/.kube/config` from `kube-node-0`

```bash

mkdir -p ~/.kube/

multipass transfer kube-node-0:/home/ubuntu/.kube/config - > ~/.kube/config

kubectl get nodes

```