docs: mega refactor

Also bunch of edits at wiki.k-space.ee

ansible/inventory.yml

@@ -1,3 +1,8 @@
+# This file is linked from /README.md as 'all infra'.
+##### Not otherwise linked:
+    # Homepage: https://git.k-space.ee/k-space/homepage (on GitLab)
+    # Slack: https://k-space-ee.slack.com
+
 all:
   vars:
     admins:
@@ -6,6 +11,7 @@ all:
     extra_admins: []
 
   children:
+    # https://wiki.k-space.ee/en/hosting/storage
     nasgroup:
       hosts:
         nas.k-space.ee: { ansible_host: 172.23.0.7 }
@@ -14,13 +20,16 @@ all:
           ansible_port: 10648
       vars:
         offsite_dataset: offsite/backup_zrepl
+
     misc:
       children:
         nasgroup:
       hosts:
+        # https://git.k-space.ee/k-space/kube: bind/README.md (primary DNS, PVE VM)
         ns1.k-space.ee: { ansible_host: 172.20.0.2 }
 
-    proxmox:
+    # https://wiki.k-space.ee/hosting/proxmox (depends on nas.k-space.ee)
+    proxmox: # aka PVE, Proxmox Virtualization Environment
       vars:
         extra_admins:
           - rasmus
@@ -30,6 +39,8 @@ all:
         pve8: { ansible_host: 172.21.20.8 }
         pve9: { ansible_host: 172.21.20.9 }
 
+    # https://git.k-space.ee/k-space/kube: README.md
+    # CLUSTER.md (PVE VMs + external nas.k-space.ee)
     kubernetes:
       children:
         masters:
@@ -39,12 +50,12 @@ all:
             master3.kube.k-space.ee: { ansible_host: 172.21.3.53 }
         kubelets:
           children:
-            mon:
+            mon: # they sit in a priviledged VLAN
               hosts:
                 mon1.kube.k-space.ee: { ansible_host: 172.21.3.61 }
                 mon2.kube.k-space.ee: { ansible_host: 172.21.3.62 }
                 mon3.kube.k-space.ee: { ansible_host: 172.21.3.63 }
-            storage:
+            storage: # longhorn, to be replaced with a more direct CSI
               hosts:
                 storage1.kube.k-space.ee: { ansible_host: 172.21.3.71 }
                 storage2.kube.k-space.ee: { ansible_host: 172.21.3.72 }
@@ -58,6 +69,8 @@ all:
                 worker4.kube.k-space.ee: { ansible_host: 172.20.3.84 }
                 worker9.kube.k-space.ee: { ansible_host: 172.20.3.89 } # Raspberry Pi 400
 
+    # https://wiki.k-space.ee/en/hosting/doors
+    # See also: https://git.k-space.ee/k-space/kube: camtiler/README.md
     doors:
       vars:
         extra_admins:

ansible/zrepl/playbook.yml

@@ -1,3 +1,5 @@
+# Referenced and documented by https://wiki.k-space.ee/en/hosting/storage#zrepl
+
 - name: zrepl
   hosts: nasgroup
   tasks: