neva
/
k8s-demo
1
0
Fork 0
Code Issues Pull Requests 1 Packages Projects Releases Wiki Activity
k8s-demo/README.md

3.1 KiB
Raw Blame History

Kubernetes Local Cluster Demonstration

Kubernetes demonstration on your local machine

Prerequisites

  1. Make sure to have docker or a OCI compatibile container engine installed
  2. Make sure the docker/oci engine is running
  3. Install kubectl for interacting with the kube api:
  4. 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
  5. Have at least 8GB RAM and 20GB disk

Create cluster

  1. kind create cluster --config cluster-config/config.yaml (1 control plane, 3 nodes)
  2. 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:

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