Konfiguration: Unterschied zwischen den Versionen
Technische Dokumentation aus aktuellem Quellcode |
MiQua Guide als Subprojekt dokumentiert |
||
| Zeile 14: | Zeile 14: | ||
* `limes` | * `limes` | ||
* `nowalux` | * `nowalux` | ||
* `miquaguide` | * `miquaguide` – aktives Subprojekt von MiQua mit direktem Stationszugriff ohne Anmeldung am Ticket-Monitor | ||
* `tine` | * `tine` | ||
* `hon` | * `hon` | ||
| Zeile 35: | Zeile 35: | ||
Die Status-Konfiguration ordnet den Projekten jeweils die internen und externen Dienste beziehungsweise Adressen zu. Sie dient dem zentralen Status-Monitor zur Prüfung der Projektinstanzen. | Die Status-Konfiguration ordnet den Projekten jeweils die internen und externen Dienste beziehungsweise Adressen zu. Sie dient dem zentralen Status-Monitor zur Prüfung der Projektinstanzen. | ||
== Authentifizierungsvarianten == | |||
Nicht alle Projektvarianten verwenden denselben Anmeldeweg. Das Subprojekt `miquaguide` kann Stationen direkt ansprechen, ohne dass sich der Nutzer über einen Ticket-Monitor anmeldet. Das Fehlen von Administratorfeldern in einem Konfigurationseintrag kann daher beabsichtigt sein und darf nicht automatisch als unvollständige Konfiguration bewertet werden. | |||
== Änderung einer Projektkonfiguration == | == Änderung einer Projektkonfiguration == | ||
Aktuelle Version vom 4. August 2026, 20:30 Uhr
Konfiguration
[Bearbeiten]Grundsatz
[Bearbeiten]Die maßgebliche Projektkonfiguration befindet sich im privaten Repository `tinetronics/megbes-config`. Das Wiki beschreibt Bedeutung und Pflege der Felder, ersetzt aber nicht die aktuelle Konfigurationsdatei.
megbes-external-config
[Bearbeiten]Die produktive Konfiguration enthält je Projekt einen eigenen Eintrag. Der aktuelle Stand umfasst unter anderem:
- `gse`
- `miqua`
- `bayam`
- `limes`
- `nowalux`
- `miquaguide` – aktives Subprojekt von MiQua mit direktem Stationszugriff ohne Anmeldung am Ticket-Monitor
- `tine`
- `hon`
- `messe`
- `gkp`
Zusätzlich existieren lokale Entwicklungs- beziehungsweise Testeinträge.
Zu den projektspezifischen Feldern gehören:
- Kommunikationsprotokoll zum internen Server
- Adresse des internen Servers
- Port des internen Servers
- bei Projekten mit zentraler Authentifizierung: initialer Administratorname und verschlüsseltes Administratorpasswort
Passwörter dürfen nur in der von MegBes erwarteten verschlüsselten Form in die Projektkonfiguration aufgenommen werden. Der Klartext gehört ausschließlich in den Passwortmanager.
megbes-status-config
[Bearbeiten]Die Status-Konfiguration ordnet den Projekten jeweils die internen und externen Dienste beziehungsweise Adressen zu. Sie dient dem zentralen Status-Monitor zur Prüfung der Projektinstanzen.
Authentifizierungsvarianten
[Bearbeiten]Nicht alle Projektvarianten verwenden denselben Anmeldeweg. Das Subprojekt `miquaguide` kann Stationen direkt ansprechen, ohne dass sich der Nutzer über einen Ticket-Monitor anmeldet. Das Fehlen von Administratorfeldern in einem Konfigurationseintrag kann daher beabsichtigt sein und darf nicht automatisch als unvollständige Konfiguration bewertet werden.
Änderung einer Projektkonfiguration
[Bearbeiten]- betroffenen Projekteintrag eindeutig bestimmen
- aktuellen Stand sichern und Änderung nachvollziehbar dokumentieren
- JSON-Syntax prüfen
- Geheimwerte nicht in Klartext eintragen
- Änderung über den vorgesehenen Git-Prozess bereitstellen
- betroffene Container kontrolliert neu laden oder starten
- External-, Internal- und Stationsfunktion testen
- Ergebnis und Datum auf der Projektseite dokumentieren
Benennung
[Bearbeiten]Die Bezeichner im Repository können von den im Alltag verwendeten Kürzeln abweichen, beispielsweise `nowalux` für LUX. Auf Projektseiten sollen deshalb sowohl Anzeigename als auch technischer Konfigurationsschlüssel angegeben werden.