Scripting et sortie JSON

Sortie structurée

Utilisez la sortie JSON dès qu’un autre outil doit parser le résultat :

gaard whoami -o json
gaard token list -o json
gaard tenant list -o json

La sortie en tableau est la valeur par défaut pour un usage interactif au terminal.

Surcharge du contexte et du tenant

Il n’est pas nécessaire de changer la configuration globale simplement pour exécuter une seule commande sur un autre environnement.

Exécuter une commande sur un contexte précis :

gaard --context staging whoami -o json

Exécuter une commande sur un tenant précis :

gaard --context prod --tenant acme_prod token list -o json

Motifs non interactifs

Bonnes pratiques d’automatisation :

• Préférez -o json
• Passez --context et --tenant explicitement lorsque l’environnement compte
• Utilisez --no-color lorsque les logs peuvent être parsés ou stockés
• Stockez des fichiers de configuration personnalisés avec GAARD_CONFIG pour isoler les jobs

Exemple :

GAARD_CONFIG=/tmp/gaard-ci.yaml \
  gaard --context staging --tenant acme_prod whoami -o json --no-color

Gestion des tokens pour l’automatisation

Utilisez gaard token create pour générer un token d’accès personnel pour un bot ou un script :

gaard token create --name ci-bot --expires 720h

La commande affiche le token brut une seule fois. Stockez-le immédiatement dans votre gestionnaire de secrets ou vos variables CI.

Sortie humaine ou sortie machine

Choisissez la sortie selon l’appelant :

• table pour les humains dans un terminal
• json pour les scripts, la CI et les agents IA

Si vous construisez une automatisation de plus haut niveau, préférez encapsuler les commandes gaard plutôt que de scraper la sortie tabulaire.