Installer la CLI

Une seule commande sous Linux, macOS ou Windows, une somme de contrôle pour chaque téléchargement, et comment la mettre à jour ou la supprimer.

isogrid est un exécutable unique, sans dépendances. La plateforme le distribue elle-même : vous l'installez donc depuis la même adresse que celle où vous vous connecterez.

L'API d'ISOGrid est https://api.isogrid.skyvault.pro, et toutes les commandes ci-dessous téléchargent depuis elle. La page CLI de la console affiche les mêmes commandes avec un bouton de copie, et un lien vers chaque build.

Linux et macOS

curl -fsSL https://api.isogrid.skyvault.pro/api/v1/cli/install.sh | sh

Le script détermine votre système et votre processeur, télécharge la version correspondante, la vérifie avec le fichier SHA256SUMS du serveur, et seulement ensuite la met en place. Si la somme de contrôle ne correspond pas, rien n'est installé.

Il installe dans /usr/local/bin si vous pouvez y écrire, et dans ~/.local/bin sinon. Pour choisir, définissez ISOGRID_INSTALL_DIR :

curl -fsSL https://api.isogrid.skyvault.pro/api/v1/cli/install.sh | ISOGRID_INSTALL_DIR="$HOME/bin" sh

Si le répertoire n'est pas dans votre PATH, le script vous le signale et affiche la ligne à ajouter à votre profil.

Le serveur inscrit sa propre adresse dans le script qu'il envoie : la commande en une ligne n'a donc besoin de rien d'autre. Si vous avez enregistré le script pour l'exécuter plus tard, ou s'il vient d'ailleurs, définissez ISOGRID_API_URL pour indiquer où télécharger.

Windows

Dans PowerShell 5.1 ou 7 :

irm https://api.isogrid.skyvault.pro/api/v1/cli/install.ps1 | iex

Cette commande installe isogrid.exe dans %LOCALAPPDATA%\isogrid\bin, le vérifie avec Get-FileHash et ajoute ce répertoire au PATH de votre utilisateur. Les terminaux ouverts avant l'installation ne voient pas le nouveau PATH ; ouvrez-en un nouveau.

$env:ISOGRID_INSTALL_DIR et $env:ISOGRID_API_URL fonctionnent comme sous Linux. Seules des versions x86 64 bits sont publiées pour Windows.

Télécharger vous-même

Si vous préférez ne pas envoyer un script directement dans un shell, la page CLI de la console web donne un lien vers chaque version. Vous pouvez aussi en récupérer une directement depuis https://api.isogrid.skyvault.pro/api/v1/cli/downloads/<file> :

https://api.isogrid.skyvault.pro/api/v1/cli/downloads (sans nom de fichier) renvoie la version et la liste de toutes les versions en JSON, ce qui est le moyen le plus simple d'automatiser un téléchargement.

Vérifier le téléchargement

Téléchargez SHA256SUMS à côté du binaire et vérifiez-le avant d'exécuter quoi que ce soit :

curl -fsSLO https://api.isogrid.skyvault.pro/api/v1/cli/downloads/isogrid-linux-amd64
curl -fsSLO https://api.isogrid.skyvault.pro/api/v1/cli/downloads/SHA256SUMS
sha256sum -c --ignore-missing SHA256SUMS
chmod +x isogrid-linux-amd64
sudo mv isogrid-linux-amd64 /usr/local/bin/isogrid

Sous macOS, utilisez shasum -a 256 -c --ignore-missing SHA256SUMS. Sous Windows :

(Get-FileHash .\isogrid-windows-amd64.exe -Algorithm SHA256).Hash

puis comparez le résultat avec la ligne de isogrid-windows-amd64.exe dans SHA256SUMS.

En cas de différence, ne l'exécutez pas. Téléchargez-le de nouveau ; si la somme ne correspond toujours pas, prévenez le support plutôt que de contourner le problème.

