Dit document is vertaald door AI. Voor onnauwkeurigheden, raadpleeg de Engelse versie
pkg: "@nocobase/plugin-environment-variables"
Variabelen en Geheimen
This feature is provided by the plugin «Variabelen en geheimen»Introductie
Centrale configuratie en beheer van omgevingsvariabelen en geheimen, te gebruiken voor het opslaan van gevoelige gegevens, hergebruik van configuratiegegevens en isolatie van omgevingsconfiguraties.
Verschillen met .env
| Functie | .env bestand | Dynamisch geconfigureerde variabelen en geheimen |
|---|---|---|
| Opslaglocatie | Opgeslagen in het .env bestand in de hoofdmap van het project | Opgeslagen in de environmentVariables tabel in de database |
| Laadmethode | Geladen in process.env met tools zoals dotenv tijdens het opstarten van de applicatie | Dynamisch gelezen en geladen in app.environment tijdens het opstarten van de applicatie |
| Wijzigingsmethode | Vereist directe bestandsbewerking; de applicatie moet opnieuw worden opgestart om wijzigingen toe te passen | Ondersteunt runtime-aanpassing; wijzigingen worden direct van kracht na het herladen van de applicatieconfiguratie |
| Omgevingsisolatie | Elke omgeving (ontwikkeling, testen, productie) vereist afzonderlijk onderhoud van .env bestanden | Elke omgeving (ontwikkeling, testen, productie) vereist afzonderlijk onderhoud van gegevens in de environmentVariables tabel |
| Toepassingsscenario's | Geschikt voor vaste statische configuraties, zoals hoofddatabase-informatie voor de applicatie | Geschikt voor dynamische configuraties die frequente aanpassingen vereisen of gekoppeld zijn aan bedrijfslogica, zoals externe databases, informatie over bestandsopslag, enz. |
Installatie
Ingebouwde plugin, geen aparte installatie vereist.
Gebruik
Hergebruik van configuratiegegevens
Als bijvoorbeeld meerdere plaatsen in de workflow e-mailnodes en SMTP-configuratie vereisen, kunt u de algemene SMTP-configuratie opslaan in omgevingsvariabelen.
Opslag van gevoelige gegevens
Opslag van diverse externe databaseconfiguratie-informatie, sleutels voor cloudbestandsopslag, enz.
Isolatie van omgevingsconfiguratie
In verschillende omgevingen, zoals ontwikkeling, testen en productie, worden onafhankelijke configuratiebeheerstrategieën gebruikt om ervoor te zorgen dat de configuraties en gegevens van elke omgeving elkaar niet beïnvloeden. Elke omgeving heeft zijn eigen onafhankelijke instellingen, variabelen en bronnen, wat conflicten tussen ontwikkel-, test- en productieomgevingen voorkomt en ervoor zorgt dat het systeem in elke omgeving naar verwachting functioneert.
De configuratie voor bestandopslagdiensten kan bijvoorbeeld verschillen tussen ontwikkel- en productieomgevingen, zoals hieronder weergegeven:
Ontwikkelomgeving
Productieomgeving
Beheer van omgevingsvariabelen
Omgevingsvariabelen toevoegen
- Ondersteunt enkelvoudige en batchmatige toevoeging
- Ondersteunt platte tekst en versleutelde opslag
Enkelvoudige toevoeging
Batchmatige toevoeging
Aandachtspunten
De applicatie opnieuw opstarten
Nadat u omgevingsvariabelen hebt gewijzigd of verwijderd, verschijnt bovenaan een melding om de applicatie opnieuw op te starten. Wijzigingen in omgevingsvariabelen worden pas van kracht nadat de applicatie opnieuw is opgestart.
Versleutelde opslag
Versleutelde gegevens voor omgevingsvariabelen maken gebruik van AES symmetrische versleuteling. De PRIVATE KEY voor versleuteling en ontsleuteling wordt opgeslagen in de opslagmap. Bewaar deze zorgvuldig; bij verlies of overschrijving kunnen de versleutelde gegevens niet worden ontsleuteld.
Momenteel ondersteunde plugins voor omgevingsvariabelen
Action: Custom request
Auth: CAS
Auth: DingTalk
Auth: LDAP
Auth: OIDC
Auth: SAML
Auth: WeCom
Gegevensbron: Externe MariaDB
Gegevensbron: Externe MySQL
Gegevensbron: Externe Oracle
Gegevensbron: Externe PostgreSQL
Gegevensbron: Externe SQL Server
Gegevensbron: KingbaseES
Gegevensbron: REST API
Bestandsopslag: Lokaal
Bestandsopslag: Aliyun OSS
Bestandsopslag: Amazon S3
Bestandsopslag: Tencent COS
Bestandsopslag: S3 Pro
Niet aangepast
Map: AMap
Map: Google
E-mailinstellingen
Niet aangepast
Notification: Email
Public forms
Systeeminstellingen
Verification: Aliyun SMS
Verification: Tencent SMS
Workflow
