rskio/mkdocs/docs/projects/k3s/longhorn.md

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:

sudo apt install open-iscsi nfs-common -y

see longhorn os-specific requirements 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 for more information.

Dashboard

Service

create and apply longhorn/service.yml

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

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

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

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: some-app-pvc
spec:
  accessModes:
    - ReadWriteMany
  resources:
    requests:
      storage: 500M
  storageClassName: longhorn-data