Betriebshandbuch

Ihre Mission: Administration der Ferrosoft-Infrastruktur und Deployment der Ferrosoft Plattform (Emiflow). Dieses Handbuch ist Ihre Lagekarte — studieren Sie es, bevor Sie ins Feld gehen.

Voraussetzungen für den Einsatz

Ohne die folgenden Zugänge ist die Mission nicht durchführbar. Beschaffen Sie diese, bevor Sie beginnen:

• Schlüsseldatenbank FerrosoftOperations.kdbx (KeePassXC) — enthält die gemeinsam genutzten Passwörter für den Betrieb.
  • Zugang erfordert eine Schlüsseldatei.
  • Datenbank und Schlüsseldatei müssen vorab beschafft werden.
• Gitlab Ferrosoft-Gruppe — Zugang zum Infrastruktur-Repository und zum Configs-Repository.
  • Eigener Account erforderlich. Lassen Sie sich von einem bestehenden Mitglied freischalten.

Anforderungen an das Einsatzsystem

Ihr Gerät muss einsatzbereit sein. Folgende Plattformen sind bekannt:

• Linux — Bevorzugte Plattform. Distribution irrelevant, solange die erforderlichen Programme installiert werden können.
• Windows — Nicht im Feld getestet. Verwenden Sie das Windows Subsystem für Linux (WSL2).
• macOS — Nicht im Feld getestet. Verwenden Sie eine Linux-VM.

Erforderliche Ausrüstung

Stellen Sie sicher, dass folgende Programme einsatzbereit sind:

• KeePassXC
• GNU make
• Python 3.14
• Go
• OpenSSH
• GNU Privacy Guard (GPG)
• Git-crypt
• uv
• direnv
• dhall conversion programs
  • dhall-json
  • dhall-yaml
  • dhall-toml

Containerisierte Ausrüstung

Das Infrastruktur-Repository stellt im Unterordner operator ein einsatzbereites Dockerfile bereit. Dieses enthält sämtliche oben aufgeführten Tools mit Ausnahme von KeePassXC. Nutzen Sie den Container, um den Einrichtungsaufwand zu minimieren. Weitere Details entnehmen Sie der README.md im selben Unterordner.

1. Container bauen

make build

2. Container ausführen

make run