Merge pull request #4484 from vespa-engine/morio/improve-installation-docs

kubernetes-operator: Improve MiniKube setup section

Author: morioramdenbourg

_data/sidebar.yml

@@ -420,6 +420,8 @@ docs:
             url: /en/operations/kubernetes/vespa-on-kubernetes.html
           - page: Architecture
             url: /en/operations/kubernetes/architecture.html
+          - page: Vespa on Kubernetes
+            url: /en/operations/kubernetes/installation.html
           - page: Lifecycle Operations for Vespa on Kubernetes
             url: /en/operations/kubernetes/operations.html
           - page: Enable TLS Encryption for Vespa on Kubernetes

en/operations/kubernetes/installation.html

@@ -59,7 +59,7 @@ <h2>MiniKube Setup</h2>
 
 <pre>
 # Start Minikube
-minikube start --nodes 8 --cpus 2 --memory 4GiB --driver=podman --insecure-registry="192.168.49.0/24"
+minikube start --nodes 8 --cpus 2 --memory 4GiB --driver=podman
 
 # Enable Image Registry add-on
 minikube addons enable registry
@@ -107,6 +107,36 @@ <h2>MiniKube Setup</h2>
 export OCI_IMAGE_TAG=$VESPA_VERSION
 </pre>
 
+<p>
+  Then, install the <a href="https://github.com/kubernetes-sigs/sig-storage-local-static-provisioner">Local Persistent Volume</a> provisioner Helm Chart.
+  This will allow Persistent Volumes to be created in a MiniKube environment. It will automatically create a StorageClass called `local-storage`, which should be
+  used for the next steps.
+</p>
+
+<pre>
+# Clone the local persistent volume static provisioner from the Kubernetes sigs
+$ git clone git@github.com:kubernetes-sigs/sig-storage-local-static-provisioner.git
+
+# Deploy onto the Kubernetes cluster
+$ helm install -f helm/examples/baremetal-default-storage.yaml local-volume-provisioner --namespace kube-system ./helm/provisioner
+
+# Create several volumes on each Minikube node.
+$ for n in minikube minikube-m02 minikube-m03 minikube-m04 minikube-m05 minikube-m06 minikube-m07 minikube-m08; do
+  echo "==> $n"
+  minikube ssh -n "$n" -- '
+    set -e
+    for i in 1 2 3 4; do
+      sudo mkdir -p /mnt/disks/vol$i
+      if ! mountpoint -q /mnt/disks/vol$i; then
+        sudo mount --bind /mnt/disks/vol$i /mnt/disks/vol$i
+      fi
+    done
+    echo "Mounted:"
+    mount | grep -E "/mnt/disks/vol[1-4]" || true
+  '
+done
+</pre>
+
 <h2 id="install-helm-chart">Deploy Vespa Operator</h2>
 <p>
   The Helm Chart installs the Vespa Operator and the <code>Role</code>, <code>RoleBinding</code>, and <code>ServiceAccount</code> resources with the necessary permissions to operate Vespa. Optionally, the
@@ -177,6 +207,33 @@ <h2>
     endpointType: "NODE_PORT"
 </pre>
 
+<p>
+  An example for MiniKube would be as follows.
+</p>
+
+<pre>
+# VespaSet configuration for AWS EKS
+apiVersion: k8s.ai.vespa/v1
+kind: VespaSet
+metadata:
+  name: vespaset-sample
+  namespace: vespa
+spec:
+  version: $OCI_IMAGE_TAG
+
+  configServer:
+    image: "$OCI_IMAGE_REFERENCE"
+    storageClass: "local-storage"
+    generateRbac: false
+
+  application:
+    image: "$OCI_IMAGE_REFERENCE"
+    storageClass: "local-storage"
+
+  ingress:
+    endpointType: "NODE_PORT"
+</pre>
+
 <p>
   Note that the <code>$OCI_IMAGE_REFERENCE</code> is shared between the ConfigServer and the Vespa Application Pods.
 </p>