KI-Übersetzungshinweis

Diese Dokumentation wurde automatisch von KI übersetzt.

Variablen und Geheimnisse

Variablen und SecretsCommunity Edition+

Einführung

Hier konfigurieren und verwalten Sie zentral Ihre Umgebungsvariablen und Geheimnisse. Dies ist nützlich für die Speicherung sensibler Daten, die Wiederverwendung von Konfigurationsdaten und die Isolation von Umgebungskonfigurationen.

Unterschiede zu .env

Merkmal.env-DateiDynamisch konfigurierte Variablen und Geheimnisse
SpeicherortWird in der .env-Datei im Stammverzeichnis des Projekts gespeichert.Wird in der environmentVariables-Tabelle in der Datenbank gespeichert.
LademethodeWird beim Start der Anwendung mithilfe von Tools wie dotenv in process.env geladen.Wird dynamisch gelesen und beim Start der Anwendung in app.environment geladen.
ÄnderungsmethodeErfordert die direkte Bearbeitung der Datei; Änderungen werden erst nach einem Neustart der Anwendung wirksam.Unterstützt Änderungen zur Laufzeit; Änderungen werden sofort nach dem Neuladen der Anwendungskonfiguration wirksam.
UmgebungsisolationJede Umgebung (Entwicklung, Test, Produktion) erfordert eine separate Pflege der .env-Dateien.Jede Umgebung (Entwicklung, Test, Produktion) erfordert eine separate Pflege der Daten in der environmentVariables-Tabelle.
AnwendungsfälleGeeignet für feste, statische Konfigurationen, z. B. Hauptdatenbankinformationen der Anwendung.Geeignet für dynamische Konfigurationen, die häufige Anpassungen erfordern oder an die Geschäftslogik gebunden sind, z. B. Informationen zu externen Datenbanken, Dateispeichern usw.

Installation

Dies ist ein integriertes Plugin, das keine separate Installation erfordert.

Verwendung

Wiederverwendung von Konfigurationsdaten

Wenn Sie beispielsweise an mehreren Stellen in einem Workflow E-Mail-Knoten benötigen, die alle eine SMTP-Konfiguration erfordern, können Sie die allgemeine SMTP-Konfiguration in Umgebungsvariablen speichern.

20250102181045

Speicherung sensibler Daten

Hier können Sie Konfigurationsinformationen für verschiedene externe Datenbanken, Schlüssel für Cloud-Dateispeicher und ähnliche Daten speichern.

20250102103513

Isolation von Umgebungskonfigurationen

In verschiedenen Umgebungen wie Entwicklung, Test und Produktion werden unabhängige Konfigurationsmanagementstrategien eingesetzt. Dies stellt sicher, dass sich die Konfigurationen und Daten der einzelnen Umgebungen nicht gegenseitig beeinflussen. Jede Umgebung verfügt über eigene Einstellungen, Variablen und Ressourcen, wodurch Konflikte zwischen Entwicklungs-, Test- und Produktionsumgebungen vermieden und gleichzeitig sichergestellt wird, dass das System in jeder Umgebung wie erwartet funktioniert.

Beispielsweise kann die Konfiguration für Dateispeicherdienste in der Entwicklungs- und Produktionsumgebung unterschiedlich sein, wie unten gezeigt:

Entwicklungsumgebung

FILE_STORAGE_OSS_BASE_URL=dev-storage.nocobase.com
FILE_STORAGE_OSS_BUCKET=dev-storage

Produktionsumgebung

FILE_STORAGE_OSS_BASE_URL=prod-storage.nocobase.com
FILE_STORAGE_OSS_BUCKET=prod-storage

Verwaltung von Umgebungsvariablen

20250102155314

Umgebungsvariablen hinzufügen

  • Unterstützt das Hinzufügen einzelner Variablen und im Batch-Verfahren.
  • Unterstützt die Speicherung im Klartext und verschlüsselt.

20250102155509

Einzelnes Hinzufügen

20250102155731

Batch-Hinzufügen

20250102155258

Hinweise

Anwendung neu starten

Nach dem Ändern oder Löschen von Umgebungsvariablen erscheint oben ein Hinweis zum Neustart der Anwendung. Änderungen an Umgebungsvariablen werden erst nach dem Neustart der Anwendung wirksam.

20250102155007

Verschlüsselte Speicherung

Die verschlüsselten Daten für Umgebungsvariablen verwenden die symmetrische AES-Verschlüsselung. Der PRIVATE KEY für die Ver- und Entschlüsselung wird im Speicherverzeichnis abgelegt. Bitte bewahren Sie ihn sicher auf; bei Verlust oder Überschreibung können die verschlüsselten Daten nicht mehr entschlüsselt werden.

./storage/environment-variables/<app-name>/aes_key.dat

Derzeit unterstützte Plugins für Umgebungsvariablen

Action: Benutzerdefinierte Anfrage

20250102180751

Auth: CAS

20250102160129

Auth: DingTalk

20250102160205

Auth: LDAP

20250102160312

Auth: OIDC

20250102160426

Auth: SAML

20250102160652

Auth: WeCom

20250102160758

Datenquelle: Externe MariaDB

20250102160935

Datenquelle: Externe MySQL

20250102173602

Datenquelle: Externe Oracle

20250102174153

Datenquelle: Externe PostgreSQL

20250102175630

Datenquelle: Externe SQL Server

20250102175814

Datenquelle: KingbaseES

20250102175951

Datenquelle: REST API

20250102180109

Dateispeicher: Lokal

20250102161114

Dateispeicher: Aliyun OSS

20250102161404

Dateispeicher: Amazon S3

20250102163730

Dateispeicher: Tencent COS

20250102173109

Dateispeicher: S3 Pro

Nicht angepasst

Karte: AMap

20250102163803

Karte: Google

20250102171524

E-Mail-Einstellungen

Nicht angepasst

Benachrichtigung: E-Mail

20250102164059

Öffentliche Formulare

20250102163849

Systemeinstellungen

20250102164139

Verifizierung: Aliyun SMS

20250102164247

Verifizierung: Tencent SMS

20250102165814

Workflow

20250102180537