ObjectOSConfiguration de l'environnement d'exécution
Configurez le chargement des artefacts, la résolution des projets, la base de données, le cache et les secrets d'exécution.
Configuration de l'environnement d'exécution
La configuration de l'environnement d'exécution d'ObjectOS répond à trois questions :
- Quel projet cette requête doit-elle servir ?
- Où se trouve l'artefact compilé ?
- Quelle base de données et quels services d'exécution le projet doit-il utiliser ?
Modes de démarrage
| Mode | À utiliser quand | Configuration clé |
|---|---|---|
| Standalone | os start sans configuration — démo rapide, kernel vide, environ 23 plugins, SQLite local à ~/.objectstack/data/standalone.db | aucune (valeurs par défaut) |
| Adossé à un fichier | Projet unique, démo, offre hors ligne client, déploiement isolé du réseau | OS_ARTIFACT_FILE |
| Connecté au cloud | Un plan de contrôle hébergé ou privé publie les artefacts du projet | OS_CLOUD_URL, OS_PROJECT_ID ou résolution par nom d'hôte |
Mode Standalone
Mode par défaut lorsque vous exécutez os start sans configuration ni artefact.
ObjectOS démarre un kernel vide avec les plugins de la plateforme chargés
(auth, security, audit, storage, webhooks, mcp-server,
marketplace-proxy, marketplace-install-local, …), ouvre une base
SQLite locale à ~/.objectstack/data/standalone.db, et sert les interfaces
Console et Account.
Installez des applications depuis l'onglet marketplace dans Console pour peupler le kernel avec des objets, des vues et des flux — sans recompilation, sans redémarrage. Idéal pour les démos, l'évaluation et l'exploration de type « montre-moi ce que fait cette chose ».
os start monte automatiquement en puissance :
| Détecté | Comportement |
|---|---|
| Rien | Mode Standalone (ci-dessus) |
objectstack.config.ts dans le répertoire courant | Mode projet — compilation automatique, HOME=<cwd>/.objectstack |
| Artefact compilé dans le répertoire courant | Mode artefact — charge cet artefact |
--artifact <path> explicite ou OS_CLOUD_URL | Modes adossé à un fichier / connecté au cloud |
Mode adossé à un fichier
Définissez :
OS_ARTIFACT_FILE=/artifacts/objectstack.jsonObjectOS utilise un client local de l'API Artifact. Chaque nom d'hôte se résout vers le même projet. La configuration d'exécution est lue depuis l'artefact lorsqu'elle est présente, ou repli sur une valeur d'exécution locale par défaut pour l'évaluation.
OS_ARTIFACT_FILE est la convention de l'enveloppe applicative d'ObjectOS. L'environnement
d'exécution sous-jacent accepte aussi directement OS_ARTIFACT_PATH (utilisé par les
commandes dev et start de @objectstack/cli ainsi que par la stack
standalone du framework). Définissez l'une ou l'autre — pas les deux.
Optionnel :
OS_ENVIRONMENT_ID=env_prod # or the legacy alias OS_PROJECT_ID
OS_WATCH_ARTIFACT=1N'utilisez le mode surveillance que pour le développement ou les tests de fumée.
Mode connecté au cloud
Définissez :
OS_CLOUD_URL=https://cloud.example.com
OS_CLOUD_API_KEY=replace-with-deployment-tokenObjectOS demande au plan de contrôle de :
- résoudre le nom d'hôte vers un projet/environnement ;
- récupérer l'artefact courant ;
- recevoir la configuration de la base de données d'exécution pour ce projet.
ObjectOS ne doit pas se connecter directement à la base de données du plan de contrôle.
Secret d'authentification
Définissez un secret de base robuste :
OS_AUTH_SECRET=replace-with-a-strong-random-secretObjectOS dérive de cette valeur les secrets d'authentification propres à chaque projet. Cela maintient la signature des sessions isolée par projet tout en permettant des redémarrages déterministes. Faire pivoter cette valeur invalide les sessions existantes.
Caches du kernel et des artefacts
ObjectOS met en cache les environnements résolus et les kernels de projet afin d'éviter de reconstruire un kernel à chaque requête.
| Variable | Valeur par défaut | Objet |
|---|---|---|
OS_KERNEL_CACHE_SIZE | 32 | Nombre maximum de kernels de projet mis en cache |
OS_KERNEL_TTL_MS | 900000 | TTL d'inactivité pour les kernels mis en cache |
OS_ENV_CACHE_TTL_MS | 300000 | Cache de résolution nom d'hôte/environnement |
OS_ARTIFACT_CACHE_TTL_MS | 300000 | Cache des réponses d'artefacts |
Des TTL plus faibles rendent les changements visibles plus rapidement. Des TTL plus élevés réduisent le trafic vers le plan de contrôle et les démarrages à froid.
Configuration de la base de données
En mode connecté au cloud, le plan de contrôle renvoie la configuration de la base de données d'exécution propre au projet avec la réponse d'artefact.
En mode adossé à un fichier, ObjectOS peut dériver les paramètres de la base de données à partir des déclarations de sources de données de l'artefact. Les pilotes du framework pris en charge incluent SQLite, PostgreSQL, MySQL, MongoDB et des pilotes d'évaluation en mémoire.
Pour la production, utilisez une base de données gérée par le client. Ne vous appuyez pas sur le stockage local du conteneur pour les données métier, sauf si le déploiement est explicitement une évaluation mononœud.