Seminar Kuzzle Admin Console und Kourou CLI – Administration und Datenpflege

Das Seminar vermittelt einen kontrollierten Administrationsworkflow für Daten, Benutzer, Berechtigungen und Diagnose. Grafische Arbeitsschritte in der Admin Console werden mit reproduzierbaren Kourou-Kommandos verbunden, damit manuelle Tätigkeiten in dokumentierte Betriebsverfahren überführt werden können. Theorie, Demonstration und Laborarbeit wechseln in kurzen Zyklen. Jeder technische Schritt wird durch eine Kontrollabfrage, einen Negativtest oder eine nachvollziehbare Zustandsprüfung abgeschlossen.

Inhaltsübersicht

• Zielgruppe und Voraussetzungen
• Didaktischer Zuschnitt
• Sichere Administrationsumgebung und Verbindungen
• Indizes, Collections und Dokumente verwalten
• Benutzer, Rollen und Profile administrieren
• Kourou-Automatisierung, Diagnose und Übergabe
• Praxisprojekt und Lernerfolgskontrolle

Zielgruppe und Voraussetzungen

Kapitelinhaltsverzeichnis

• Adressierte Rollen
• Erforderliche Vorkenntnisse
• Labor- und Arbeitsmittel
• Einstiegskontrolle

Zielgruppe: Kuzzle-Administration, technische Anwendungsbetreuung, DevOps-nahe Teams, Support und Datenverantwortung.

Voraussetzungen: Grundkenntnisse zu Web-APIs, JSON und rollenbasierter Zugriffskontrolle; Zugriff auf eine isolierte Laborinstanz.

Zu Beginn werden Vorkenntnisse, Laborzugang, Namenskonventionen und Sicherheitsregeln geprüft. Fehlende Grundlagen werden als konkrete Vorbereitungspunkte dokumentiert; produktive Systeme und reale Zugangsdaten werden in den Übungen nicht verwendet.

Didaktischer Zuschnitt

Kapitelinhaltsverzeichnis

• Begründung der Dauer
• Arbeitsweise
• Dokumentationsstandard
• Qualitätssicherung

Begründung der Dauer: Zwei Tage sind notwendig, weil zunächst sichere Verbindungen, Datenoperationen und Berechtigungen praktisch aufgebaut werden. Der zweite Tag wird für Kourou-Automatisierung, Fehlerbehandlung, Export, Wiederholungstests und ein vollständiges Administrationsszenario benötigt.

Die Lerneinheiten folgen dem Muster Analyse, Aufbau, Funktionsnachweis, Fehlerfall und Wiederholung. Konfigurationen und Testdaten werden versionierbar gehalten. Entscheidungen werden mit Annahme, Alternative, Risiko und Prüfmethode dokumentiert. Dadurch entsteht neben dem fachlichen Verständnis ein direkt nutzbares Arbeitsverfahren.

1. Sichere Administrationsumgebung und Verbindungen

Kapitelinhaltsverzeichnis

• Laborinstanz und Komponenten
• Verbindungsprofile und Endpunkte
• Erste Administration und Standardrechte
• Rollen für Betrieb und Support

Dieses Kapitel verbindet Laborinstanz und Komponenten, Verbindungsprofile und Endpunkte, Erste Administration und Standardrechte und Rollen für Betrieb und Support. Die Arbeitsschritte werden in einer isolierten Laborumgebung ausgeführt, protokolliert und gegen einen vorher festgelegten Sollzustand geprüft. Technische Entscheidungen werden so dokumentiert, dass Umsetzung, Review und Wiederholung ohne stille Annahmen möglich bleiben.

Schritt-für-Schritt-Anleitung

