- Una sandbox sicura e scalabile per agenti — ogni sessione IA viene eseguita in un container isolato dedicato, avviato su richiesta e rimosso al termine della sessione.
- Una piattaforma efficiente per il deployment delle app — ogni app creata e pubblicata dal team viene eseguita nel proprio container leggero e persistente.
- Un motore di workflow IA — Automazioni attivate da modifiche ai Record, pianificazioni e webhook, con passaggi IA eseguiti dove risiedono i dati.
- Una piattaforma completa di collaborazione su database PostgreSQL — Tabelle, Viste e API.
Servizi eseguiti da un deployment
Gli ultimi quattro servizi costituiscono il piano di runtime. Le risorse di deployment
installano tutto questo come un’unica piattaforma.
Come interagiscono i componenti
L’app Teable comunica con il piano di runtime tramite un’unica connessione: il Servizio di infrastruttura (TEABLE_INFRA_API_URL / TEABLE_INFRA_API_KEY). Tutto ciò
che si trova dietro di esso è interno. Due tipi di carico di lavoro svolgono le attività
effettive e consumano le risorse della macchina:
- Sandbox. Ogni sessione di AI Chat o App Builder riceve un proprio container isolato, avviato all’inizio della sessione e rimosso al termine. È il carico principale della piattaforma e si presenta a picchi: dimensiona la macchina in base alle sessioni IA simultanee di picco, non al numero di utenti (i limiti di risorse per sandbox possono essere impostati nell’Amministrazione di sistema).
- App distribuite. Ogni app pubblicata viene eseguita nel proprio container
persistente, disponibile all’indirizzo
*.app.<domain>. Le sandbox vengono create e rimosse; le app distribuite si accumulano e rimangono in esecuzione.
Un dominio, quattro record DNS
Tutto viene pubblicato sotto un unico dominio di base, in genere un tuo sottodominio, cometeable.example.com:
Ogni nome è solo un valore predefinito e ciascun hostname può essere sovrascritto
singolarmente (consulta l’esempio dei valori nel repository di deployment).
Gestione delle versioni
La piattaforma viene distribuita tramite release della piattaforma (v<year>.<month>.<seq>) nel
repository di deployment:
- Un tag di release è uno snapshot verificato:
versions.yamlblocca la versione esatta di ogni componente e il fileCHANGELOG.mddel repository indica cosa è cambiato e quali eventuali operazioni sono necessarie. - Il branch
maindel repository contiene sempre la versione più recente. - Lo script doctor incluso confronta ciò che il deployment esegue effettivamente con la release e segnala uno di tre risultati: compatibile, app Teable da aggiornare oppure combinazione sconosciuta (non verificata).
latest è il
canale stabile): consulta Aggiornamento della versione. Ogni release
della piattaforma indica le versioni dell’app con cui è stata verificata e doctor esegue
questo controllo per te. L’agente sandbox alla base delle sessioni IA segue sempre e
automaticamente la versione dell’app: non occorre aggiornare o gestire altro.
Eseguire il deployment
Entrambi i percorsi installano l’intera piattaforma e sono documentati dall’inizio alla fine nel repository di deployment:Docker tutto in uno
Tutto su un’unica macchina: primo deployment completo, in modalità
local o server.Kubernetes (Helm)
Un unico chart Helm su un cluster esistente; è obbligatorio solo
global.baseDomain.- Teable è già in esecuzione in modalità autonoma? I dati rimangono al loro posto: il piano di runtime viene installato accanto all’istanza esistente. Consulta la guida alla migrazione
- Certificati aziendali interni? Se il dominio usa una CA privata o aziendale, devi configurare le sandbox in modo che la considerino attendibile. Consulta private-ca.md
- Dimensionamento, versioni e mirror: VERSIONS.md · images/README.md
- Quando qualcosa non funziona: esegui prima doctor, quindi consulta TROUBLESHOOTING.md
TEABLE_INFRA_API_URL / TEABLE_INFRA_API_KEY (le guide al deployment descrivono
la procedura), quindi imposta i limiti delle risorse in
Amministrazione di sistema → Agente sandbox.
