expand k3s documentation (#1)

traefik
clusterissuer
longhorn
webhook

mkdocs/docs/projects/k3s/longhorn.md

@@ -0,0 +1,110 @@
+# Longhorn
+
+Provides distributed storage for the cluster.
+ We will only be editing the nodes as many of the defaults are sufficient.
+
+## Requirements
+
+All cluster nodes need these packages installed:
+
+``` bash
+sudo apt install open-iscsi nfs-common -y
+```
+
+see [longhorn os-specific requirements](https://longhorn.io/docs/1.9.0/deploy/install/#osdistro-specific-configuration) for more information.
+
+## Setup
+
+=== "v1.9.0"
+
+    ``` bash
+    kubectl apply -f https://raw.githubusercontent.com/longhorn/longhorn/v1.9.0/deploy/longhorn.yaml
+    ```
+
+see [longhorn installation](https://longhorn.io/docs/1.9.0/deploy/install/install-with-kubectl/#installing-longhorn) for more information.
+
+## Dashboard
+
+### Service
+
+create and apply `longhorn/service.yml`
+
+``` bash
+apiVersion: v1
+kind: Service
+metadata:
+  labels:
+    app: longhorn-ui
+  name: longhorn-dashboard
+  namespace: longhorn-system
+spec:
+  ports:
+    - port: 8000
+      protocol: TCP
+      targetPort: 8000
+      name: web
+  selector:
+    app: longhorn-ui
+```
+
+### Ingress
+
+create and apply `longhorn/ingress.yml`
+
+``` bash
+apiVersion: traefik.io/v1alpha1
+kind: IngressRoute
+metadata:
+  name: longhorn-dashboard
+  namespace: longhorn-system
+spec:
+  entryPoints:
+    - websecure
+  routes:
+    - match: Host(`storage.${DOMAIN_NAME}`)
+      kind: Rule
+      services:
+        - name: longhorn-dashboard
+          port: 8000
+```
+
+After creating a `ClusterIssuer` be sure to create a `Certificate` and apply it with `spec.tls.secretName`.
+ With Traefik you can also use certResolver, though clusterissuer certs allow for more fine-grain control.
+
+## StorageClass
+
+create and apply `longhorn/storageclass.yml`
+
+``` bash
+kind: StorageClass
+apiVersion: storage.k8s.io/v1
+metadata:
+  name: longhorn-data
+provisioner: driver.longhorn.io
+allowVolumeExpansion: true
+reclaimPolicy: Delete
+volumeBindingMode: Immediate
+parameters:
+  numberOfReplicas: "3"
+  staleReplicaTimeout: "300"
+  fromBackup: ""
+  fsType: "ext4"
+```
+
+## PVC
+
+create and apply `some-app/pvc.yml`
+
+``` yaml
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: some-app-pvc
+spec:
+  accessModes:
+    - ReadWriteMany
+  resources:
+    requests:
+      storage: 500M
+  storageClassName: longhorn-data
+```