Entrambe le immagini si configurano tramite variabili d'ambiente. I nomi dell'API usano un doppio
underscore tra i livelli, per esempio Smtp__Host. Un'impostazione omessa mantiene il
suo valore predefinito. Gli starter kit di Hosting con Docker,
Hosting su Kubernetes e Hosting su AKS impostano
già tutto ciò che serve a una normale installazione; questa pagina serve per cambiarne una, o per
una configurazione tutta tua (Eseguire le immagini).
API: database
Impostazione
Cosa fa
ConnectionStrings__DefaultConnection
Il database in cui vivono i dati del workspace predefinito, per esempio Host=postgres;Database=omnicore-db;Username=archestack;Password=.... Obbligatoria.
ConnectionStrings__Core
I metadati del workspace predefinito: entità, pagine, script. Database omnicore-core. Obbligatoria.
ConnectionStrings__Identity
Utenti, workspace e chiavi, condivisi da tutti i workspace. Database omnicore-identity. Obbligatoria.
ConnectionStrings__Keycloak
Solo quando si trasferiscono utenti da Keycloak. Altrimenti lasciala vuota.
ConnectionStrings__Cluster
Come più istanze dell'API si comunicano le modifiche. Per impostazione predefinita è il database identity; impostala su PostgreSQL stesso quando in mezzo c'è un connection pooler come PgBouncer.
Database__CreateMissing
true crea il database dei dati quando manca; gli altri due vengono creati in ogni caso. Predefinito false; i kit impostano true.
L'utente in queste stringhe deve avere il diritto di creare database: ogni nuovo workspace ne riceve
due tutti suoi, con nomi derivati dai nomi base qui sopra.
API: indirizzi
Impostazione
Cosa fa
ASPNETCORE_URLS
Dove l'API è in ascolto dentro il container: http://+:8080.
ASPNETCORE_ENVIRONMENT
Sempre Production. Qualsiasi altro valore mostra i dettagli degli errori a chiunque.
Http__PathBase
Il percorso sotto cui è servita l'API, per esempio /archestack. Vuoto alla radice.
Identity__AppBaseUrl
L'indirizzo del builder, per esempio https://apps.example.com/archestack. I link di invito e di reimpostazione della password puntano qui.
ForwardedHeaders__TrustedProxies
Gli indirizzi dei proxy davanti, di cui si accetta l'X-Forwarded-For. Il valore predefinito copre le reti private; senza quello giusto, ogni visitatore sembra il proxy e condivide un unico rate limit.
Tenancy__HostSuffix
Serve ogni workspace su un hostname tutto suo, <label>.<suffix>, e permette ai workspace di aggiungere domini propri. Vuoto per impostazione predefinita.
API: accesso
Impostazione
Cosa fa
Identity__Provider
Builtin: Archestack fa accedere le persone da solo. Predefinito.
Il primo admin, creato al primo avvio quando non c'è ancora nessun utente. Usate una volta sola: dopo cambia la password in Archestack. Omettile entrambe per creare invece l'admin nel builder.
Identity__AllowCompanySignup
true permette a chiunque di creare un'azienda propria su /register. Predefinito false. Gli admin di un'azienda possono eseguire script sul server, quindi lasciala disattivata a meno che tu non gestisca un servizio pubblico.
Identity__AccessTokenMinutes
Quanto dura un token di accesso prima di essere rinnovato. Predefinito 15.
Identity__RefreshTokenDays
Quanto a lungo una persona resta connessa senza usare Archestack. Predefinito 30.
Dopo questo numero di password errate un account viene bloccato per questo tempo. Predefiniti 10 e 15.
API: posta
Impostazione
Cosa fa
Smtp__Host, Smtp__Port, Smtp__UseSsl
Il server di posta per gli inviti e la reimpostazione delle password. Porta 587 e SSL per impostazione predefinita. Senza host, l'admin che invia un invito riceve il link da inoltrare.
Smtp__Username, Smtp__Password
Le credenziali di accesso al server di posta.
Smtp__From, Smtp__FromName
Il mittente che quelle email mostrano.
La posta che le applicazioni inviano passa per gli account di posta che ogni workspace configura nel suo builder.
API: file e backup
Impostazione
Cosa fa
Files__Directory
Dove vanno gli upload e i file dei workspace, per esempio /files. Mettici un volume: in un container senza volume, i file vanno persi al prossimo aggiornamento.
Files__MaxFileBytes
Il file singolo più grande. Predefinito 100 MB.
Files__MaxWorkspaceBytes
Quanto può conservare un workspace. Predefinito 0, nessun limite.
Backup__Directory
Dove vanno i backup, per esempio /backups. Anche questo è un volume, e copia ciò che ci finisce da un'altra parte.
Backup__RetentionDays
Per quanto tempo si conservano i backup. Predefinito 30.
Backup__CronSchedule
Quando gira il backup notturno, come cron Quartz. Predefinito 0 0 3 * * ?, le 03:00.
API: scala e limiti
Impostazione
Cosa fa
Realtime__EntityChanges
false impedisce alle schermate di aggiornarsi quando un record cambia altrove. Predefinito true. Disattivato, un'installazione serve molte più persone contemporaneamente; vedi Capacità e dimensionamento.
Cluster__Enabled
Permette a più istanze dell'API di lavorare come una sola. Predefinito true; lascialo attivo.
RateLimiting__Enabled
Limiti di richieste per chiamante. Predefinito true. I limiti valgono per singola istanza dell'API.
RateLimiting__PermitsPerMinute
Richieste che una persona può fare al minuto. Predefinito 2000.
RateLimiting__AuthPermitsPerMinute
Tentativi di accesso al minuto da un indirizzo. Predefinito 20.
RateLimiting__PublicPagePermitsPerMinute
Quanto un visitatore senza account può chiedere alle pagine pubbliche al minuto. Predefinito 240.
Scripting__TypedData__Enabled
Le business entity come set tipizzati negli script (Db.Order). Predefinito true.
Un certificato che protegge le chiavi con cui sono cifrate le password memorizzate. Senza, quelle chiavi stanno nel database identity non protette, quindi una copia di quel database contiene entrambe le metà.
Una sola coppia di chiavi per le notifiche del browser in tutti i workspace. Se omessa, ogni workspace ne crea una propria. Non cambiarla mai dopo che le persone hanno consentito le notifiche: le loro sottoscrizioni smettono di funzionare.
API: monitoraggio
Impostazione
Cosa fa
Observability__Enabled
Invia trace, metriche e log tramite OpenTelemetry. Predefinito false.
Observability__OtlpEndpoint
Dove inviarli, per esempio http://otel-collector:4317.
L'indirizzo dell'API come lo raggiunge il browser, per esempio https://api.example.com. Vuoto quando l'API è allo stesso indirizzo sotto /api.
BASE_PATH
Il percorso sotto cui è servita, per esempio /archestack. Vuoto alla radice.
VITE_UI_MODE
dashboard mostra il builder su / e l'app pubblicata sotto /app. kiosk mostra l'app pubblicata su /, per un indirizzo che è solo l'app.
VITE_DASHBOARD_URL
Con kiosk, l'indirizzo del builder quando è su un altro hostname.
VITE_APP_URL
Con dashboard, l'indirizzo dell'app pubblicata quando è su un altro hostname.
API_INTERNAL_URL
L'indirizzo dell'API dentro la rete, per esempio http://api:8080. Le anteprime dei link nelle app di chat e le pagine che leggono i motori di ricerca vengono da lì. In Kubernetes, scrivi il nome completo del service, http://<service>.<namespace>.svc.cluster.local:8080.
L'immagine PostgreSQL
Impostazione
Cosa fa
POSTGRES_USER, POSTGRES_PASSWORD
L'utente con cui si connette l'API. La password viene impostata quando PostgreSQL si avvia per la prima volta su un disco vuoto; cambiare la variabile dopo non la cambia nel database.
POSTGRES_DB
postgres. L'API crea i propri database.
PGDATA
Solo su un disco nuovo la cui radice contiene lost+found, come in Kubernetes: una cartella sotto il punto di montaggio, per esempio /var/lib/postgresql/data/pgdata.