From 26ee7243e3b37e2ec300f558aa639a52aac2a408 Mon Sep 17 00:00:00 2001
From: Malin Freeborn <malinfreeborn@posteo.net>
Date: Fri, 29 Aug 2025 15:14:25 +0200
Subject: [PATCH] kubernetes setup

---
 virtualization/kubernetes/setup.md | 54 ++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 virtualization/kubernetes/setup.md

diff --git a/virtualization/kubernetes/setup.md b/virtualization/kubernetes/setup.md
new file mode 100644
index 0000000..843e80b
--- /dev/null
+++ b/virtualization/kubernetes/setup.md
@@ -0,0 +1,54 @@
+---
+title: "Kubernetes Setup"
+tags: [ "virtualization", "kubernetes", "minikube", "docker" ]
+---
+
+# Install `minikube`
+Set up a practice environment with `minikube`, using either Docker or VirtualBox.
+
+1. Install the driver (VirtualBox is a good choice).
+1. Install `minikube`.
+    * Debian requires manual installation.[^minideb]
+1. Check it works.
+
+The installation takes a long time.
+
+```sh
+#  driver=docker
+driver=virtualbox
+minikube start --driver=${driver}
+```
+
+## Check `minikube`
+
+Check it's all running:
+
+```sh
+minikube kubectl -- get po -A
+```
+
+```
+NAMESPACE     NAME                               READY   STATUS    RESTARTS      AGE
+kube-system   coredns-674b8bbfcf-l7582           1/1     Running   0             2m
+kube-system   etcd-minikube                      1/1     Running   0             2m
+kube-system   kube-apiserver-minikube            1/1     Running   0             2m
+kube-system   kube-controller-manager-minikube   1/1     Running   0             2m
+kube-system   kube-proxy-4q977                   1/1     Running   0             2m
+kube-system   kube-scheduler-minikube            1/1     Running   0             2m
+kube-system   storage-provisioner                1/1     Running   1 (2m ago)    2m
+```
+
+# Uninstall `minikube`
+
+```sh
+du -sh ~/.minikube
+```
+
+Minikube is huge!
+
+```sh
+minikube stop
+rm -rf ~/.minikube
+```
+
+[^minideb]: https://minikube.sigs.k8s.io/docs/start/