1. Schritt 1 – Eine isolierte Laborinstanz starten und API, Admin Console sowie Kourou auf Erreichbarkeit prüfen: Vor Beginn werden Zweck, Eingaben, Abhängigkeiten und ein messbares Erfolgskriterium notiert. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
2. Schritt 2 – Verbindungsprofile mit eindeutigen Umgebungsnamen, Endpunkten und Zertifikatsanforderungen anlegen: Die Konfiguration wird zunächst klein aufgebaut, anschließend gespeichert und durch eine unabhängige Abfrage kontrolliert. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
3. Schritt 3 – Die erste administrative Identität einrichten und anonyme Standardrechte bewusst einschränken: Der Normalfall wird mit bekannten Testdaten ausgeführt; relevante IDs, Zeitpunkte und Rückgabewerte werden festgehalten. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
4. Schritt 4 – Betriebsrollen für Datenpflege, Benutzerverwaltung und Diagnose voneinander trennen: Mindestens ein typischer Fehlerfall wird absichtlich ausgelöst, beobachtet und ohne verdeckte manuelle Korrektur behoben. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
5. Schritt 5 – Den Ausgangszustand protokollieren und mit einer Wiederholungscheckliste verifizieren: Zum Abschluss wird der Sollzustand erneut geprüft und als wiederholbare Checkliste oder automatisierter Test gesichert. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.

Kontrollpunkte

• Der Sollzustand für Laborinstanz und Komponenten ist durch eine reproduzierbare Prüfung nachgewiesen.
• Fehlkonfigurationen in Verbindungsprofile und Endpunkte erzeugen verständliche und protokollierte Fehler.
• Die Umsetzung zu Rollen für Betrieb und Support lässt sich ohne persönliche Einzelkenntnisse wiederholen.
• Berechtigungen, Daten und Protokolle enthalten nur die für die Aufgabe erforderlichen Informationen.

Praxisaufgabe

Eine neue Laborumgebung wird so vorbereitet, dass Zugriff, Rollen und Verbindungsparameter durch eine zweite Person reproduziert werden können. Die Abnahme erfolgt anhand einer kurzen Demonstration, einer Konfigurationsprüfung und eines gezielt ausgelösten Fehlerfalls.

2. Indizes, Collections und Dokumente verwalten

Kapitelinhaltsverzeichnis

• Datenhierarchie
• Mappings und Collection-Eigenschaften
• Dokumentoperationen
• Suche, Filter und Export

Dieses Kapitel verbindet Datenhierarchie, Mappings und Collection-Eigenschaften, Dokumentoperationen und Suche, Filter und Export. Die Arbeitsschritte werden in einer isolierten Laborumgebung ausgeführt, protokolliert und gegen einen vorher festgelegten Sollzustand geprüft. Technische Entscheidungen werden so dokumentiert, dass Umsetzung, Review und Wiederholung ohne stille Annahmen möglich bleiben.

Schritt-für-Schritt-Anleitung

1. Schritt 1 – Einen fachlich abgegrenzten Index mit zwei Collections planen und Namensregeln festlegen: Vor Beginn werden Zweck, Eingaben, Abhängigkeiten und ein messbares Erfolgskriterium notiert. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
2. Schritt 2 – Mappings vor dem ersten Datenimport definieren und unveränderliche Feldtypen berücksichtigen: Die Konfiguration wird zunächst klein aufgebaut, anschließend gespeichert und durch eine unabhängige Abfrage kontrolliert. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
3. Schritt 3 – Testdokumente anlegen, aktualisieren, versionieren und kontrolliert löschen: Der Normalfall wird mit bekannten Testdaten ausgeführt; relevante IDs, Zeitpunkte und Rückgabewerte werden festgehalten. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
4. Schritt 4 – Suchabfragen mit Filtern, Sortierung und begrenzter Ergebnismenge ausführen: Mindestens ein typischer Fehlerfall wird absichtlich ausgelöst, beobachtet und ohne verdeckte manuelle Korrektur behoben. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
5. Schritt 5 – Einen nachvollziehbaren Datenexport erzeugen und Stichproben gegen den Quellbestand prüfen: Zum Abschluss wird der Sollzustand erneut geprüft und als wiederholbare Checkliste oder automatisierter Test gesichert. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.

Kontrollpunkte

• Der Sollzustand für Datenhierarchie ist durch eine reproduzierbare Prüfung nachgewiesen.
• Fehlkonfigurationen in Mappings und Collection-Eigenschaften erzeugen verständliche und protokollierte Fehler.
• Die Umsetzung zu Suche, Filter und Export lässt sich ohne persönliche Einzelkenntnisse wiederholen.
• Berechtigungen, Daten und Protokolle enthalten nur die für die Aufgabe erforderlichen Informationen.

