Salta ai contenuti
mofcloud

Variabili d'ambiente (ENV)

Ultimo aggiornamento:

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 ↗.

Terminal · Compose
docker compose up -d
Terminal · Kubernetes
kubectl -n mof rollout restart deployment/mof

Database

VariabilePredefinitoDescrizione
RK_POSTGRES_0_ADDRlocalhost:5432Indirizzo:porta di PostgreSQL.
RK_POSTGRES_0_USERpostgresRuolo di database con i permessi di login e CREATEDB.
RK_POSTGRES_0_PASSpasswordUsa la password del database esistente.
RK_POSTGRES_0_DATABASE_0_MAXOPENCONN30Numero 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

VariabilePredefinitoDescrizione
MOF_ADMIN_PASSWORD—Override opzionale della password di Admin; altrimenti viene generata alla prima configurazione.
RK_CONFIG_0_CONTENT_MODE_WEBfalseModalità solo web. Lascia entrambi i flag di modalità non impostati per all-in-one.
RK_CONFIG_0_CONTENT_MODE_WORKERfalseModalità solo worker; non abilitarla insieme alla modalità solo web.
RK_CONFIG_0_CONTENT_JOBS_SYNCWORKERS2Job di sincronizzazione (fatture, risorse, esportazioni) eseguiti contemporaneamente in un processo.
RK_CONFIG_0_CONTENT_JOBS_OPSWORKERS2Job 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

VariabilePredefinitoDescrizione
RK_GIN_0_MIDDLEWARE_CORS_ALLOWORIGINS_0*Origine browser consentita, inclusi schema e porta; senza percorso.
RK_GIN_0_MIDDLEWARE_CORS_ALLOWCREDENTIALSfalsePer le credenziali cross-origin, usa origini esplicite invece di *.

Tutte le opzioni nella documentazione di rk-boot ↗

Esempio: credenziali cross-origin
Compose · mof.environment
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

VariabilePredefinitoDescrizione
RK_LOGGER_0_ZAP_LEVELinfoLivello di log dell'applicazione: debug, info, warn, error.
RK_LOGGER_0_ZAP_ENCODINGconsoleFormato dei log dell'applicazione: console o json (per i collector di log).
RK_GIN_0_MIDDLEWARE_LOGGING_ENABLEDtrueLogging delle richieste HTTP; indipendente dai log dell'applicazione.
RK_POSTGRES_0_LOGGER_LEVELwarnLogging SQL: info, warn, error, silent.

Tutte le opzioni nella documentazione di rk-boot ↗

MCP e OAuth

VariabilePredefinitoDescrizione
MOF_MCP_INTERNAL_URLhttp://mof-mcp:8001Indirizzo 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
Compose · mof.environment
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

VariabilePredefinitoDescrizione
MOF_UPSTREAMhttp://mof:8080Indirizzo di MOF: il nome del servizio compose / Service Kubernetes. Impostalo solo quando MOF gira con un altro nome.

Proxy in uscita

VariabilePredefinitoDescrizione
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.