SMB: Schattenkopien deaktiviert + Snaps als Unterordner eingebaut (#275)

Co-authored-by: Michael Grote <michael.grote@posteo.de>
Reviewed-on: mg/ansible#275
Co-authored-by: mg <michael.grote@posteo.de>
Co-committed-by: mg <michael.grote@posteo.de>

group_vars/fileserver.yml

@@ -132,3 +132,4 @@
   smb_min_protocol: "SMB2"
   smb_client_min_protocol: "SMB2"
   smb_client_max_protocol: "SMB3_11"
+  smb_enable_snapshots_dir: true

roles/mgrote.fileserver_smb/README.md

@@ -1,7 +1,7 @@
 ## mgrote.fileserver_smb
 
 ### Beschreibung
-Installiert und Konfiguriert einen Fileserver mit Samba.
+Installiert und konfiguriert einen Fileserver mit Samba.
 
 #### Rechte
 Rechte im Dateisystem sind
@@ -14,7 +14,7 @@ Rechte im Dateisystem sind
 Damit werden die Nutzer mit Ihrem Konto auf die SAMBA-Freigabe berechtigt, aber die Lese/Schreiboperationen auf dem Dateisystem als "root" durchgefuehrt.
 
 ### getestet auf
-- [x] Ubuntu (>=18.04)
+- [x] Ubuntu (>=20.04)
 
 ### Samba Version
 ```
@@ -44,7 +44,10 @@ SMB3_11: Windows 10 technical preview SMB3 version (maybe final).
 ```
   smb_shares:
     - name: 'videos' # Freigabename
-      path: '/shares_videos' # Pfad aus SMB-Server
+      path: '/shares_videos' # Pfad auf SMB-Server
       users_ro: ' win10 kodi' # Nutzer - Lesezugriff
       users_rw: 'annemariedroessler michaelgrote' # Nutzer - Schreibzugriff
 ```
+
+### weitere Variablen + Defaults
+siehe [defaults](./defaults/main.yml)

roles/mgrote.fileserver_smb/defaults/main.yml

@@ -32,14 +32,7 @@
   smb_force_user: "root"
   smb_force_group: "users"
   smb_workgroup: WORKGROUP
-  # Global shadow_copy2 options
-  smb_vfs_objects: "shadow_copy2"
-  smb_shadow_snapdir: ".zfs/snapshot"
-  smb_shadow_sort: "desc"
-  smb_shadow_format: "_%Y-%m-%d_%H:%M:%S"
-  smb_shadow_snapprefix: "^autosnap"
-  smb_shadow_delimiter: "_"
-  smb_shadow_localtime: "no"
+
   # packages
   smb_packages:
     - samba
@@ -47,3 +40,31 @@
     - samba-common
     - samba-common-bin
     - samba-vfs-modules
+
+  # zfs-snapshots einbinden
+  ## als <Pfad>\.zfs\snapshot einbinden
+  ## sorgt dafur das statt "A0KDC9~F" die Ordnernamen als "autosnap_2021-11-04_23÷59÷02_daily" angezeigt werden
+  ## https://www.samba.org/samba/docs/current/man-html/vfs_catia.8.html
+  # aktiv?
+  smb_enable_snapshots_dir: true
+  # welche Character/zeichen-Ersetzungen soll catia ausführen
+  smb_catia_mappings: "0x3a:0xf7" # ersetzt ":" durch "÷"
+
+  # als Windows-Shattenkopien einbinden
+  ## https://www.samba.org/samba/docs/current/man-html/vfs_shadow_copy2.8.html
+  ## BUG: Windows sieht die Schattenkopien, kann die Ausgewählte Datei aber nicht öffnen wenn sie seit dem Snapshot gelöscht wurde, vmtl da Windows nicht den kompletten Snapshot-Pfad verwendet
+  ## Format ist passend fur sanoid-Snapshots
+  # aktiv?
+  smb_enable_snapshots_shadow: false
+  # wo liegen die Snapshots
+  smb_shadow_snapdir: ".zfs/snapshot"
+  # Sortierung
+  smb_shadow_sort: "desc"
+  # Datumsformat der Snapshots
+  smb_shadow_format: "_%Y-%m-%d_%H:%M:%S"
+  # Snapshot-Präfix
+  smb_shadow_snapprefix: "^autosnap"
+  # Snapshot-"Trenner"
+  smb_shadow_delimiter: "_"
+  # zeitformat Snapshots
+  smb_shadow_localtime: "no"

roles/mgrote.fileserver_smb/templates/smb.conf.j2

@@ -34,15 +34,33 @@ acl allow execute always = {{ smb_acl_allow_execute_always }}
 force user                = {{ smb_force_user }}
 force group               = {{ smb_force_group }}
 
-
-#======================= ZFS Snapshots =======================
-vfs objects = {{ smb_vfs_objects }}
+{% if smb_enable_snapshots_dir is sameas true and smb_enable_snapshots_shadow is sameas false %}
+#======================= Snapshots als Ordner =======================
+vfs objects               = catia
+catia: mappings           = {{ smb_catia_mappings }}
+{% elif smb_enable_snapshots_shadow is sameas true and smb_enable_snapshots_dir is sameas false %}
+#======================= Snapshots als Schattenkopien =======================
+vfs objects               = {{ smb_shadow_vfs_objects }}
 shadow: snapdir           = {{ smb_shadow_snapdir }}
 shadow: sort              = {{ smb_shadow_sort }}
 shadow: format            = {{ smb_shadow_format }}
 shadow: snapprefix        = {{ smb_shadow_snapprefix }}
 shadow: delimiter         = {{ smb_shadow_delimiter }}
 shadow: localtime         = {{ smb_shadow_localtime }}
+{% elif smb_enable_snapshots_shadow is sameas true and smb_enable_snapshots_dir is sameas true %}
+#======================= Snapshots =======================
+vfs objects               = shadow_copy2, catia
+#======================= Snapshots als Ordner =======================
+catia: mappings           = {{ smb_catia_mappings }}
+#======================= Snapshots als Schattenkopien =======================
+shadow: snapdir           = {{ smb_shadow_snapdir }}
+shadow: sort              = {{ smb_shadow_sort }}
+shadow: format            = {{ smb_shadow_format }}
+shadow: snapprefix        = {{ smb_shadow_snapprefix }}
+shadow: delimiter         = {{ smb_shadow_delimiter }}
+shadow: localtime         = {{ smb_shadow_localtime }}
+{% endif %}
+
 
 #======================= Share Definitions =======================
 {% for item in smb_shares %}
@@ -68,5 +86,4 @@ shadow: localtime = {{ smb_shadow_localtime }}
   invalid users           =
   read list               = {{ item.users_ro }}
   write list              = {{ item.users_rw }}
-
 {% endfor %}