Praxisaufgabe

Ein kleiner Datenbestand wird über die Oberfläche angelegt und anschließend mit Kourou geprüft, geändert und exportiert. Die Abnahme erfolgt anhand einer kurzen Demonstration, einer Konfigurationsprüfung und eines gezielt ausgelösten Fehlerfalls.

3. Benutzer, Rollen und Profile administrieren

Kapitelinhaltsverzeichnis

• Rollen als Aktionslisten
• Profile als Berechtigungskombination
• Benutzer und Credentials
• Negativtests und Freigabe

Dieses Kapitel verbindet Rollen als Aktionslisten, Profile als Berechtigungskombination, Benutzer und Credentials und Negativtests und Freigabe. Die Arbeitsschritte werden in einer isolierten Laborumgebung ausgeführt, protokolliert und gegen einen vorher festgelegten Sollzustand geprüft. Technische Entscheidungen werden so dokumentiert, dass Umsetzung, Review und Wiederholung ohne stille Annahmen möglich bleiben.

Schritt-für-Schritt-Anleitung

1. Schritt 1 – Eine Berechtigungsmatrix aus Fachaufgaben, API-Aktionen und Datenbereichen ableiten: Vor Beginn werden Zweck, Eingaben, Abhängigkeiten und ein messbares Erfolgskriterium notiert. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
2. Schritt 2 – Rollen mit minimal notwendigen Aktionen erstellen und sprechend benennen: Die Konfiguration wird zunächst klein aufgebaut, anschließend gespeichert und durch eine unabhängige Abfrage kontrolliert. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
3. Schritt 3 – Profile aus Rollen zusammensetzen und Einschränkungen für Indizes sowie Collections hinterlegen: Der Normalfall wird mit bekannten Testdaten ausgeführt; relevante IDs, Zeitpunkte und Rückgabewerte werden festgehalten. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
4. Schritt 4 – Benutzer mit passenden Profilen anlegen und den Credential-Lebenszyklus dokumentieren: Mindestens ein typischer Fehlerfall wird absichtlich ausgelöst, beobachtet und ohne verdeckte manuelle Korrektur behoben. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
5. Schritt 5 – Erlaubte und verbotene Aktionen mit Positiv- und Negativtests nachweisen: Zum Abschluss wird der Sollzustand erneut geprüft und als wiederholbare Checkliste oder automatisierter Test gesichert. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.

Kontrollpunkte

• Der Sollzustand für Rollen als Aktionslisten ist durch eine reproduzierbare Prüfung nachgewiesen.
• Fehlkonfigurationen in Profile als Berechtigungskombination erzeugen verständliche und protokollierte Fehler.
• Die Umsetzung zu Negativtests und Freigabe lässt sich ohne persönliche Einzelkenntnisse wiederholen.
• Berechtigungen, Daten und Protokolle enthalten nur die für die Aufgabe erforderlichen Informationen.

Praxisaufgabe

Für Redaktion, Support und Administration werden getrennte Berechtigungsmodelle erstellt und systematisch getestet. Die Abnahme erfolgt anhand einer kurzen Demonstration, einer Konfigurationsprüfung und eines gezielt ausgelösten Fehlerfalls.

4. Kourou-Automatisierung, Diagnose und Übergabe

Kapitelinhaltsverzeichnis

• SDK-Ausführung über CLI
• Skripte und Parameter
• Fehler- und Rückgabecodes
• Betriebsdokumentation

Dieses Kapitel verbindet SDK-Ausführung über CLI, Skripte und Parameter, Fehler- und Rückgabecodes und Betriebsdokumentation. Die Arbeitsschritte werden in einer isolierten Laborumgebung ausgeführt, protokolliert und gegen einen vorher festgelegten Sollzustand geprüft. Technische Entscheidungen werden so dokumentiert, dass Umsetzung, Review und Wiederholung ohne stille Annahmen möglich bleiben.

Schritt-für-Schritt-Anleitung