Vérifier que tout fonctionne

isogrid version
isogrid login

L'installateur fait pointer un CLI tout neuf vers l'adresse d'où il vient : login n'a besoin de rien d'autre, et un ~/.isogrid/config.json existant est laissé tel quel. Si vous avez installé le binaire à la main, connectez-vous une fois avec isogrid --api https://api.isogrid.skyvault.pro login : l'adresse est retenue, et les commandes suivantes n'ont plus besoin de --api. Voir la Référence des commandes pour la suite.

Mettre à jour

isogrid update            # download, verify, and replace this executable
isogrid update --check    # only say whether a newer build exists

update récupère la version que la plateforme propose pour votre système, la vérifie avec manifest.json et se remplace elle-même. --check se termine avec le code 0 qu'il y ait une mise à jour ou non : on peut donc l'utiliser sans risque dans un script qui veut seulement la signaler. --force réinstalle même lorsque les versions correspondent déjà.

Si l'exécutable se trouve dans un répertoire où vous ne pouvez pas écrire — /usr/local/bin sans être root, ou le répertoire d'un gestionnaire de paquets — update ne peut pas le remplacer. Mettez-le à jour comme vous l'avez installé : relancez l'installateur, ou exécutez les étapes manuelles ci-dessus avec sudo.

La CLI et la plateforme évoluent ensemble. Si une commande se met à échouer après une mise à niveau de la plateforme, isogrid update est la première chose à essayer.

Compiler depuis les sources

La CLI se trouve dans le répertoire cli/ du dépôt. Aucune chaîne d'outils Go n'est nécessaire sur votre machine : toutes les cibles s'exécutent dans le conteneur golang:1.23-alpine.

make build        # ./dist/isogrid for Linux
make test vet     # the test suite and go vet
make release      # every platform, plus SHA256SUMS, manifest.json, installers and CI templates
make install      # copy dist/isogrid to /usr/local/bin

Sans make :

docker run --rm -v "$PWD:/src" -w /src golang:1.23-alpine sh scripts/release.sh v1.2.3

docker build -t isogrid-cli ./cli produit une image minimale si vous préférez exécuter la CLI dans un conteneur.

Désinstaller

Déconnectez-vous d'abord, en révoquant l'identifiant sur le serveur, puis supprimez le binaire et sa configuration :

isogrid logout --revoke
rm "$(command -v isogrid)"
rm -rf ~/.isogrid

Sous Windows :

isogrid logout --revoke
Remove-Item "$env:LOCALAPPDATA\isogrid" -Recurse -Force
Remove-Item "$env:USERPROFILE\.isogrid" -Recurse -Force

puis retirez %LOCALAPPDATA%\isogrid\bin du PATH de votre utilisateur dans les paramètres du système.

Supprimer les fichiers ne révoque pas l'identifiant. Sans --revoke, une copie qui en aurait été prise sur la machine continue de fonctionner jusqu'à son expiration. Si la machine n'est plus disponible, révoquez-le depuis la console web.

Cas particuliers à connaître avant d'y être confronté

isogrid: command not found juste après l'installation. Le répertoire d'installation n'est pas encore dans votre PATH. Ajoutez-le comme l'installateur l'a suggéré, ou ouvrez un nouveau terminal sous Windows.

« no API address » de la part de l'installateur. Vous avez exécuté une copie du script qui ne provenait pas directement de la plateforme. Définissez ISOGRID_API_URL et relancez-le.

« cannot write to /usr/local/bin ». Définissez ISOGRID_INSTALL_DIR sur un répertoire qui vous appartient, par exemple ~/.local/bin.

macOS refuse d'ouvrir un binaire téléchargé manuellement. Les fichiers téléchargés par un navigateur sont mis en quarantaine. Le script d'installation évite ce problème ; pour un téléchargement manuel, exécutez xattr -d com.apple.quarantine /usr/local/bin/isogrid.