Seminar croit Ceph Automatisierung mit API und Hook Scripts

Wiederkehrende Änderungen an großen Clustern müssen reproduzierbar, prüfbar und fehlertolerant ablaufen. Das Seminar verbindet die API der Managementplattform mit Ereignis-Hooks, Konfigurationsvorlagen und einem klaren Freigabemodell für produktive Automatisierungen.

Inhaltsübersicht

1. Seminarprofil
2. Lernziele
3. Zielgruppe
4. Voraussetzungen
5. Seminarinhalte
6. Praxisübungen

Seminarprofil

Das Seminar behandelt die kontrollierte Automatisierung von croit- und Ceph-Betriebsaufgaben. Im Fokus stehen API-Token, Rollen, Ressourcenabfragen, asynchrone Tasks, Fehlerbehandlung, Hook-Ereignisse, Templates, zusätzliche Dateien und Pakete sowie idempotente Abläufe mit Protokollierung und Rückfallstrategie.

Lernziele

• API-Zugriffe authentifizieren und nach minimalen Rechten absichern
• Ressourcen abfragen, ändern und asynchrone Tasks überwachen
• idempotente Workflows mit Vorabprüfung und Rückfallplan entwickeln
• Hook Scripts an geeignete Ereignisse binden und sicher testen
• Automatisierungen nachvollziehbar protokollieren und versionieren

Zielgruppe

Administratoren, DevOps- und Plattformteams sowie Entwickler betrieblicher Automatisierungen

Voraussetzungen

Sicherer Umgang mit Linux-Shell, HTTP-Grundlagen und Grundkenntnisse der croit Ceph Administration

Seminarinhalte

Schritt 1: Automatisierungsarchitektur

Ziele, Grenzen und Verantwortlichkeiten werden festgelegt. Direkte Ceph-Kommandos, Plattform-API und Hook Scripts erhalten klar getrennte Einsatzbereiche.

• deklarative und imperative Abläufe
• Kontrollpfad und Datenpfad
• Freigaben, Wartungsfenster und Auditierbarkeit

Schritt 2: Authentifizierung und Rollen

API-Token werden mit den Berechtigungen der zugehörigen Rolle geplant. Geheimnisse werden nicht in Skripten, Protokollen oder Repositories abgelegt.

• Token-Erzeugung und Lebenszyklus
• Admin- und Viewer-Rollen
• Secret Stores und Rotationsverfahren

Schritt 3: API-Ressourcen lesen

Abfragen werden zunächst rein lesend entwickelt. Filter, Pagination, Zustandsfelder und Versionsunterschiede werden robust verarbeitet.

• Server, Dienste, Pools, OSDs und Tasks
• Statuscodes und strukturierte Antworten
• Normalisierung und Validierung von Daten

Schritt 4: Änderungen und Tasks steuern

Schreibende Operationen werden über Vorbedingungen abgesichert. Asynchrone Aufgaben werden bis zum eindeutigen Endzustand verfolgt.

• Create-, Update- und Delete-Muster
• Task-UUID, Polling und Zeitlimits
• Abbruch, Wiederholung und Teilfehler

Schritt 5: Hook Scripts und Ereignisse

Hooks reagieren auf definierte Zustands- und Betriebsereignisse. Ausführungskontext, Parameter, Parallelität und Wiederholbarkeit werden berücksichtigt.

• Health-, Boot-, Netzwerk- und Backup-Ereignisse
• Bibliotheksskripte und eigene Skripte
• Testlauf, Rollout und Deaktivierung

Schritt 6: Templates, Zusatzdateien und Pakete

Unveränderliche Images werden durch verwaltete Erweiterungspunkte ergänzt. Persistenz und Abhängigkeiten werden explizit dokumentiert.

• Konfigurationsvorlagen und Variablen
• Extra Files und Rechte
• Pakete über reproduzierbare Hook-Abläufe

Schritt 7: Sicherheit und Fehlerbehandlung

Automatisierungen erhalten Eingabeprüfung, Schutz vor Mehrfachausführung und aussagekräftige Protokolle. Kritische Aktionen benötigen klare Stop-Kriterien.

• Least Privilege und Eingabevalidierung
• Dry Run, Locking und Idempotenz
• Rollback und menschliche Eskalation

Schritt 8: Praxisworkflow

Ein vollständiger Ablauf verbindet Zustandsabfrage, Änderung, Task-Überwachung und Abschlusskontrolle. Das Ergebnis wird als wiederverwendbares Betriebsmodul dokumentiert.

• Vorprüfung des Clusterzustands
• kontrollierte Änderung mit Zeitlimit
• technische und fachliche Nachprüfung

Praxisübungen

1. einen lesenden API-Client mit Pagination und Fehlerprüfung erstellen
2. eine Task-basierte Änderung mit Polling und Timeout umsetzen
3. einen Hook mit Test-, Freigabe- und Rückfallverfahren entwickeln