Référence des Commandes CLI Érable
Cette section documente l'ensemble des commandes disponibles dans l'interface en ligne de commande (CLI) d'Érable.
Chaque commande dispose d'une page dédiée détaillant sa syntaxe, ses options, ses règles de validation et des exemples concrets.
Index des Commandes
| Commande | Rôle | Documentation |
|---|---|---|
erable install |
Installe un ou plusieurs paquets et configure les trampolines et déduplications. | Documentation install |
erable uninstall |
Supprime un paquet et exécute les hooks de nettoyage. | Documentation uninstall |
erable prune |
Purge les anciennes versions des paquets installés selon une règle de rétention. | Documentation prune |
erable update |
Synchronise les dépôts de buckets locaux et valide les index. | Documentation update |
erable update-trampolines |
Met à jour tous les trampolines binaires depuis la référence locale. | Documentation update-trampolines |
erable list |
Affiche la liste des paquets installés et audite leur sécurité (--security). |
Documentation list |
erable search |
Recherche des paquets disponibles dans les buckets avec filtrage OS. | Documentation search |
erable apply |
Déploie un manifeste de configuration déclaratif (config.toml). |
Documentation apply |
erable version |
Affiche la version courante du moteur et la plateforme système. | Documentation version |
--security / security |
Vérification de sécurité multi-plateformes en parallèle (OSV.dev, CIRCL, MalwareBazaar, Sigstore Rekor, VirusTotal) sur install, apply et list. |
Documentation security |
Principes Généraux de la CLI
- Architecture en Couches (L0 - L4) : Les commandes CLI invoquent les pipelines L1 (
pipelines.nu) qui orchestrent les opérations L3 (orchestrators.nu) et les tâches élémentaires L4 (tasks.nu). - Gestion Stricte des Erreurs : En cas d'erreur de validation (contrat non respecté, paramètre invalide), la CLI retourne un code de sortie non-nul (
exit 1) avec une structure d'erreur claire[ERREUR: TYPE]. - Zéro Élévation de Privilèges : Toutes les commandes s'exécutent dans l'espace utilisateur (
$HOME/.erable) sans nécessiter de droits administrateur ou root.