1. Schritt 1 – Wiederkehrende Einzelaktionen zunächst interaktiv mit Kourou ausführen und Ergebnisobjekte lesen: Vor Beginn werden Zweck, Eingaben, Abhängigkeiten und ein messbares Erfolgskriterium notiert. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
2. Schritt 2 – Mehrere SDK-Aufrufe in ein parametrisierbares, idempotentes Administrationsskript überführen: Die Konfiguration wird zunächst klein aufgebaut, anschließend gespeichert und durch eine unabhängige Abfrage kontrolliert. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
3. Schritt 3 – Zeitüberschreitungen, Berechtigungsfehler und Teilfehler gezielt auslösen und behandeln: Der Normalfall wird mit bekannten Testdaten ausgeführt; relevante IDs, Zeitpunkte und Rückgabewerte werden festgehalten. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
4. Schritt 4 – Ausgaben so strukturieren, dass Protokollierung, Review und Wiederanlauf möglich sind: Mindestens ein typischer Fehlerfall wird absichtlich ausgelöst, beobachtet und ohne verdeckte manuelle Korrektur behoben. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.
5. Schritt 5 – Das Skript mit Runbook, Prüfpunkten und Rückfallverfahren an den Betrieb übergeben: Zum Abschluss wird der Sollzustand erneut geprüft und als wiederholbare Checkliste oder automatisierter Test gesichert. Der Bezug zum behandelten Kuzzle-Funktionsbereich wird anhand des laufenden Praxisfalls nachvollzogen.

Kontrollpunkte

• Der Sollzustand für SDK-Ausführung über CLI ist durch eine reproduzierbare Prüfung nachgewiesen.
• Fehlkonfigurationen in Skripte und Parameter erzeugen verständliche und protokollierte Fehler.
• Die Umsetzung zu Betriebsdokumentation lässt sich ohne persönliche Einzelkenntnisse wiederholen.
• Berechtigungen, Daten und Protokolle enthalten nur die für die Aufgabe erforderlichen Informationen.

Praxisaufgabe

Ein Administrationslauf legt Testdaten und Berechtigungen an, prüft den Sollzustand und räumt die Umgebung kontrolliert auf. Die Abnahme erfolgt anhand einer kurzen Demonstration, einer Konfigurationsprüfung und eines gezielt ausgelösten Fehlerfalls.

Praxisprojekt und Lernerfolgskontrolle

Kapitelinhaltsverzeichnis

• Projektauftrag
• Zwischenprüfungen
• Fehler- und Sicherheitsnachweis
• Technische Abnahme

Das Praxisprojekt verbindet die Kapitel zu einer konsistenten Laborlösung. Vor jedem Inkrement werden Ausgangszustand, Ziel, Eingaben und Abnahmekriterien festgelegt. Nach der Umsetzung folgen Funktionsprüfung, Negativtest, kurze Dokumentationskontrolle und Rücksetzung auf einen bekannten Zustand.

1. Projektauftrag schneiden: Ein fachlich begrenzter Anwendungsfall wird in Daten, Akteure, Schnittstellen, Berechtigungen und Betriebsanforderungen zerlegt.
2. Inkremente umsetzen: Die Kapitelbausteine werden schrittweise integriert; nach jedem Inkrement bleibt die Laborlösung lauffähig.
3. Fehler nachweisen: Mindestens ein Berechtigungs-, Daten-, Verbindungs- oder Konfigurationsfehler wird kontrolliert ausgelöst und diagnostiziert.
4. Abnahme durchführen: Eine technische Checkliste prüft Funktion, Sicherheit, Wiederholbarkeit, Protokollierung und Rückfallfähigkeit.
5. Lernstand dokumentieren: Offene Vertiefungen werden als priorisierte Aufgaben mit benötigtem Nachweis festgehalten.

Die Lernerfolgskontrolle besteht aus kurzen Verständnisfragen, beobachteten Laboraufgaben, einer Fehlersuche und der technischen Abnahme des Praxisprojekts. Bewertet werden nicht nur funktionierende Ergebnisse, sondern auch Begründung, Nachweis, sichere Fehlerbehandlung und Reproduzierbarkeit.