Imposta solo ciò che devi cambiare. Lascia i valori predefiniti fuori dal file di deployment.
Dove impostare le ENV
Compose: environment nel servizio indicato. Kubernetes: env / envFrom nel container indicato. Ricrea o riavvia il workload dopo le modifiche.
I nomi RK_* corrispondono a boot.yaml; i numeri sono indici di array. In Compose, metti i booleani tra virgolette ed esegui l'escape di un $ letterale come $$. RK interpreta anche virgole e backslash; usa una password esadecimale lunga e casuale per i nuovi database. Mantieni le password esistenti durante l'aggiornamento.
Questa pagina elenca quelle più comuni. Qualsiasi valore di boot.yaml può essere sovrascritto allo stesso modo; vedi rk-boot: Override boot ↗.
docker compose up -dkubectl -n mof rollout restart deployment/mofDatabase
| Variabile | Predefinito | Descrizione |
|---|---|---|
RK_POSTGRES_0_ADDR | localhost:5432 | Indirizzo:porta di PostgreSQL. |
RK_POSTGRES_0_USER | postgres | Ruolo di database con i permessi di login e CREATEDB. |
RK_POSTGRES_0_PASS | password | Usa la password del database esistente. |
RK_POSTGRES_0_DATABASE_0_MAXOPENCONN | 30 | Numero massimo di connessioni al database per processo MOF. Con più processi, mantieni il totale sotto il limite del database. |
Tutte le opzioni nella documentazione di rk-boot ↗
Con Params del database vuoto si usano sslmode=disable e TimeZone=Asia/Shanghai. MOF non applica TLS ai database dei provider; PostgreSQL solo TLS non è supportato.
Server e Admin
| Variabile | Predefinito | Descrizione |
|---|---|---|
MOF_ADMIN_PASSWORD | — | Override opzionale della password di Admin; altrimenti viene generata alla prima configurazione. |
RK_CONFIG_0_CONTENT_MODE_WEB | false | Modalità solo web. Lascia entrambi i flag di modalità non impostati per all-in-one. |
RK_CONFIG_0_CONTENT_MODE_WORKER | false | Modalità solo worker; non abilitarla insieme alla modalità solo web. |
RK_CONFIG_0_CONTENT_JOBS_SYNCWORKERS | 2 | Job di sincronizzazione (fatture, risorse, esportazioni) eseguiti contemporaneamente in un processo. |
RK_CONFIG_0_CONTENT_JOBS_OPSWORKERS | 2 | Job operativi (eliminare un account, eliminare fatture, applicare un tag virtuale) eseguiti contemporaneamente in un processo. |
MOF_JWT_SECRET | — | Chiave di firma dell'accesso opzionale, di almeno 32 caratteri. Se non impostata: generata al primo avvio e memorizzata nel database. Se impostata, usa lo stesso valore su ogni processo MOF. |
CORS
| Variabile | Predefinito | Descrizione |
|---|---|---|
RK_GIN_0_MIDDLEWARE_CORS_ALLOWORIGINS_0 | * | Origine browser consentita, inclusi schema e porta; senza percorso. |
RK_GIN_0_MIDDLEWARE_CORS_ALLOWCREDENTIALS | false | Per le credenziali cross-origin, usa origini esplicite invece di *. |
Tutte le opzioni nella documentazione di rk-boot ↗
Esempio: credenziali cross-origin
RK_GIN_0_MIDDLEWARE_CORS_ALLOWORIGINS_0: "https://mof.example.com"
RK_GIN_0_MIDDLEWARE_CORS_ALLOWCREDENTIALS: "true"Aggiungi origini con _1, _2 e così via. Sostituisci il * predefinito quando le credenziali sono abilitate.
Log
| Variabile | Predefinito | Descrizione |
|---|---|---|
RK_LOGGER_0_ZAP_LEVEL | info | Livello di log dell'applicazione: debug, info, warn, error. |
RK_LOGGER_0_ZAP_ENCODING | console | Formato dei log dell'applicazione: console o json (per i collector di log). |
RK_GIN_0_MIDDLEWARE_LOGGING_ENABLED | true | Logging delle richieste HTTP; indipendente dai log dell'applicazione. |
RK_POSTGRES_0_LOGGER_LEVEL | warn | Logging SQL: info, warn, error, silent. |
MCP e OAuth
| Variabile | Predefinito | Descrizione |
|---|---|---|
MOF_MCP_INTERNAL_URL | http://mof-mcp:8001 | Indirizzo interno di MCP: il nome del servizio compose / Service Kubernetes. Lascialo non impostato. |
MOF_PUBLIC_URL | — | Origine HTTPS pubblica di OAuth condivisa da Dash e MOF, senza percorso. |
MOF_MCP_OAUTH_SECRET | — | Secret OAuth, di almeno 32 caratteri; condiviso tra i nodi MOF. |
Esempio: OAuth
MOF_PUBLIC_URL: "https://mof.example.com"
MOF_MCP_OAUTH_SECRET: "REPLACE_WITH_A_RANDOM_SECRET_AT_LEAST_32_CHARACTERS"I token personali non richiedono OAuth. Abilita l'accesso MCP in Admin → Impostazioni → MCP. Lo stato di configurazione di OAuth non dimostra che la callback pubblica sia raggiungibile.
Upstream di Dash
| Variabile | Predefinito | Descrizione |
|---|---|---|
MOF_UPSTREAM | http://mof:8080 | Indirizzo di MOF: il nome del servizio compose / Service Kubernetes. Impostalo solo quando MOF gira con un altro nome. |
Proxy in uscita
| Variabile | Predefinito | Descrizione |
|---|---|---|
HTTP_PROXY | — | Proxy HTTP in uscita opzionale. |
HTTPS_PROXY | — | Proxy HTTPS in uscita opzionale. |
NO_PROXY | — | Escludi gli host interni e gli indirizzi del database. Il supporto varia a seconda dell'SDK. |
— significa non impostato. Licenza e gestione utenti si trovano in Admin.