admin/platform-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
platform-docs/00-glossary.md
Thomas Stallinger 8ece25f954 docs: define Merkmal/Blueprint/Bereitstellungsvorlage model (ADR-0002) 
Introduces the Merkmal-Backend-Blueprint realization model: a Merkmal
describes one distribution-independent workspace feature, a Blueprint
realizes exactly one Merkmal for exactly one backend (usually an
Ansible role applied post-first-boot via ansible-pull), and a
Bereitstellungsvorlage bundles workspace + backend + org-specific
installation directives (partitioning, encryption, secure boot).

Replaces the old flat profile model (profiles/profile.json/
distribution+version) throughout the provisioning API, data model,
interactive provisioning flow, and device enrollment docs with
templates/Bereitstellungsvorlage terminology. Moves 02-workspace-model.md
and 04-backend-model.md into architecture/, archives the superseded
flat organization-model.md.
2026-07-18 10:45:48 +02:00

2.0 KiB
Raw Blame History

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.

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