Aller au contenu

Commande : erable apply

Description

La commande erable apply applique une configuration déclarative de paquets définie dans un fichier TOML. Elle supporte deux modes de réconciliation :

  • append (par défaut) : installe les paquets déclarés sans impacter les paquets déjà installés.
  • replace : réconcilie strictement l'état du système avec le fichier déclaratif, en désinstallant automatiquement tout paquet présent sur le système qui ne figure pas dans la liste déclarée.

Elle intègre nativement la fonctionnalité security (via l'option CLI --security / -s ou la directive security = true directement dans le fichier TOML) afin de vérifier chaque paquet auprès des plateformes de sécurité (OSV.dev, CIRCL Hashlookup, MalwareBazaar, Sigstore Rekor, VirusTotal) avant installation.


Syntaxe

erable apply <config_path> [options]

Paramètres et Options

Argument / Option Type Défaut Description
config_path string (Obligatoire) Chemin vers le fichier de configuration TOML.
--mode string "append" Mode de réconciliation (append ou replace).
--security, -s bool false (Optionnel) Active la vérification de sécurité multi-plateformes sur tous les paquets du lot.
--virus-total-api-key string "" (Optionnel) Surcharge de la clé VirusTotal v3 pour le lot de paquets.
--cve-level string "none" (Optionnel) Seuil de tolérance CVE pour le déploiement (none, low, medium, high, critical).
--exclude-security, -x list<string> [] (Optionnel) Paquets exemptés du blocage de sécurité.
--help - - Affiche l'aide interactive.

Exemples

# Application incrémentale
erable apply ~/workspace/fleet-tools.toml

# Application avec vérification de sécurité multi-plateformes
erable apply ~/workspace/fleet-tools.toml --security

# Application avec clé VirusTotal et exemptions
erable apply ~/workspace/fleet-tools.toml -s --virus-total-api-key "xxxx" -x ["outil-interne"]

# Réconciliation stricte (désinstallation des superflus)
erable apply ~/workspace/fleet-tools.toml --mode replace