ansible_präsentation/
├── create_presentation.py             # Python-Skript, das die .pptx erzeugt
├── README.md                          # Diese Übersicht
├── Dokumentation/
│   ├── ansible_praesentation.pptx     # Die fertige Präsentation (23 Folien, 16:9)
│   ├── handout.md                     # Handout (Markdown-Quelle)
│   └── handout.docx                   # Handout (druckbar/editierbar, für OnlyOffice)
├── assets/
│   ├── ansible_mark_red.png           # Ansible-Logo (rot) — Quelle: Wikimedia Commons
│   ├── ansible_mark_white.png         # Ansible-Logo (weiß)
│   ├── ansible_logo.svg               # Logo-Quelldatei (SVG)
│   └── architektur.png                # Architektur-Diagramm (automatisch erzeugt)
└── Beispiel/                          # Lauffähiges Beispiel-Playbook (siehe unten)

1. Die Präsentation (`ansible_praesentation.pptx`)

23 Folien, 16:9, in den Ansible-Brandfarben (Rot #EE0000, Anthrazit #1A1918).

#	Titel	Inhalt
1	Titel	Agenda, Ansible-Logo
2	Was ist Ansible?	Definition, Merkmale (agentenlos, idempotent, …)
3	Architektur	Control Node, Managed Nodes (Diagramm)
4	Vier Kernkonzepte	Playbooks, Inventory, Module, Rollen
5	ansible.cfg	Konfiguration, Suchreihenfolge (wer gewinnt)
6	ansible.cfg Parameter	Wichtige Werte in [defaults], [privilege_escalation], [ssh_connection]
7	YAML-Syntax	Grundregeln + Inventory-Beispiel
8	Playbook	site.yml mit Tasks & FQCN
9	Module	6 Modul-Kategorien
10	Ad-hoc-Befehle	`ansible`-CLI ohne Playbook
11	Jinja2	`{{ variable }}`, Filter, `.j2`-Templates
12	Gather Facts	Facts auslesen, Custom Facts, `gather_facts`
13	Variablen & Präzedenz	Quellen + Reihenfolge (wer gewinnt)
14	Ansible Vault (Konzept)	AES-256, `$ANSIBLE_VAULT`-Header, sicher in Git
15	Ansible Vault (Praxis)	`encrypt_string` (!vault-Variable) + ganze Datei (`create`/`encrypt`/`view`/`edit`/`decrypt`), `--ask-vault-pass`
16	FQCN (Definition)	`namespace.collection.modul`
17	FQCN (Praxis)	Beispiele + Warum
18	Collections	Was sie sind (6 Bestandteile)
19	Collections nutzen	Galaxy, Installation, Struktur
20	Rollen (Konzept)	Wiederverwendbarkeit, Kapselung
21	Rollen (Struktur)	`roles/webserver/` Verzeichnisbaum
22	Praxisbeispiel	Playbook mit Rolle + Variablen
23	Zusammenfassung	Key-Takeaways + Quellen

Design-Hinweis: Die Präsentation nutzt die Schriftarten Carlito (Body) und DejaVu Sans Mono (Code), da Calibri/Consolas auf Linux oft fehlen und OnlyOffice sonst substituiert (was zu gebrochenen Sonderzeichen führt).

2. Skript neu ausführen (`create_presentation.py`)

Das Skript erzeugt die .pptx vollständig reproduzierbar.

Voraussetzungen:

pip install python-pptx matplotlib Pillow

Ausführen:

python3 create_presentation.py

Das Skript:

erzeugt das Architektur-Diagramm (assets/architektur.png) selbst per matplotlib,
nutzt die Logo-PNGs aus assets/ (Quelle: Wikimedia Commons),
setzt die Folien aus Python-Code zusammen (jede Folie ist eine Funktion/Sektion).

3. Das Handout (`handout.md` / `handout.docx`)

Kompakte Referenz mit:

YAML-Grundsyntax
Ad-hoc-Befehle
Jinja2 (Variablen auflösen, Filter, .j2)
Gather Facts
Wo Variablen definiert werden
Ansible Vault (Variable per !vault + ganze Datei)
Variablen-Präzedenz (Auflösungs-Reihenfolge)
Module & FQCN
ansible.cfg (Suchreihenfolge + Parameter)
Vollständiges Beispiel

Das .docx wird aus dem .md per pandoc erzeugt:

cd Dokumentation
pandoc handout.md -o handout.docx

4. Das Beispiel-Projekt (`Beispiel/`)

Ein vollständiges, lauffähiges Ansible-Projekt, das Rollen-Struktur, Variablen-Präzedenz und Templating für localhost demonstriert.

Siehe Beispiel/README.md für Details. Kurz:

cd Beispiel
ansible-playbook site.yml --check   # Trockenlauf
ansible-playbook site.yml           # echt ausführen

Die Struktur zeigt:

roles/webserver/ mit tasks, handlers, templates, defaults, vars, meta
Variablen-Präzedenz: defaults (80) → host_vars (8080) → -e (gewinnt)
Jinja2-Templates (nginx.conf.j2, index.html.j2 mit Schleife + Filter)
Facts (ansible_facts['distribution'], ansible_facts['hostname'], …)
FQCN (ansible.builtin.*)
connection: local — läuft direkt auf dem Rechner, kein SSH (localhost ist kein echter Host)

Hinweis: Das Beispiel nutzt apt (Debian/Ubuntu). Auf Manjaro/Arch verwendet man stattdessen community.general.pacman (Anpassung in Beispiel/README.md beschrieben).

Quellen & Lizenz

Ansible-Dokumentation: https://docs.ansible.com
Ansible Galaxy: https://galaxy.ansible.com
Ansible-Repository: https://github.com/ansible/ansible
Ansible-Logo: Wikimedia Commons (https://commons.wikimedia.org/wiki/File:Ansible_logo.svg)

README.md

Ansible-Präsentation — Übersicht

Inhalt des Ordners

1. Die Präsentation (ansible_praesentation.pptx)

2. Skript neu ausführen (create_presentation.py)

3. Das Handout (handout.md / handout.docx)

4. Das Beispiel-Projekt (Beispiel/)

Quellen & Lizenz

1. Die Präsentation (`ansible_praesentation.pptx`)

2. Skript neu ausführen (`create_presentation.py`)

3. Das Handout (`handout.md` / `handout.docx`)

4. Das Beispiel-Projekt (`Beispiel/`)