homeserver/roles/mgrote.fileserver_smb/README.md
mg f5dc006a84 Update: fileserver_smb auf dict statt einzelne Variablen (#277)
Co-authored-by: Michael Grote <michael.grote@posteo.de>
Reviewed-on: mg/ansible#277
Co-authored-by: mg <michael.grote@posteo.de>
Co-committed-by: mg <michael.grote@posteo.de>
2021-12-14 20:26:49 +01:00

70 lines
2.1 KiB
Markdown

## mgrote.fileserver_smb
### Beschreibung
Installiert und konfiguriert einen Fileserver mit Samba.
#### Rechte
Rechte im Dateisystem sind
- `chown -R root:users /shares/`
- `chmod -R 777 /shares/`
- alle Nutzer sind Mitglied der Gruppe "users"
- in Samba(global)
- `force user = root`
- `force group = users`
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 (>=20.04)
### Samba Version
```
Possible values are :
SMB2_02: The earliest SMB2 version.
SMB2_10: Windows 7 SMB2 version.
SMB2_22: Early Windows 8 SMB2 version.
SMB2_24: Windows 8 beta SMB2 version.
SMB3: The same as SMB2. Used by Windows 8. SMB3 has sub protocols available.
SMB3_00: Windows 8 SMB3 version. (mostly the same as SMB2_24)
SMB3_02: Windows 8.1 SMB3 version.
SMB3_10: early Windows 10 technical preview SMB3 version.
SMB3_11: Windows 10 technical preview SMB3 version (maybe final).
```
### Variablen
#### Nutzer
```
smb_users:
- name: 'annemariedroessler' # Nutzername
password: "{{ lookup('keepass', 'fileserver_smb_user_amd', 'password') }}" # Passwort als Klartext
state: present # Status(default: present)
remove_dir: false # removes homedir if state is absent und remove_dir is true (default: false)
```
#### Freigaben
```
smb_shares:
- name: 'videos' # Freigabename
path: '/shares_videos' # Pfad auf SMB-Server
users_ro: ' win10 kodi' # Nutzer - Lesezugriff
users_rw: 'annemariedroessler michaelgrote' # Nutzer - Schreibzugriff
# Optional(+default-values)
item.guest_ok: "no"
item.read_only: "no"
browseable: "yes"
inherit_acls: "yes"
inherit_permissions: "no"
ea_support: "no"
store_dos_attributes: "no"
printable: "n"o
create_mask: "0664"
force_create_mode: "0664"
directory_mask: "0775"
force_directory_mode: "0775"
hide_special_files: "yes"
follow_symlinks: "yes"
hide_dot_files: "no"
```
### weitere Variablen + Defaults
siehe [defaults](./defaults/main.yml)