From a714ef531589521ef878405a01ed36ac529813d5 Mon Sep 17 00:00:00 2001
From: paul <paulmaruhn@posteo.de>
Date: Sat, 21 Nov 2020 02:56:52 +0100
Subject: [PATCH] Update 'content/docs/Infrastruktur/Gateways.md'

---
 content/docs/Infrastruktur/Gateways.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/content/docs/Infrastruktur/Gateways.md b/content/docs/Infrastruktur/Gateways.md
index ca99029f..ebec8330 100644
--- a/content/docs/Infrastruktur/Gateways.md
+++ b/content/docs/Infrastruktur/Gateways.md
@@ -2,6 +2,24 @@
 
 ## Übersicht
 
+Eine kurze Ubersicht, welche Ordner/Dateien was machen
+
+* ‘group vars/all.yml’: Hier sind Variable definiert, die für all Hosts gültig sind
+* `host_vars/<gateway>.yml`: spezifische Variablen für einen Host. Z.B. DHCP-Bereich. Außerdem sind hier Variablen,
+die für eine *Role* benutzt werden, defniniert.
+* ‘hosts.yml: eine Liste von Hosts. Hosts sind außerdem in einer Gruppe. Die Gruppe heißt i.d.R. ‘gateways`.
+Theoretisch können hier auch direkt Variablen für einen Host definiert werden. Das machen wir aber nicht. Wir
+definieren hier Variable für Gruppen.
+* ‘roles/*`: Hier liegen die Konfigurationen für die Roles. Die Role ‘base’ setzt für uns ein Gateway auf.
+* ‘playbook. yml*: die eigentliche Konfigurationsdatei. Hier steht, welche Hosts/Gruppen welche Rollen bekommen.
+
+Ein paar nützliche Befehle:
+
+* `ansible-playbook playbook.yml --list-hosts`
+* `ansible-playbook playbook.yml --list-tags` 
+* `ansible-playbook playbook.yml --list-tasks`
+* `ansible-playbook playbook.yml --list-tasks --tag powerdns`: zeigt alle tasks, die mit dem Tag powerdns versehen sind
+
 ## Setup
 Die Gateways werden mit einem [ansible-playbook](https://git.luebeck.freifunk.net/FreifunkLuebeck/gateway-config) aufgesetzt.
 
-- 
GitLab