Umgebungsvariablen

Cuby kann über Umgebungsvariablen konfiguriert werden. Diese überschreiben die Standardwerte und sind besonders für den Kubernetes Operator-Modus und die Entwicklung relevant.

Übersicht

Variable	Beschreibung	Standard
`PORT`	HTTP-Server-Port	`3847`
`CUBY_CONFIG_DIR`	Alternatives Konfigurationsverzeichnis	`~/.processcube`
`CUBY_MODE`	`operator` für Kubernetes-Modus	—
`USE_AUTH`	Authentifizierung aktivieren	—
`MARKETPLACE_URL`	Base-URL des Marketplace	`https://marketplace.processcube.io`
`MARKETPLACE_TAGS`	Komma-separierte Tags zur Produktfilterung	`local`
`LOCAL_PRODUCTS_DIR`	Pfad zu lokalen Produkten (umgeht Marketplace)	—
`PROCESSCUBE_API_KEY`	Wird automatisch an Plugins weitergegeben	Aus Secret Store

Server

`PORT`

Port für den HTTP-Server und die Web-Oberfläche.


PORT=8080 cuby

`CUBY_CONFIG_DIR`

Alternatives Verzeichnis für Konfiguration und Produktdaten. Standardmäßig ~/.processcube.


CUBY_CONFIG_DIR=/opt/cuby cuby

`USE_AUTH`

Aktiviert die Authentifizierung. Wenn gesetzt, sind alle API-Endpunkte (außer /api/health und /api/auth/*) geschützt.


USE_AUTH=true cuby

Marketplace

`MARKETPLACE_URL`

Base-URL des ProcessCube® Marketplace. Wird für Produkt-Abfragen und die npm-Registry verwendet.


MARKETPLACE_URL=https://marketplace.processcube.io cuby

Die npm-Registry wird unter {MARKETPLACE_URL}/npm/ erwartet.

`MARKETPLACE_TAGS`

Komma-separierte Tags zur Filterung der angezeigten Produkte.


# Nur Produkte mit Tag "local" anzeigen (Standard)
MARKETPLACE_TAGS=local cuby
 
# Mehrere Tags
MARKETPLACE_TAGS=local,kubernetes cuby

`PROCESSCUBE_API_KEY`

Wird automatisch an Plugin-Worker weitergegeben. Normalerweise wird der API Key aus dem Secret Store gelesen, diese Variable überschreibt den gespeicherten Wert.

Kubernetes Operator

`CUBY_MODE`

Aktiviert den Kubernetes Operator-Modus.


CUBY_MODE=operator cuby

Im Operator-Modus werden Produkte als Kubernetes-Deployments statt als lokale Prozesse verwaltet.

Kubernetes-Verbindung

Für den lokalen Zugriff auf einen Kubernetes-Cluster (außerhalb des Clusters):

Variable	Beschreibung
`KUBERNETES_SERVICE_HOST`	Kubernetes API Host
`KUBERNETES_SERVICE_PORT`	Kubernetes API Port

Im Cluster wird automatisch der Service Account Token verwendet.

Entwicklung

`LOCAL_PRODUCTS_DIR`

Pfad zu einem Verzeichnis mit lokalen Produkten. Umgeht den Marketplace und liest stattdessen package.json-Dateien aus dem angegebenen Verzeichnis.


LOCAL_PRODUCTS_DIR=/pfad/zu/meinen/plugins bun run dev

Nützlich für die Plugin-Entwicklung, um Produkte ohne Veröffentlichung im Marketplace zu testen.

Weiterführend

Konfiguration — Konfigurationsdateien und Verzeichnisse
Kubernetes — Operator-Modus im Detail
Marketplace — Produkte installieren