# Kubernetes Local Cluster Demonstration

Kubernetes demonstration on your local machine

## Prerequisites

1. Make sure to have docker or a OCI compatibile container engine installed
1. Make sure the docker/oci engine is running
1. Install `kubectl` for interacting with the kube api:
    - https://kubernetes.io/docs/tasks/tools/
1. Install `kind`
    - mac/brew: `brew install kind`
    - mac/macports: `sudo port selfupdate && sudo port install kind`
    - win/choco: `choco install kind`
    - win/winget: `winget install Kubernetes.kind`
    - linux: tbd
1. Have at least 8GB RAM and 20GB disk

## Create cluster

1. `kind create cluster --config cluster-config/config.yaml` (1 control plane, 3 nodes)
1. Once complete, look at what is running in all namespaces: `kubectl get pods -A`

```
$ kubectl get pods -A
NAMESPACE            NAME                                         READY   STATUS    RESTARTS   AGE
kube-system          coredns-76f75df574-ddznd                     1/1     Running   0          7m16s
kube-system          coredns-76f75df574-ftv2c                     1/1     Running   0          7m16s
kube-system          etcd-demo-control-plane                      1/1     Running   0          7m31s
kube-system          kindnet-jj8bv                                1/1     Running   0          7m16s
kube-system          kube-apiserver-demo-control-plane            1/1     Running   0          7m31s
kube-system          kube-controller-manager-demo-control-plane   1/1     Running   0          7m31s
kube-system          kube-proxy-2wr8l                             1/1     Running   0          7m16s
kube-system          kube-scheduler-demo-control-plane            1/1     Running   0          7m31s
local-path-storage   local-path-provisioner-7577fdbbfb-jj2b7      1/1     Running   0          7m16s
```

You will want to wait for all pods to become ready (showing `1/1` in the `READY` field) and once complete you will have a cluster running on your computer.

## Run services

### Ingress Controller (nginx)

Ingress controllers manage incoming web traffic (usually HTTP/HTTPS)

1. `kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/main/deploy/static/provider/kind/deploy.yaml`

Wait for it to become available:

```bash
kubectl wait --namespace ingress-nginx \
  --for=condition=ready pod \
  --selector=app.kubernetes.io/component=controller \
  --timeout=300s
```

Usually you'll want to next install a load balancer, but for a single node cluster this is not required.

### Observability (grafana, prometheus)

tbd - grafana, prometheus, alertmanager, thanos, servicemonitor, podmonitor

### Vault (secrets)

### Forgejo (with redis and postgresql)

tbd - https://artifacthub.io/packages/helm/forgejo-helm/forgejo#single-pod-configurations

### Sublinks in k8s

tbd

## Troubleshooting

tbd

## Cleanup

1. `kind delete cluster`

## Other

- Rallly - https://hub.docker.com/r/lukevella/rallly https://support.rallly.co/self-hosting/introduction
- Zipline - https://github.com/diced/zipline
- Synapse - https://github.com/element-hq/synapse
- Vaultwarden - https://github.com/dani-garcia/vaultwarden
- input - https://getinput.co/
- grafana - https://grafana.com/