Adding README.md and some useful directories

diff --git a/README.md b/README.md
new file mode 100644 (file)
index 0000000..4dde1a7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+# Administration tools
+
+Das ist eine Sammlung von Scripten (belibigert Programmiersprachen),
+die bei der Admministration von RedHat-basierten Linux-Systemen (>=7.0) helfen sollen.
+
+Dieses Repository soll später die Grundlage für ein noch zu schaffendes RPM-Paket sein,
+das dann auf allen passenden Linux-Hosts installiert und über Puppet aktualisiert werden soll.
+
+## Verzeichnisstruktur
+
+Erster Vorschlag zur Verzeichnisstruktur:
+
+### bin/ - Installierbare Scripte
+
+Hier werden alle ausführbaren Scripte untergebracht, die dann später über das RPM-Paket
+in einem noch zu definierenden Verzeichnis (möglicherweise `/opt/pp-admin-tools/bin`)
+installiert werden, welches dann noch irgendwie in den Suchpfad von *root* aufgenommen werden muss.
+
+### etc/ - Konfigurations-Dateien
+
+Diese werden nicht über das RPM-Paket installiert. Überhaupt sollten die Konfigurations-Dateien selbst
+nicht mit eingecheckt werden, sondern lediglich Vorlagen für diese Konfigurations-Dateien.
+
+### group_vars/ - Variablen-Definitionen für Ansible
+
+Ähnlich wie `etc/`, aber sie könne auch eingecheckt sein. Sie werden durch das RPM-Paket
+nicht mit installiert. Sie sollten im **YAML** Format vorliegen.
+
+### inventory/ - Inventory-Dateien für Ansible
+
+Bitte nach Möglichkeit **YAML** Dateien verwenden.
+
+### lib/ - Bibliotheken und Resource-Files
+
+Hier werden alle Hilfsdateien untergebracht, die zur Ausführung der Scripte unter `bin/` und `sbin/`
+notwendig sind, wie Python-Module oder Bash-Resource-Files. Hier liegen keine YAML-Dateien für Ansible.
+
+### roles/ - Rollendefinitionen für Ansible
+
+Sie werden durch das RPM-Paket nicht mit installiert.
+
+### sbin/ - Nicht installierbare Scripte
+
+Hier werden alle ausführbaren Scripte untergebracht, die nicht über das RPM-Paket installiert werden,
+sondern nur auf der Arbeitsstation des Administrators ausgeführt werden.
+
+

diff --git a/etc/.gitignore b/etc/.gitignore
new file mode 100644 (file)
index 0000000..2798a26
--- /dev/null
+++ b/etc/.gitignore
@@ -0,0 +1,3 @@
+*.ini
+*.conf
+*.cnf

diff --git a/group_vars/.gitkeep b/group_vars/.gitkeep
new file mode 100644 (file)
index 0000000..e69de29

diff --git a/roles/.gitkeep b/roles/.gitkeep
new file mode 100644 (file)
index 0000000..e69de29