On-Premises – Docker

Lokale Feature-Flags konfigurieren (Docker On-Premise)

Bei On-Premise-Docker-Bereitstellungen können Feature-Flags aus einer lokalen JSON-Datei geladen werden.

1. Erstellen Sie die Feature-Flag-Datei auf dem Host

1. Erstellen Sie auf dem Docker-Host ein Arbeitsverzeichnis für die Ninox-Konfiguration, zum Beispiel:

   /opt/ninox/

2. Kopieren Sie die Feature-Flag-Vorlage aus der Serverversion in dieses Verzeichnis und benennen Sie sie in feature-flags.json um

   (For example, from template.feature-flags.json → feature-flags.json.)

3. Bearbeiten feature-flags.json und konfigurieren Sie Ihre Flags, zum Beispiel:

   { "SomeFeature": { "enabled": true } }

   Verwenden Sie immer die Vorlage derselben Ninox-Serverversion, da sich die verfügbaren Flags zwischen den Versionen ändern können.

2. Binden Sie die Datei in den Container ein, aktualisieren Sie server-config.json

1. Stellen Sie sicher, dass Ihre Datei server-config.json (auf dem Host) folgendes enthält:

   "featureFlags": { "source": "local", "file": "/usr/local/nxdb/feature-flags.json" }

2. Beim Starten des Containers müssen sowohl server-config.json, als auch feature-flags.json eingebunden werden. Zum Beispiel:

   docker container run -d \
   --name nxdb \
   -v NX-DATA:/var/nxdb \
   -v /opt/ninox/server-config.json:/usr/local/nxdb/server-config.json:rw \
   -v /opt/ninox/feature-flags.json:/usr/local/nxdb/feature-flags.json:rw \
   -p 80:8080 ninoxdatabase/ninox-on-premise

Wichtige Punkte:
- Host-Datei: /opt/ninox/feature-flags.json
- Pfad innerhalb des Containers: /usr/local/nxdb/feature-flags.json
- Dieser Pfad muss mit dem Wert für file in server-config.json übereinstimmen

3. Neustart und Überprüfung, ob die Flags geladen wurden

Nach Änderungen in feature-flags.json oder server-config.json:

Starten Sie den Container neu:

docker compose restart nxdb

oder, falls Sie Docker ohne Compose verwenden:

docker container restart nxdb

On-Premises – Windows

Lokale Feature-Flags konfigurieren (Windows On-Premise)

Bei lokalen Installationen können Feature-Flags aus einer lokalen JSON-Datei gelesen werden.

1. Erstellen Sie die Feature-Flag-Datei.

1. Öffnen Sie den Ninox-Installationsordner - zum Beispiel:

   C:\Program Files\Ninox

2. Kopieren Sie die Datei template.feature-flags.json und benennen Sie die Kopie um in feature-flags.json

3. Bearbeiten feature-flags.json und setzen Sie Ihre Flags, zum Beispiel:

   { "SomeFeature": { "enabled": true } }

   Verwenden Sie immer die Vorlage aus derselben Ninox-Serverversion, da zwischen den Releases Flags hinzugefügt oder entfernt werden können.

2. Weisen Sie den Server auf die lokale Datei hin.

1. Öffnen Sie im selben Ordner die Datei server-config.json.

2. Fügen Sie folgenden Block featureFlags hinzu oder aktualisieren Sie ihn, zum Beispiel:

   "featureFlags": { "source": "local", "file": "feature-flags.json" }

   Der Wert für file kann ein absoluter Pfad (zum Beispiel C:\\Program Files\\Ninox\\feature-flags.json) oder ein Pfad relativ zum Arbeitsverzeichnis des Ninox-Servers sein.

3. Neustart und Überprüfung

1. Nach dem Speichern von feature-flags.json und server-config.json öffnen Sie den Task-Manager.

2. Gehen Sie zum Reiter „Dienste“, klicken Sie mit der rechten Maustaste auf den Ninox-Dienst und wählen Sie „Neu starten“.

ℹ️  Hinweis : Die Unterstützung für JSON-Feature-Flags ist ab Ninox On‑Premises Version 3.18.17 verfügbar.