JonnyBravo/ansible_pr-sentation
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Anpassung Powerpoint

Browse Source
This commit is contained in:
jonnybravo
2026-09-14 12:43:09 +02:00
parent 993d5f2e2b
commit b3b961dbda
5 changed files with 286 additions and 143 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+19 -17
View File
@@ -9,7 +9,7 @@ lauffähigen Beispiel-Projekt. Alles in Python generiert und reproduzierbar.
``` ```
ansible_präsentation/ ansible_präsentation/
├── ansible_praesentation.pptx # Die fertige Präsentation (19 Folien, 16:9) ├── ansible_praesentation.pptx # Die fertige Präsentation (21 Folien, 16:9)
├── create_presentation.py # Python-Skript, das die .pptx erzeugt ├── create_presentation.py # Python-Skript, das die .pptx erzeugt
├── handout.md # Handout (Markdown-Quelle) ├── handout.md # Handout (Markdown-Quelle)
├── handout.docx # Handout (druckbar/editierbar, für OnlyOffice) ├── handout.docx # Handout (druckbar/editierbar, für OnlyOffice)
@@ -25,7 +25,7 @@ ansible_präsentation/
## 1. Die Präsentation (`ansible_praesentation.pptx`) ## 1. Die Präsentation (`ansible_praesentation.pptx`)
19 Folien, 16:9, in den Ansible-Brandfarben (Rot `#EE0000`, Anthrazit `#1A1918`). 21 Folien, 16:9, in den Ansible-Brandfarben (Rot `#EE0000`, Anthrazit `#1A1918`).
| # | Titel | Inhalt | | # | Titel | Inhalt |
|---|-------|--------| |---|-------|--------|
@@ -33,21 +33,23 @@ ansible_präsentation/
| 2 | Was ist Ansible? | Definition, Merkmale (agentenlos, idempotent, …) | | 2 | Was ist Ansible? | Definition, Merkmale (agentenlos, idempotent, …) |
| 3 | Architektur | Control Node, Managed Nodes (Diagramm) | | 3 | Architektur | Control Node, Managed Nodes (Diagramm) |
| 4 | Vier Kernkonzepte | Playbooks, Inventory, Module, Rollen | | 4 | Vier Kernkonzepte | Playbooks, Inventory, Module, Rollen |
| 5 | YAML-Syntax | Grundregeln + Inventory-Beispiel | | 5 | ansible.cfg | Konfiguration, Suchreihenfolge (wer gewinnt) |
| 6 | Playbook | site.yml mit Tasks & FQCN | | 6 | ansible.cfg Parameter | Wichtige Werte in [defaults], [privilege_escalation], [ssh_connection] |
| 7 | Module | 6 Modul-Kategorien | | 7 | YAML-Syntax | Grundregeln + Inventory-Beispiel |
| 8 | Ad-hoc-Befehle | `ansible`-CLI ohne Playbook | | 8 | Playbook | site.yml mit Tasks & FQCN |
| 9 | Jinja2 | `{{ variable }}`, Filter, `.j2`-Templates | | 9 | Module | 6 Modul-Kategorien |
| 10 | Gather Facts | Facts auslesen, Custom Facts, `gather_facts` | | 10 | Ad-hoc-Befehle | `ansible`-CLI ohne Playbook |
| 11 | Variablen & Präzedenz | Quellen + Reihenfolge (wer gewinnt) | | 11 | Jinja2 | `{{ variable }}`, Filter, `.j2`-Templates |
| 12 | FQCN (Definition) | `namespace.collection.modul` | | 12 | Gather Facts | Facts auslesen, Custom Facts, `gather_facts` |
| 13 | FQCN (Praxis) | Beispiele + Warum | | 13 | Variablen & Präzedenz | Quellen + Reihenfolge (wer gewinnt) |
| 14 | Collections | Was sie sind (6 Bestandteile) | | 14 | FQCN (Definition) | `namespace.collection.modul` |
| 15 | Collections nutzen | Galaxy, Installation, Struktur | | 15 | FQCN (Praxis) | Beispiele + Warum |
| 16 | Rollen (Konzept) | Wiederverwendbarkeit, Kapselung | | 16 | Collections | Was sie sind (6 Bestandteile) |
| 17 | Rollen (Struktur) | `roles/webserver/` Verzeichnisbaum | | 17 | Collections nutzen | Galaxy, Installation, Struktur |
| 18 | Praxisbeispiel | Playbook mit Rolle + Variablen | | 18 | Rollen (Konzept) | Wiederverwendbarkeit, Kapselung |
| 19 | Zusammenfassung | Key-Takeaways + Quellen | | 19 | Rollen (Struktur) | `roles/webserver/` Verzeichnisbaum |
| 20 | Praxisbeispiel | Playbook mit Rolle + Variablen |
| 21 | Zusammenfassung | Key-Takeaways + Quellen |
**Design-Hinweis:** Die Präsentation nutzt die Schriftarten **Carlito** (Body) **Design-Hinweis:** Die Präsentation nutzt die Schriftarten **Carlito** (Body)
und **DejaVu Sans Mono** (Code), da Calibri/Consolas auf Linux oft fehlen und und **DejaVu Sans Mono** (Code), da Calibri/Consolas auf Linux oft fehlen und
ansible_praesentation.pptx
BIN
View File
Binary file not shown.
create_presentation.py
+180 -86
View File
@@ -168,16 +168,19 @@ def text(slide, x, y, w, h, runs, size=14, bold=False, color=BLACK,
p.line_spacing = leading p.line_spacing = leading
if space_after: if space_after:
p.space_after = Pt(space_after) p.space_after = Pt(space_after)
if isinstance(item, str): # item: str | tuple | dict (ein Run) ODER list (mehrere Runs inline)
item = {"t": item} subs = item if isinstance(item, list) else [item]
elif isinstance(item, tuple): for s in subs:
item = {"t": item[0], **item[1]} if isinstance(s, str):
r = p.add_run(); r.text = item["t"] s = {"t": s}
r.font.size = Pt(item.get("size", size)) elif isinstance(s, tuple):
r.font.bold = item.get("bold", bold) s = {"t": s[0], **s[1]}
r.font.italic = item.get("italic", False) r = p.add_run(); r.text = s["t"]
r.font.name = item.get("font", font) r.font.size = Pt(s.get("size", size))
r.font.color.rgb = item.get("color", color) r.font.bold = s.get("bold", bold)
r.font.italic = s.get("italic", False)
r.font.name = s.get("font", font)
r.font.color.rgb = s.get("color", color)
return box return box
@@ -191,10 +194,14 @@ def header(slide, kicker, title, dark=False):
slide.shapes.add_picture(logo, Inches(12.35), Inches(0.25), Inches(0.62), Inches(0.76)) slide.shapes.add_picture(logo, Inches(12.35), Inches(0.25), Inches(0.62), Inches(0.76))
def footer(slide, num): _page_no = 1 # Titel (Folie 1) zeigt keine sichtbare Nummer
def footer(slide):
global _page_no
_page_no += 1
text(slide, 0.55, 7.08, 9.0, 0.3, "Ansible — moderne Automatisierung", text(slide, 0.55, 7.08, 9.0, 0.3, "Ansible — moderne Automatisierung",
size=8, color=MIDGRAY) size=8, color=MIDGRAY)
text(slide, 12.2, 7.08, 0.6, 0.3, str(num), size=9, color=MIDGRAY, align=PP_ALIGN.RIGHT) text(slide, 12.2, 7.08, 0.6, 0.3, str(_page_no), size=9, color=MIDGRAY, align=PP_ALIGN.RIGHT)
def _set_run(r, text, font_size, color, bold=False): def _set_run(r, text, font_size, color, bold=False):
@@ -304,7 +311,7 @@ rect(s, 9.0, 0, 4.333, 7.5, RED, rounded=False)
if os.path.exists(LOGO_WHITE): if os.path.exists(LOGO_WHITE):
s.shapes.add_picture(LOGO_WHITE, Inches(0.9), Inches(1.35), Inches(2.1), Inches(2.59)) s.shapes.add_picture(LOGO_WHITE, Inches(0.9), Inches(1.35), Inches(2.1), Inches(2.59))
text(s, 0.9, 4.15, 7.5, 0.4, "MODERNE IT-AUTOMATISIERUNG", size=14, bold=True, color=RED) text(s, 0.9, 4.15, 7.5, 0.4, "MODERNE IT-AUTOMATISIERUNG", size=14, bold=True, color=RED)
text(s, 0.9, 4.55, 8.0, 1.3, "Ansible", size=60, bold=True, color=WHITE) text(s, 0.9, 4.55, 8.0, 0.95, "Ansible", size=60, bold=True, color=WHITE)
text(s, 0.9, 5.75, 7.5, 0.4, "Agentenlos · Idempotent · Deklarativ · YAML", text(s, 0.9, 5.75, 7.5, 0.4, "Agentenlos · Idempotent · Deklarativ · YAML",
size=16, color=RGBColor(0xD8, 0xD8, 0xD8)) size=16, color=RGBColor(0xD8, 0xD8, 0xD8))
text(s, 0.9, 6.55, 7.5, 0.4, text(s, 0.9, 6.55, 7.5, 0.4,
@@ -353,7 +360,7 @@ for big, small in facts:
text(s, 9.15, yy, 1.8, 0.5, big, size=22, bold=True, color=BLACK) text(s, 9.15, yy, 1.8, 0.5, big, size=22, bold=True, color=BLACK)
text(s, 10.95, yy + 0.08, 2.2, 0.5, small, size=11, color=GRAY, leading=1.0) text(s, 10.95, yy + 0.08, 2.2, 0.5, small, size=11, color=GRAY, leading=1.0)
yy += 0.62 yy += 0.62
footer(s, 2) footer(s)
# =========================================================================== # ===========================================================================
@@ -380,7 +387,7 @@ for t, d in comp:
text(s, 8.95, yy, 3.9, 0.3, t, size=13, bold=True, color=BLACK) text(s, 8.95, yy, 3.9, 0.3, t, size=13, bold=True, color=BLACK)
text(s, 8.95, yy + 0.28, 3.9, 0.9, d, size=10.5, color=GRAY, leading=1.05) text(s, 8.95, yy + 0.28, 3.9, 0.9, d, size=10.5, color=GRAY, leading=1.05)
yy += 1.22 yy += 1.22
footer(s, 3) footer(s)
# =========================================================================== # ===========================================================================
@@ -400,11 +407,98 @@ card(s, 0.55, 4.3, 6.0, 2.4, "3", "Module",
card(s, 6.85, 4.3, 6.0, 2.4, "4", "Rollen & Collections", card(s, 6.85, 4.3, 6.0, 2.4, "4", "Rollen & Collections",
"Rollen bündeln Tasks/Templates/Variablen zu wiederverwendbaren Einheiten. " "Rollen bündeln Tasks/Templates/Variablen zu wiederverwendbaren Einheiten. "
"Collections verteilen Module, Rollen & Plugins.") "Collections verteilen Module, Rollen & Plugins.")
footer(s, 4) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 5 — YAML-Syntax # FOLIE 5 — ansible.cfg (Konfiguration)
# ===========================================================================
s = new_slide(WHITE)
header(s, "Konfiguration", "ansible.cfg — die Konfigurationsdatei")
text(s, 0.55, 1.55, 12.2, 0.7,
"ansible.cfg steuert das Verhalten von Ansible global. INI-Format mit "
"Sektionen wie [defaults], [privilege_escalation] und [ssh_connection].",
size=13, color=BLACK, leading=1.15)
# links: Suchreihenfolge (erste gefundene Datei gewinnt)
text(s, 0.55, 2.4, 5.5, 0.3, "SUCHREIHENFOLGE — WER GEWINNT?", size=11, bold=True, color=RED)
order = [
("ANSIBLE_CONFIG", "Umgebungsvariable"),
("./ansible.cfg", "Projektverzeichnis"),
("~/.ansible.cfg", "Home-Verzeichnis"),
("/etc/ansible/ansible.cfg", "systemweit"),
]
yy = 2.9
for i, (p, d) in enumerate(order, 1):
rect(s, 0.55, yy, 0.4, 0.4, RED, rounded=True, radius=0.3)
text(s, 0.55, yy + 0.03, 0.4, 0.34, str(i), size=13, bold=True,
color=WHITE, align=PP_ALIGN.CENTER)
text(s, 1.15, yy + 0.04, 2.55, 0.32, p, size=11.5, bold=True,
color=DARKRED, font=FONT_MONO)
text(s, 3.85, yy + 0.06, 2.2, 0.5, d, size=10, color=GRAY, leading=1.0)
yy += 0.62
text(s, 0.55, yy + 0.15, 5.5, 0.6,
[[("Erste gefundene Datei gewinnt — ", {"bold": True}),
("kein Zusammenführen!", {"bold": True, "color": RED})]],
size=11.5, color=BLACK)
# rechts: Beispiel mit den wichtigsten Werten
code_block(s, 6.4, 2.4, 6.4, [
"# ansible.cfg (INI-Format)",
"[defaults]",
"inventory = ./inventory.yml",
"remote_user = admin",
"forks = 20",
"host_key_checking = False",
"gather_facts = True",
"roles_path = ./roles",
"",
"[privilege_escalation]",
"become = True",
"become_method = sudo",
"",
"[ssh_connection]",
"pipelining = True",
], font_size=10.5, title="Beispiel")
footer(s)
# ===========================================================================
# FOLIE 6 — ansible.cfg Parameter
# ===========================================================================
s = new_slide(WHITE)
header(s, "Konfiguration", "ansible.cfg — wichtige Parameter")
text(s, 0.55, 1.6, 3.9, 0.35, "[defaults]", size=13, bold=True, color=RED, font=FONT_MONO)
kv_rows(s, 0.55, 2.15, 3.9, [
("inventory", "Pfad zur Inventory-Datei"),
("remote_user", "Standard-SSH-Benutzer"),
("forks", "parallele Prozesse"),
("host_key_checking", "SSH-Key-Prüfung"),
("gather_facts", "Facts sammeln"),
("roles_path", "Suchpfad für Rollen"),
], key_w=1.65, name_size=10.5, desc_size=10, gap=0.46)
text(s, 4.7, 1.6, 3.9, 0.35, "[privilege_escalation]", size=13, bold=True, color=RED, font=FONT_MONO)
kv_rows(s, 4.7, 2.15, 3.9, [
("become", "sudo aktivieren"),
("become_method", "sudo / su"),
("become_user", "Ziel-Benutzer (root)"),
("become_ask_pass", "Passwort abfragen"),
], key_w=1.7, name_size=10.5, desc_size=10, gap=0.46)
text(s, 8.85, 1.6, 3.9, 0.35, "[ssh_connection]", size=13, bold=True, color=RED, font=FONT_MONO)
kv_rows(s, 8.85, 2.15, 3.9, [
("pipelining", "weniger SSH-Roundtrips"),
("ssh_args", "zusätzl. SSH-Argumente"),
("control_path", "ControlMaster-Socket"),
], key_w=1.5, name_size=10.5, desc_size=10, gap=0.46)
footer(s)
# ===========================================================================
# FOLIE 7 — YAML-Syntax
# =========================================================================== # ===========================================================================
s = new_slide(WHITE) s = new_slide(WHITE)
header(s, "Syntax", "YAML — die Sprache von Ansible") header(s, "Syntax", "YAML — die Sprache von Ansible")
@@ -439,16 +533,16 @@ code_block(s, 6.5, 1.6, 6.3, [
" - git", " - git",
" - curl", " - curl",
], font_size=11) ], font_size=11)
footer(s, 5) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 6 — Playbook & Tasks # FOLIE 8 — Playbook & Tasks
# =========================================================================== # ===========================================================================
s = new_slide(WHITE) s = new_slide(WHITE)
header(s, "Syntax", "Ein Playbook in der Praxis") header(s, "Syntax", "Ein Playbook in der Praxis")
text(s, 0.55, 1.55, 5.6, 1.4, text(s, 0.55, 1.55, 5.6, 1.4,
[("Ein Playbook ", {}), [[("Ein Playbook ", {}),
("definiert, was passieren soll. ", {}), ("definiert, was passieren soll. ", {}),
("plays", {"bold": True, "color": RED}), ("plays", {"bold": True, "color": RED}),
(" wirken auf ", {}), (" wirken auf ", {}),
@@ -457,7 +551,7 @@ text(s, 0.55, 1.55, 5.6, 1.4,
("task", {"bold": True, "color": RED}), ("task", {"bold": True, "color": RED}),
(" ruft genau ein ", {}), (" ruft genau ein ", {}),
("Modul", {"bold": True, "color": RED}), ("Modul", {"bold": True, "color": RED}),
(" auf.", {})], (" auf.", {})]],
size=12.5, color=BLACK, leading=1.2) size=12.5, color=BLACK, leading=1.2)
code_block(s, 6.5, 1.55, 6.3, [ code_block(s, 6.5, 1.55, 6.3, [
"---", "---",
@@ -477,11 +571,11 @@ code_block(s, 6.5, 1.55, 6.3, [
" state: started", " state: started",
" enabled: true", " enabled: true",
], font_size=10.5, title="site.yml") ], font_size=10.5, title="site.yml")
footer(s, 6) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 7 — Module # FOLIE 9 — Module
# =========================================================================== # ===========================================================================
s = new_slide(LIGHT) s = new_slide(LIGHT)
header(s, "Syntax", "Module — die Arbeitspferde") header(s, "Syntax", "Module — die Arbeitspferde")
@@ -502,25 +596,25 @@ for i, (t, d) in enumerate(mods):
col = i % 3; row = i // 3 col = i % 3; row = i // 3
card(s, 0.55 + col * 4.2, 2.6 + row * 1.75, 3.95, 1.5, "•", t, d) card(s, 0.55 + col * 4.2, 2.6 + row * 1.75, 3.95, 1.5, "•", t, d)
text(s, 0.55, 6.15, 12.2, 0.6, text(s, 0.55, 6.15, 12.2, 0.6,
[("Wichtig: Module werden heute über den ", {}), [[("Wichtig: Module werden heute über den ", {}),
("FQCN", {"bold": True, "color": RED}), ("FQCN", {"bold": True, "color": RED}),
(" referenziert (z.B. ", {}), (" referenziert (z.B. ", {}),
("ansible.builtin.apt", {"font": FONT_MONO, "color": DARKRED}), ("ansible.builtin.apt", {"font": FONT_MONO, "color": DARKRED}),
(").", {})], (").", {})]],
size=12, color=BLACK) size=12, color=BLACK)
footer(s, 7) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 8 — Ad-hoc-Befehle # FOLIE 10 — Ad-hoc-Befehle
# =========================================================================== # ===========================================================================
s = new_slide(WHITE) s = new_slide(WHITE)
header(s, "Syntax", "Ad-hoc-Befehle — Ansible ohne Playbook") header(s, "Syntax", "Ad-hoc-Befehle — Ansible ohne Playbook")
text(s, 0.55, 1.55, 5.7, 1.25, text(s, 0.55, 1.55, 5.7, 1.25,
[("Mit dem ", {}), [[("Mit dem ", {}),
("ansible", {"font": FONT_MONO, "color": DARKRED, "bold": True}), ("ansible", {"font": FONT_MONO, "color": DARKRED, "bold": True}),
("-CLI lassen sich einzelne Module direkt ausführen — ohne Playbook. Ideal " ("-CLI lassen sich einzelne Module direkt ausführen — ohne Playbook. Ideal "
"für schnelle Checks und einmalige Aktionen.", {})], "für schnelle Checks und einmalige Aktionen.", {})]],
size=12.5, color=BLACK, leading=1.2) size=12.5, color=BLACK, leading=1.2)
text(s, 0.55, 2.85, 5.7, 0.3, "AUFBAU", size=11, bold=True, color=RED) text(s, 0.55, 2.85, 5.7, 0.3, "AUFBAU", size=11, bold=True, color=RED)
code_block(s, 0.55, 3.2, 5.7, [ code_block(s, 0.55, 3.2, 5.7, [
@@ -552,11 +646,11 @@ code_block(s, 6.6, 1.55, 6.2, [
"ansible webserver -m service", "ansible webserver -m service",
" -a \"name=nginx state=restarted\"", " -a \"name=nginx state=restarted\"",
], font_size=10, title="Beispiele") ], font_size=10, title="Beispiele")
footer(s, 8) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 9 — Jinja2 (Templating) # FOLIE 11 — Jinja2 (Templating)
# =========================================================================== # ===========================================================================
s = new_slide(WHITE) s = new_slide(WHITE)
header(s, "Syntax", "Jinja2 — dynamische Inhalte") header(s, "Syntax", "Jinja2 — dynamische Inhalte")
@@ -565,21 +659,21 @@ text(s, 0.55, 1.55, 12.2, 0.7,
"und Dateien dynamisch erzeugt — in Playbooks, aber vor allem in Templates (.j2).", "und Dateien dynamisch erzeugt — in Playbooks, aber vor allem in Templates (.j2).",
size=13, color=BLACK, leading=1.15) size=13, color=BLACK, leading=1.15)
card(s, 0.55, 2.4, 4.0, 1.7, "1", "Variable auflösen", card(s, 0.55, 2.4, 4.0, 1.7, "1", "Variable auflösen",
[("{{ variable }}", {"font": FONT_MONO, "color": DARKRED, "bold": True}), [[("{{ variable }}", {"font": FONT_MONO, "color": DARKRED, "bold": True}),
(" setzt den Wert einer Variablen an die Stelle im Text ein.", {})]) (" setzt den Wert einer Variablen an die Stelle im Text ein.", {})]])
card(s, 4.75, 2.4, 4.0, 1.7, "2", "Filter anwenden", card(s, 4.75, 2.4, 4.0, 1.7, "2", "Filter anwenden",
[("{{ wert | filter }}", {"font": FONT_MONO, "color": DARKRED, "bold": True}), [[("{{ wert | filter }}", {"font": FONT_MONO, "color": DARKRED, "bold": True}),
(" transformiert Werte (z.B. ", {}), (" transformiert Werte (z.B. ", {}),
("upper", {"font": FONT_MONO}), ("upper", {"font": FONT_MONO}),
(", ", {}), (", ", {}),
("default", {"font": FONT_MONO}), ("default", {"font": FONT_MONO}),
(").", {})]) (").", {})]])
card(s, 8.95, 2.4, 3.85, 1.7, "3", "Template-Dateien", card(s, 8.95, 2.4, 3.85, 1.7, "3", "Template-Dateien",
[("Dateien mit Endung ", {}), [[("Dateien mit Endung ", {}),
(".j2", {"font": FONT_MONO, "color": DARKRED, "bold": True}), (".j2", {"font": FONT_MONO, "color": DARKRED, "bold": True}),
(" werden vom Modul ", {}), (" werden vom Modul ", {}),
("template", {"font": FONT_MONO}), ("template", {"font": FONT_MONO}),
(" gerendert.", {})]) (" gerendert.", {})]])
code_block(s, 0.55, 4.35, 6.0, [ code_block(s, 0.55, 4.35, 6.0, [
"# Variablen auflösen", "# Variablen auflösen",
"msg: \"Hallo {{ benutzer }}\"", "msg: \"Hallo {{ benutzer }}\"",
@@ -596,22 +690,22 @@ code_block(s, 6.85, 4.35, 6.0, [
" root {{ web_root }};", " root {{ web_root }};",
"}", "}",
], font_size=10.5, title="nginx.conf.j2") ], font_size=10.5, title="nginx.conf.j2")
footer(s, 9) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 10 — Gather Facts # FOLIE 12 — Gather Facts
# =========================================================================== # ===========================================================================
s = new_slide(WHITE) s = new_slide(WHITE)
header(s, "Facts", "Gather Facts — Systeminformationen") header(s, "Facts", "Gather Facts — Systeminformationen")
text(s, 0.55, 1.5, 12.2, 0.7, text(s, 0.55, 1.5, 12.2, 0.7,
[("Ansible sammelt beim Start automatisch ", {}), [[("Ansible sammelt beim Start automatisch ", {}),
("Facts", {"bold": True}), ("Facts", {"bold": True}),
(" (Systeminfos) über jeden Host — über das Modul ", {}), (" (Systeminfos) über jeden Host — über das Modul ", {}),
("setup", {"font": FONT_MONO, "color": DARKRED}), ("setup", {"font": FONT_MONO, "color": DARKRED}),
(", standardmäßig ", {}), (", standardmäßig ", {}),
("gather_facts: true", {"font": FONT_MONO, "color": DARKRED}), ("gather_facts: true", {"font": FONT_MONO, "color": DARKRED}),
(".", {})], (".", {})]],
size=13, color=BLACK, leading=1.15) size=13, color=BLACK, leading=1.15)
# Links: Facts als einzelne Spalte (breite Schlüssel-Spalte -> kein Umbruch) # Links: Facts als einzelne Spalte (breite Schlüssel-Spalte -> kein Umbruch)
@@ -639,11 +733,11 @@ code_block(s, 7.55, 2.4, 5.2, [
"# Datei: /etc/ansible/facts.d/app.fact", "# Datei: /etc/ansible/facts.d/app.fact",
"# Abruf: {{ ansible_local.app.version }}", "# Abruf: {{ ansible_local.app.version }}",
], font_size=11, title="Zugriff & Custom Facts") ], font_size=11, title="Zugriff & Custom Facts")
footer(s, 10) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 11 — Variablen & Auflösung (Präzedenz) # FOLIE 13 — Variablen & Auflösung (Präzedenz)
# =========================================================================== # ===========================================================================
s = new_slide(LIGHT) s = new_slide(LIGHT)
header(s, "Variablen", "Variablen definieren & auflösen") header(s, "Variablen", "Variablen definieren & auflösen")
@@ -682,21 +776,21 @@ for i, (t, d) in enumerate(prec, 1):
text(s, 11.0, yy + 0.02, 1.85, 0.34, d, size=9, color=GRAY, font=FONT_MONO) text(s, 11.0, yy + 0.02, 1.85, 0.34, d, size=9, color=GRAY, font=FONT_MONO)
yy += 0.5 yy += 0.5
text(s, 6.85, yy + 0.1, 6.0, 0.6, text(s, 6.85, yy + 0.1, 6.0, 0.6,
[("Faustregel: ", {"bold": True, "color": RED}), [[("Faustregel: ", {"bold": True, "color": RED}),
("je spezifischer die Quelle, desto höher die Priorität.", {})], ("je spezifischer die Quelle, desto höher die Priorität.", {})]],
size=11, color=GRAY) size=11, color=GRAY)
footer(s, 11) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 12 — FQCN (Definition) # FOLIE 14 — FQCN (Definition)
# =========================================================================== # ===========================================================================
s = new_slide(WHITE) s = new_slide(WHITE)
header(s, "FQCN", "FQCN — Fully Qualified Collection Name") header(s, "FQCN", "FQCN — Fully Qualified Collection Name")
rect(s, 0.55, 1.55, 12.2, 0.95, LIGHT, line=BORDER, line_w=1.0, rounded=True, radius=0.1) rect(s, 0.55, 1.55, 12.2, 0.95, LIGHT, line=BORDER, line_w=1.0, rounded=True, radius=0.1)
text(s, 0.85, 1.77, 11.6, 0.55, text(s, 0.85, 1.77, 11.6, 0.55,
[("FQCN = ", {"bold": True, "color": RED}), [[("FQCN = ", {"bold": True, "color": RED}),
("eindeutige, vollständige Referenz auf ein Modul oder Plugin.", {})], ("eindeutige, vollständige Referenz auf ein Modul oder Plugin.", {})]],
size=16, color=BLACK) size=16, color=BLACK)
text(s, 0.85, 2.75, 11.6, 0.6, "namespace · collection · modul", text(s, 0.85, 2.75, 11.6, 0.6, "namespace · collection · modul",
size=28, bold=True, color=BLACK) size=28, bold=True, color=BLACK)
@@ -710,16 +804,16 @@ code_block(s, 0.55, 3.6, 12.2, [
"# copy -> modul (die Funktion)", "# copy -> modul (die Funktion)",
], font_size=12, title="Beispiel") ], font_size=12, title="Beispiel")
text(s, 0.55, 6.15, 12.2, 0.5, text(s, 0.55, 6.15, 12.2, 0.5,
[("NICHT verwechseln mit ", {"bold": True}), [[("NICHT verwechseln mit ", {"bold": True}),
("FQDN", {"font": FONT_MONO, "color": DARKRED, "bold": True}), ("FQDN", {"font": FONT_MONO, "color": DARKRED, "bold": True}),
(" (Fully Qualified Domain Name = Hostname)! Der FQCN macht eindeutig, " (" (Fully Qualified Domain Name = Hostname)! Der FQCN macht eindeutig, "
"aus welcher Collection ein Modul stammt.", {})], "aus welcher Collection ein Modul stammt.", {})]],
size=12.5, color=BLACK) size=12.5, color=BLACK)
footer(s, 12) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 13 — FQCN (Beispiele & Warum) # FOLIE 15 — FQCN (Beispiele & Warum)
# =========================================================================== # ===========================================================================
s = new_slide(WHITE) s = new_slide(WHITE)
header(s, "FQCN", "FQCN in der Praxis") header(s, "FQCN", "FQCN in der Praxis")
@@ -742,23 +836,23 @@ for fqcn, d in ex:
text(s, 7.35, 1.6, 5.4, 0.4, "WARUM FQCN?", size=11, bold=True, color=RED) text(s, 7.35, 1.6, 5.4, 0.4, "WARUM FQCN?", size=11, bold=True, color=RED)
rect(s, 7.35, 2.1, 5.45, 4.35, LIGHT, line=BORDER, line_w=1.0, rounded=True, radius=0.05) rect(s, 7.35, 2.1, 5.45, 4.35, LIGHT, line=BORDER, line_w=1.0, rounded=True, radius=0.05)
text(s, 7.65, 2.35, 4.9, 3.9, [ text(s, 7.65, 2.35, 4.9, 3.9, [
("Seit Ansible 2.10 sind Module in ", {}), [("Seit Ansible 2.10 sind Module in ", {}),
("Collections", {"bold": True}), ("Collections", {"bold": True}),
(" gebündelt.\n\n", {}), (" gebündelt.", {})],
("Der FQCN macht eindeutig, ", {}), [("Der FQCN macht eindeutig, ", {}),
("welches Modul", {"bold": True}), ("welches Modul", {"bold": True}),
(" gemeint ist.\n\n", {}), (" gemeint ist.", {})],
("Er vermeidet ", {}), [("Er vermeidet ", {}),
("Namenskollisionen", {"bold": True}), ("Namenskollisionen", {"bold": True}),
(" — mehrere Collections können ein gleichnamiges Modul anbieten.\n\n", {}), (" — mehrere Collections können ein gleichnamiges Modul anbieten.", {})],
("Faustregel: ", {"bold": True, "color": RED}), [("Faustregel: ", {"bold": True, "color": RED}),
("immer den FQCN verwenden, nie die Kurzform.", {}), ("immer den FQCN verwenden, nie die Kurzform.", {})],
], size=12.5, color=BLACK, leading=1.25) ], size=12.5, color=BLACK, leading=1.25, space_after=8)
footer(s, 13) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 14 — Collections (Definition) # FOLIE 16 — Collections (Definition)
# =========================================================================== # ===========================================================================
s = new_slide(LIGHT) s = new_slide(LIGHT)
header(s, "Collections", "Was sind Collections?") header(s, "Collections", "Was sind Collections?")
@@ -778,19 +872,19 @@ cols = [
for i, (t, d) in enumerate(cols): for i, (t, d) in enumerate(cols):
col = i % 3; row = i // 3 col = i % 3; row = i // 3
card(s, 0.55 + col * 4.2, 3.0 + row * 1.6, 3.95, 1.35, "•", t, d) card(s, 0.55 + col * 4.2, 3.0 + row * 1.6, 3.95, 1.35, "•", t, d)
footer(s, 14) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 15 — Collections (Struktur & Galaxy) # FOLIE 17 — Collections (Struktur & Galaxy)
# =========================================================================== # ===========================================================================
s = new_slide(WHITE) s = new_slide(WHITE)
header(s, "Collections", "Collections nutzen") header(s, "Collections", "Collections nutzen")
text(s, 0.55, 1.55, 5.8, 0.3, "BEZUGSQUELLE", size=11, bold=True, color=RED) text(s, 0.55, 1.55, 5.8, 0.3, "BEZUGSQUELLE", size=11, bold=True, color=RED)
text(s, 0.55, 1.9, 5.8, 0.85, text(s, 0.55, 1.9, 5.8, 0.85,
[("Ansible Galaxy", {"bold": True}), [[("Ansible Galaxy", {"bold": True}),
(" (galaxy.ansible.com) ist der zentrale Hub — vergleichbar mit einem " (" (galaxy.ansible.com) ist der zentrale Hub — vergleichbar mit einem "
"Paket-Manager für Ansible-Inhalte.", {})], "Paket-Manager für Ansible-Inhalte.", {})]],
size=12, color=BLACK, leading=1.15) size=12, color=BLACK, leading=1.15)
text(s, 0.55, 2.85, 5.8, 0.3, "INSTALLATION", size=11, bold=True, color=RED) text(s, 0.55, 2.85, 5.8, 0.3, "INSTALLATION", size=11, bold=True, color=RED)
code_block(s, 0.55, 3.25, 5.8, [ code_block(s, 0.55, 3.25, 5.8, [
@@ -805,11 +899,11 @@ code_block(s, 0.55, 3.25, 5.8, [
], font_size=11, title="galaxy") ], font_size=11, title="galaxy")
text(s, 6.85, 1.55, 5.9, 0.3, "NAMENSSCHEMA", size=11, bold=True, color=RED) text(s, 6.85, 1.55, 5.9, 0.3, "NAMENSSCHEMA", size=11, bold=True, color=RED)
text(s, 6.85, 1.9, 5.9, 0.45, text(s, 6.85, 1.9, 5.9, 0.45,
[("namespace", {"font": FONT_MONO, "color": DARKRED, "bold": True}), [[("namespace", {"font": FONT_MONO, "color": DARKRED, "bold": True}),
(" . ", {"color": BLACK, "bold": True}), (" . ", {"color": BLACK, "bold": True}),
("name", {"font": FONT_MONO, "color": DARKRED, "bold": True}), ("name", {"font": FONT_MONO, "color": DARKRED, "bold": True}),
(" → z.B. ", {}), (" → z.B. ", {}),
("ansible.posix", {"font": FONT_MONO, "color": DARKRED, "bold": True})], ("ansible.posix", {"font": FONT_MONO, "color": DARKRED, "bold": True})]],
size=14) size=14)
text(s, 6.85, 2.5, 5.9, 0.3, "AUFBAU EINER COLLECTION", size=11, bold=True, color=RED) text(s, 6.85, 2.5, 5.9, 0.3, "AUFBAU EINER COLLECTION", size=11, bold=True, color=RED)
code_block(s, 6.85, 2.9, 5.9, [ code_block(s, 6.85, 2.9, 5.9, [
@@ -821,11 +915,11 @@ code_block(s, 6.85, 2.9, 5.9, [
" docs/", " docs/",
" galaxy.yml", " galaxy.yml",
], font_size=11.5, title="ansible.posix") ], font_size=11.5, title="ansible.posix")
footer(s, 15) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 16 — Rollen (Konzept) # FOLIE 18 — Rollen (Konzept)
# =========================================================================== # ===========================================================================
s = new_slide(LIGHT) s = new_slide(LIGHT)
header(s, "Rollen", "Wie funktionieren Rollen?") header(s, "Rollen", "Wie funktionieren Rollen?")
@@ -844,16 +938,16 @@ points = [
for i, (t, d) in enumerate(points): for i, (t, d) in enumerate(points):
col = i % 2; row = i // 2 col = i % 2; row = i // 2
card(s, 0.55 + col * 6.2, 3.0 + row * 1.8, 5.95, 1.55, "✓", t, d) card(s, 0.55 + col * 6.2, 3.0 + row * 1.8, 5.95, 1.55, "✓", t, d)
footer(s, 16) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 17 — Rollen (Verzeichnisstruktur) # FOLIE 19 — Rollen (Verzeichnisstruktur)
# =========================================================================== # ===========================================================================
s = new_slide(WHITE) s = new_slide(WHITE)
header(s, "Rollen", "Die Verzeichnisstruktur einer Rolle") header(s, "Rollen", "Die Verzeichnisstruktur einer Rolle")
text(s, 0.55, 1.55, 5.5, 0.3, "ANATOMIE", size=11, bold=True, color=RED) text(s, 0.55, 1.55, 5.5, 0.3, "ANATOMIE", size=11, bold=True, color=RED)
text(s, 0.55, 1.9, 5.5, 0.9, text(s, 0.55, 1.9, 5.5, 0.6,
"Eine Rolle folgt einem festen Aufbau. Jede Datei hat eine klar definierte " "Eine Rolle folgt einem festen Aufbau. Jede Datei hat eine klar definierte "
"Aufgabe — Ansible lädt sie automatisch.", "Aufgabe — Ansible lädt sie automatisch.",
size=12, color=BLACK, leading=1.15) size=12, color=BLACK, leading=1.15)
@@ -886,25 +980,25 @@ code_block(s, 6.7, 1.55, 6.1, [
" meta/", " meta/",
" main.yml", " main.yml",
], font_size=11.5, title="roles/webserver/") ], font_size=11.5, title="roles/webserver/")
footer(s, 17) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 18 — Praxisbeispiel # FOLIE 20 — Praxisbeispiel
# =========================================================================== # ===========================================================================
s = new_slide(LIGHT) s = new_slide(LIGHT)
header(s, "Praxis", "Alles zusammen: Playbook mit Rolle") header(s, "Praxis", "Alles zusammen: Playbook mit Rolle")
text(s, 0.55, 1.55, 5.3, 0.3, "ZUSAMMENSPIEL", size=11, bold=True, color=RED) text(s, 0.55, 1.55, 5.3, 0.3, "ZUSAMMENSPIEL", size=11, bold=True, color=RED)
text(s, 0.55, 1.9, 5.3, 2.8, text(s, 0.55, 1.9, 5.3, 2.8, [
[("Das Playbook referenziert die Rolle ", {}), [("Das Playbook referenziert die Rolle ", {}),
("webserver", {"font": FONT_MONO, "color": DARKRED, "bold": True}), ("webserver", {"font": FONT_MONO, "color": DARKRED, "bold": True}),
(". FQCN-Module (", {}), (". FQCN-Module (", {}),
("ansible.builtin.*", {"font": FONT_MONO, "color": DARKRED}), ("ansible.builtin.*", {"font": FONT_MONO, "color": DARKRED}),
(") arbeiten im Hintergrund.\n\n", {}), (") arbeiten im Hintergrund.", {})],
("1.", {"bold": True, "color": RED}), (" Rolle wird geladen.\n", {}), [("1.", {"bold": True, "color": RED}), (" Rolle wird geladen.", {})],
("2.", {"bold": True, "color": RED}), (" Aufgaben & Variablen aus der Rolle gelten.\n", {}), [("2.", {"bold": True, "color": RED}), (" Aufgaben & Variablen aus der Rolle gelten.", {})],
("3.", {"bold": True, "color": RED}), (" Idempotenz verhindert doppelte Arbeit.", {})], [("3.", {"bold": True, "color": RED}), (" Idempotenz verhindert doppelte Arbeit.", {})],
size=12, color=BLACK, leading=1.25) ], size=12, color=BLACK, leading=1.25, space_after=6)
code_block(s, 6.15, 1.55, 6.6, [ code_block(s, 6.15, 1.55, 6.6, [
"---", "---",
"- name: Webserver ausrollen", "- name: Webserver ausrollen",
@@ -917,11 +1011,11 @@ code_block(s, 6.15, 1.55, 6.6, [
" vars:", " vars:",
" nginx_port: 8080", " nginx_port: 8080",
], font_size=11, title="deploy.yml") ], font_size=11, title="deploy.yml")
footer(s, 18) footer(s)
# =========================================================================== # ===========================================================================
# FOLIE 19 — Zusammenfassung & Quellen # FOLIE 21 — Zusammenfassung & Quellen
# =========================================================================== # ===========================================================================
s = new_slide(LIGHT) s = new_slide(LIGHT)
header(s, "Fazit", "Zusammenfassung") header(s, "Fazit", "Zusammenfassung")
@@ -949,7 +1043,7 @@ text(s, 10.05, 3.95, 2.5, 1.9,
["docs.ansible.com", "galaxy.ansible.com", "github.com/ansible", ["docs.ansible.com", "galaxy.ansible.com", "github.com/ansible",
"Logo: Wikimedia Commons"], "Logo: Wikimedia Commons"],
size=9.5, color=GRAY, leading=1.4) size=9.5, color=GRAY, leading=1.4)
footer(s, 19) footer(s)
# --------------------------------------------------------------------------- # ---------------------------------------------------------------------------
handout.docx
BIN
View File
Binary file not shown.
handout.md
+49 -2
View File
@@ -1,6 +1,6 @@
# Ansible — Syntax & Variablen-Handout # Ansible — Syntax & Variablen-Handout
Kompakte Referenz zu YAML-Syntax, Ad-hoc-Befehlen, Jinja2, Facts, Variablen-Auflösung und FQCN. Kompakte Referenz zu YAML-Syntax, Ad-hoc-Befehlen, Jinja2, Facts, Variablen-Auflösung, FQCN und ansible.cfg.
--- ---
@@ -195,7 +195,54 @@ ansible.builtin.apt:
--- ---
## 8. Vollständiges Beispiel ## 8. ansible.cfg — Konfiguration
INI-Datei, die Ansible global steuert. Ansible nutzt die **erste** gefundene
Datei (kein Zusammenführen):
1. `ANSIBLE_CONFIG` — Umgebungsvariable (expliziter Pfad)
2. `./ansible.cfg` — aktuelles Verzeichnis (Projekt)
3. `~/.ansible.cfg` — Home-Verzeichnis (Benutzer)
4. `/etc/ansible/ansible.cfg` — systemweit (Fallback)
Wichtige Werte:
| Sektion | Schlüssel | Bedeutung |
|---------------------------|--------------------|------------------------------------|
| `[defaults]` | `inventory` | Pfad zur Inventory-Datei |
| | `remote_user` | Standard-SSH-Benutzer |
| | `forks` | parallele Prozesse (Default 5) |
| | `host_key_checking`| SSH-Key-Prüfung (True/False) |
| | `gather_facts` | Facts automatisch sammeln |
| | `roles_path` | Suchpfad für Rollen |
| `[privilege_escalation]` | `become` | sudo aktivieren |
| | `become_method` | sudo / su |
| | `become_user` | Ziel-Benutzer (Default root) |
| `[ssh_connection]` | `pipelining` | Performance-Optimierung |
| | `ssh_args` | zusätzliche SSH-Argumente |
Beispiel:
```ini
[defaults]
inventory = ./inventory.yml
remote_user = admin
forks = 20
host_key_checking = False
gather_facts = True
roles_path = ./roles
[privilege_escalation]
become = True
become_method = sudo
[ssh_connection]
pipelining = True
```
---
## 9. Vollständiges Beispiel
**Playbook** (`deploy.yml`): **Playbook** (`deploy.yml`):