Aperçu du CLI

Le CLI Sovrium constitue toute la surface produit du binaire auto-hébergé : il exécute votre application, gère son cycle de vie, échafaude et valide des projets, et provisionne les secrets et le compte administrateur dont un déploiement a besoin.

Chaque invocation se compose d'une commande, d'un chemin de configuration optionnel et d'options. Tout le reste — ports, base de données, stockage, IA — provient de l'environnement, jamais d'une option.

sovrium [command] [config] [flags]

Si le premier argument positionnel ressemble à un fichier de configuration (il se termine par .json, .yaml, .yml, .ts, .mts, ou contient un /), start est sous-entendu. sovrium app.yaml et sovrium start app.yaml sont la même commande.

Commandes

Quatre groupes, documentés sur leurs propres pages. sovrium --help affiche la même liste.

Options

Déplacé vers Options globales et codes de sortie.

Sources de configuration

La configuration est résolue dans un ordre fixe, et la première source qui répond l'emporte :

1. L'argument de chemin — sovrium start app.yaml.
2. APP_SCHEMA_FILE — un chemin, lorsque la configuration est trop volumineuse pour être passée en ligne.
3. APP_SCHEMA — la configuration elle-même, en JSON en ligne, YAML en ligne, ou une URL http(s) à récupérer.
4. Rien — la commande échoue avec Error: No configuration provided.

# Depuis un fichier (tout format pris en charge)
sovrium start app.yaml
sovrium start config.json
sovrium start app.ts

# JSON en ligne
APP_SCHEMA='{"name":"my-app"}' sovrium start

# YAML en ligne
APP_SCHEMA='name: my-app' sovrium start

# Récupérée en HTTP au démarrage
APP_SCHEMA='https://example.com/app.yaml' sovrium start

Les extensions prises en charge sont .json, .yaml, .yml, .ts et .mts. Le format est détecté par l'extension, pas par le contenu : un document YAML enregistré en .txt est donc rejeté plutôt que deviné.

Mode surveillance

--watch (ou -w) demande à start de surveiller le fichier de configuration et de recharger le serveur à chaque modification. C'est la seule option qui change la façon dont start s'exécute.

sovrium start app.yaml --watch

Exemples

Les exemples par commande vivent avec chaque commande — voir Cycle de vie, Projet et Administration.

Codes de sortie

Déplacé vers Options globales et codes de sortie.

Pages associées

• Fichiers de configuration — les formats YAML et JSON lus par le CLI.
• Variables d'environnement — APP_SCHEMA, PORT, DATABASE_URL et les variables de build.
• Dépannage — les erreurs de démarrage affichées par ces commandes.