Grundlagen der Konfiguration

KiloCenter-Konfigurationsdateien und Basiseinstellungen — config.docker.yaml, KC-Core, KC-Gateway, Portzuordnungen.

Ziel

Verstehen und die grundlegende Laufzeitkonfiguration für eine lokale Bereitstellung überprüfen.

Konfigurationsdateien

• kilocenter-modules/config/config.docker.yaml -- KC-Core-Konfiguration (Container-Modus)

• kilocenter-modules/KC-Core/config.yaml -- KC-Core-Konfiguration (Quellcode-Entwicklermodus)

• kilocenter-modules/KC-Gateway/config.yaml -- KC-Gateway-Konfiguration (Quellcode-Entwicklermodus)

• kilocenter-modules/docker-compose.yml -- Dienstdefinitionen und Portzuordnungen

Standardwerte im Container-Modus

Im Container-Modus liest KC-Core config/config.docker.yaml. Alle Dienstadressen verwenden Docker-Service-DNS-Namen (z. B. postgres, redis, mosquitto). Umgebungsvariablen in .env überschreiben die Standardwerte von Compose.

Standardwerte im Quellcode-Entwicklermodus

kilocenter-modules/start-dev.sh exportiert Umgebungsvariablen und erkennt den PostgreSQL-Port automatisch:

• Wenn der Docker-Container kilocenter-postgres ausgeführt wird, verwendet er Port 5433.

• Andernfalls fällt er zurück auf 5432 für ein auf dem Host lokal laufendes PostgreSQL.

Vor dem Testen zu überprüfende Einstellungen

• Datenbank: Host, Port, Zugangsdaten (Standard: localhost:5433, Benutzer kilocenter, Passwort changeme)

• KC-Core-Status: Port 8086

• KC-Gateway gRPC-Web: Port 9090

• KC-Gateway-Status: Port 8087

• BSSCI: Port 5000, TLS-Zertifikatspfade

• SCACI: Port 5001, TLS-Zertifikatspfade

• MQTT: Broker-Host, Port und Zugangsdaten

TLS-Zertifikatspfade

Die TLS-Zertifikatspfade für BSSCI und SCACI werden unter dem protocol Abschnitt in KC-Core/config.yaml (Quellcode-Entwicklermodus) oder config/config.docker.yaml (Container):

protocol:
  bsci_tls:
    enabled: true
    cert_file: "certificates/server.crt"
    key_file: "certificates/server.key"
    ca_file: "certificates/ca.crt"
    min_version: "1.2"
  scaci_tls:
    enabled: true
    cert_file: "certificates/server.crt"
    key_file: "certificates/server.key"
    ca_file: "certificates/ca.crt"
    min_version: "1.3"

Die Pfade in der Quellcode-Entwicklerkonfiguration beziehen sich relativ auf das Arbeitsverzeichnis von KC-Core. Die Containerkonfiguration verwendet absolute Pfade (/app/certificates/). Generieren Sie Zertifikate vor dem ersten Start — siehe Docker-Compose-Installation.

Standardanmeldedaten

Diese Standardwerte dienen der Bequemlichkeit bei der lokalen Entwicklung. Ändern Sie sie für jede nichtlokale Bereitstellung:

• PostgreSQL: Benutzer kilocenter, Passwort changeme

• MQTT-Broker: Benutzer admin, Passwort KiloCenter

• Standard-Login der AVA-Basisstation: ubuntu / 123456

MQTT-Integration

MQTT ist standardmäßig deaktiviert in KC-Core/config.yaml:

mqtt:
  enabled: false
  host: "localhost"
  port: 1883
  username: "admin"
  password: "KiloCenter"

Um MQTT zu aktivieren, setzen Sie enabled: true und starten Sie KC-Core neu. Der Mosquitto-Broker muss laufen (er ist im Docker-Compose-Stack enthalten). Siehe MQTT First Steps für Integrationsdetails.

Validierungs-Checkliste

• KC-Core startet ohne Fehler und /health antwortet auf Port 8086

• KC-Gateway startet und /health antwortet auf Port 8087

• Container-Modus: KC-Web lädt unter http://localhost/

• Quellcode-Entwicklungsmodus: KC-Web lädt unter http://localhost:5173

• KC-Web kann KC-Gateway auf Port erreichen 9090 (gRPC-web-Anfragen sind in der Browserkonsole erfolgreich)