Démarrage

Compiler le binaire

Compilez la CLI depuis le répertoire api/ :

cd api
make build-cli

Le binaire compilé est écrit à :

api/bin/gaard

Exécutez-le directement :

./bin/gaard version

Si vous souhaitez que gaard soit disponible dans votre PATH, installez le binaire compilé dans un répertoire déjà présent dans le PATH de votre shell.

Première connexion

Authentifiez-vous auprès de l’application Gaard par défaut :

./bin/gaard login

La commande demande :

• Un flux de connexion dans le navigateur

La CLI ouvre automatiquement le navigateur lorsque c’est possible. Dans le cas contraire, elle affiche une URL que vous pouvez ouvrir manuellement.

Après avoir approuvé la demande dans le navigateur, la CLI crée un token d’accès personnel et le stocke dans le fichier de configuration actif.

Pour vous connecter explicitement à un autre environnement :

./bin/gaard login --api http://127.0.0.1:8004 --name local

Premières commandes utiles

Vérifier l’identité actuelle :

./bin/gaard whoami

Lister les environnements configurés :

./bin/gaard ctx list

Afficher une sortie structurée pour l’automatisation :

./bin/gaard whoami -o json

Options globales

La plupart des commandes prennent en charge ces options globales :

• -c, --context pour surcharger le contexte pour une seule commande
• -t, --tenant pour surcharger le tenant pour une seule commande
• -o, --output pour choisir table ou json
• --no-color pour désactiver les couleurs ANSI
• -v, --verbose pour un journal détaillé

Aide intégrée

La CLI fournit une aide par commande :

./bin/gaard --help
./bin/gaard login --help
./bin/gaard ctx --help
./bin/gaard tenant --help