Thomas Stallinger
217f672ddd
ADR-0010 decides that an Auftrag is technically a Merkmal, not a new parallel entity: it reuses the existing Merkmal/Blueprint/ansible-role mechanism from ADR-0002, but adds a device-level, independently toggleable assignment path (device_merkmale) alongside the existing workspace-level one. Deselecting an Auftrag needs to actually revert it, so checkin will need to declare a full present/absent state per catalog entry rather than just an additive list; that role-level and API-level work is deferred, this only settles the data model. Also adds a single generic, append-only event log (device_merkmal_events) for both selection changes and agent-reported execution results, instead of several purpose-specific tables, so future event types don't require schema changes. Extends 09-data-model-v1.md and the glossary accordingly. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
3.3 KiB
Tuxflotte Glossary
Status: Stable
Datum: 2026-07-07
Workspace
Ein fachlich definierter Arbeitsplatz.
Ein Workspace beschreibt, welchen Zielzustand ein System haben soll.
Beispiele:
- Developer Workspace
- Office Workspace
- Kiosk Workspace
Ein Workspace ist nicht distributionsabhängig.
Backend
Eine distributionsspezifische Implementierung.
Ein Backend beschreibt, wie ein Workspace auf einer bestimmten Distribution installiert wird.
Beispiele:
- Fedora Backend
- Mint Backend
- Debian Backend
Organization
Eine Organisation beschreibt kunden- oder unternehmensweite Vorgaben.
Beispiele:
- Zertifikate
- LDAP
- Keycloak
- Paketquellen
- Proxy
- Branding
- VPN
- Monitoring
Merkmal
Eine einzelne fachliche Eigenschaft eines Workspace, distributionsunabhängig benannt.
Beispiele:
- browser-brave
- office-onlyoffice
- guest-session-ephemeral
Ein Workspace besteht aus einer Menge von Merkmalen.
Blueprint
Die technische Umsetzung genau eines Merkmals für genau ein Backend.
Ein Blueprint ist im Regelfall eine Ansible-Rolle beziehungsweise -Aufgabe, die nach dem ersten Start über den bestehenden Ansible-Pull-Mechanismus angewendet wird.
Details: architecture/12-feature-blueprint-model.md.
Auftragskatalog
Die Menge der Merkmale, die zusätzlich zur Workspace-Zugehörigkeit direkt einem einzelnen, bereits provisionierten Device zugewiesen und wieder entzogen werden können.
Ein Auftrag ist fachlich und technisch ein Merkmal (im_auftragskatalog = true) — kein eigenständiges Modell. Der Unterschied zur gewöhnlichen Workspace-Zuweisung ist ausschließlich der Zuweisungsweg: geräteweise und jederzeit veränderbar, statt fix über die Bereitstellungsvorlage zum Installationszeitpunkt.
Aufträge werden zur besseren Übersicht optional einer Kategorie zugeordnet.
Details: architecture/09-data-model-v1.md, ADR-0010.
Kategorie
Eine Gruppierung von Merkmalen im Auftragskatalog, ausschließlich zur Darstellung — ohne fachliche Wirkung auf die Anwendung eines Merkmals.
Runtime Blueprint
Die zur Installationszeit erzeugte vollständige Zielbeschreibung.
Sie entsteht aus:
- den aufgelösten Blueprints der Merkmale des Workspace für das gewählte Backend
- direkten Organization- und Backend-Vorgaben (zum Beispiel Partitionierung, Verschlüsselung)
- optional Benutzerkontext
Orchestrator
Die Komponente der Provisioning-ISO, die den Ablauf steuert.
Der Orchestrator erkennt Hardware, lädt Profile, erzeugt Runtime Blueprints und startet das passende Backend.
Provisioning Agent
Der Agent läuft auf dem installierten System und übernimmt Registrierung, Nachkonfiguration, Inventarisierung und Lebenszyklusaufgaben.
Native Installer
Der offizielle Installer der jeweiligen Distribution.
Beispiele:
- Anaconda
- Calamares
- Debian Installer
- Subiquity
Auto-Modus
Ein Bootmodus der Provisionierungs-ISO, in dem Bereitstellungsvorlage-Auswahl und Commit-Point-Bestätigung ohne Benutzereingabe erfolgen.
Nur für bereits registrierte Geräte zulässig (device.registration_status == "existing").
Details: architecture/13-live-provisioning-boot.md.
Interaktiv-Modus
Der in F-005 (architecture/10-interactive-provisioning-flow.md) beschriebene Ablauf mit expliziter Benutzerinteraktion bei Bereitstellungsvorlage-Auswahl und Installationsbestätigung.