longhorn-system: Updates

longhorn-system/.gitignore

@@ -0,0 +1 @@
+longhorn.yaml

longhorn-system/README.md

@@ -1,19 +1,40 @@
 # Longhorn distributed block storage system
 
-Pull the manifest and apply changes
+## For users
+
+You should really avoid using Longhorn as it has over time proven to be
+unreliable system. Prefer using remote databases in your application via
+the Kubernetes operator pattern.
+
+Use Longhorn for applications that need persistent storage, but are unable
+to provide replication in the application layer:
+
+* Applications that insist writing into filesystem
+* Applications that serve Git repositories (eg Gitea)
+* Applications that check out Git repositories (eg Woodpecker, Drone and CI systems)
+* Applications that need to use SQLite
+
+Instead of using built-in `longhorn` storage class, please add new storage class
+with suitable replication, data locality parameters and reclaim policy
+[https://git.k-space.ee/k-space/kube/src/branch/master/storage-class.yaml](here)
+
+Longhorn backups are made once per day and it's configured to be uploaded to
+the Minio S3 bucket hosted at nas.k-space.ee
+
+
+## For administrators
+
+Longhorn was last upgraded with following snippet:
 
 ```
-wget https://raw.githubusercontent.com/longhorn/longhorn/v1.5.1/deploy/longhorn.yaml -O application.yml
+wget https://raw.githubusercontent.com/longhorn/longhorn/v1.6.2/deploy/longhorn.yaml
 patch -p0 < changes.diff
+kubectl -n longhorn-system apply -f longhorn.yml -f application-extras.yml -f backup.yaml
 ```
 
-To upgrade use following:
-
-```
-kubectl -n longhorn-system apply -f application.yml -f application-extras.yml
-```
-
-After deploying specify `dedicated=storage:NoSchedule`
+After initial deployment `dedicated=storage:NoSchedule` was specified
 for `Kubernetes Taint Toleration` under `Setting -> General` on
 [Longhorn Dashboard](https://longhorn.k-space.ee/).
-Proceed to tag suitable nodes with `storage` and disable Longhorn scheduling on others.
+Suitable nodes were tagged with  `storage` and Longhorn scheduling was disabled on others.
+
+Refer to `application.yaml` to see how backups are configured.

longhorn-system/application-extras.yml

@@ -1,3 +1,4 @@
+# yamllint disable rule:line-length
 ---
 apiVersion: codemowers.cloud/v1beta1
 kind: OIDCMiddlewareClient

longhorn-system/changes.diff

@@ -1,5 +1,5 @@
---- application.yml	2024-07-07 14:16:47.953593433 +0300
-+++ application.modded	2024-07-07 14:18:51.103452617 +0300
+--- longhorn.yaml	2024-07-07 14:16:47.953593433 +0300
++++ longhorn.modded	2024-07-07 14:18:51.103452617 +0300
 @@ -86,14 +86,14 @@
          storageclass.kubernetes.io/is-default-class: "true"
      provisioner: driver.longhorn.io