update readme, etc.

README.md

@@ -1,5 +1,63 @@
 # Beispiel Ansible
 
+## Erste schritte
+
+```sh
+# Installiere ansible
+apt update
+apt install -y ansible
+
+# Kopiere die "skeleton" rolle
+cp -r roles/{skeleton,webserver}
+
+# Editiere die inventory datei
+$EDITOR inventory
+```
+
+Wenn die rolle kopiert ist, musst du sie in der `site.yml` noch importieren:
+
+```yaml
+- name: Import webserver role
+  hosts:
+    - all
+  roles:
+    - webserver
+```
+
+## Relevante befehle/tasks
+
+### Rolle ausführen
+
+```sh
+# Auf deinem Rechner
+ansible-playbook site.yml
+```
+
+### Webserver neuladen
+
+```sh
+# Auf dem Raspi
+sudo nginx -s reload
+```
+
+(oder)
+
+```yaml
+# In deiner Rolle
+- name: Reload nginx
+  ansible.builtin.systemd_service:
+    name: nginx
+    state: reloaded
+```
+
 ## TODO
 
-- [ ] Write a proper readme for the poor intern cursed with this playbook
+- [ ] Installiere einen Webserver (apache/traefik/nginx/lighttpd)
+- [ ] Serviere `files/index.html` (unter `/var/www/html/index.html` ablegen)
+- [ ] Bonusaufgabe: aktiviere eine Password-Authentifizierung (Basic Auth)
+
+## Relevante Dokumentation
+
+- [Paket Installieren](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/package_module.html)
+- [Datei kopieren](https://docs.ansible.com/ansible/latest/collections/ansible/builtin/file_module.html)
+- [NGINX basic auth](https://docs.nginx.com/nginx/admin-guide/security-controls/configuring-http-basic-authentication/)

files/index.html

@@ -0,0 +1 @@
+<img src="https://snaile.de/glizzy.gif">

roles/skeleton/defaults/main.yml

@@ -1,2 +1,2 @@
 ---
-# defaults file for basic
+# defaults file for skeleton

roles/skeleton/handlers/main.yml

@@ -1,2 +1,2 @@
 ---
-# handlers file for basic
+# handlers file for skeleton

roles/skeleton/tasks/main.yml

@@ -1,2 +1,2 @@
 ---
-# tasks file for basic
+# tasks file for skeleton

roles/skeleton/vars/main.yml

@@ -1,2 +1,2 @@
 ---
-# vars file for basic
+# vars file for skeleton

site.yml

@@ -1,6 +1,6 @@
 ---
-- name: Import example role
+# - name: Import skeleton role
-  hosts:
+#   hosts:
-    - all
+#     - all
-  roles:
+#   roles:
-    - example
+#     - skeleton