Konfiguration

Cuby speichert seine Konfiguration und alle Produktdaten im Verzeichnis ~/.processcube/. Der Speicherort kann über die Umgebungsvariable CUBY_CONFIG_DIR geändert werden.

Konfigurationsdatei

Die zentrale Konfiguration liegt in ~/.processcube/config.json:

{
  "autostart": false,
  "setupComplete": true,
  "lastSync": "2025-01-01T00:00:00.000Z",
  "installedProducts": [
    {
      "instanceId": "processcube-engine",
      "id": "processcube-engine",
      "alias": null,
      "name": "ProcessCube.Engine",
      "npmPackage": "@processcube/engine.cuby",
      "version": "1.0.0",
      "type": "npx"
    }
  ]
}

Produkt-Einträge

Verzeichnisstruktur

~/.processcube/
├── config.json                    # Hauptkonfiguration
├── processcube-config.json        # ProcessCube Plugin-Konfigurationen
├── running-pids.json              # PIDs laufender Prozesse (Orphan-Cleanup)
├── products/                      # Installierte Produkte
│   └── Product_Name/
│       ├── node_modules/          # npm-Abhängigkeiten
│       ├── .cuby-worker.mjs       # Worker-Skript (generiert)
│       ├── deploy.log             # Deploy-Log
│       ├── start.log              # Start-Log
│       └── output.log             # Prozess-Ausgabe
└── nodejs/                        # Verwaltetes Node.js
    └── .fnm/
        └── node-versions/
            └── v22.21.1/

Secret Store

API Keys und Plugin-Secrets werden nicht in config.json gespeichert, sondern im Secret Store:

Migration

Beim ersten Start wird ein eventuell in config.json vorhandener apiKey automatisch in den Secret Store migriert und aus der Datei entfernt.

Plugin-Scoping

Secrets sind auf {instanceId}:{secretName} gescoped. Ein Plugin kann nur auf seine eigenen Secrets zugreifen.

ProcessCube® Plugin-Konfigurationen

Plugin-spezifische Konfigurationen (z.B. welche Ports ein Plugin nutzt, welche ProcessCube®-Instanzen registriert sind) werden in ~/.processcube/processcube-config.json gespeichert. Diese Datei wird von der Cuby Context API verwaltet.

ProcessCube® Services

Nach der Installation stellen die Kern-Produkte folgende Services bereit:

Laufende Prozesse

Die PIDs laufender Produkt-Prozesse werden in ~/.processcube/running-pids.json gespeichert. Beim Start prüft Cuby, ob Orphan-Prozesse aus einem vorherigen Lauf existieren und beendet diese automatisch.

Weiterführend

• Umgebungsvariablen — Alle konfigurierbaren Variablen
• Kubernetes — Konfiguration im Operator-Modus
• Authentifizierung — Auth-Konfiguration