Konfiguration
Konfiguration
Grundsatz
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
Die produktive Konfiguration enthält je Projekt einen eigenen Eintrag. Der aktuelle Stand umfasst unter anderem:
- `gse`
- `miqua`
- `bayam`
- `limes`
- `nowalux`
- `miquaguide`
- `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
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.
Änderung einer Projektkonfiguration
- 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
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.