Aller au contenu principal

Installer la CLI

Disponible

Fonctionnalité déployée et prise en charge. Les champs et commandes décrits ici sont stables au sein de la version v1alpha1.

Les binaires précompilés ne sont pas encore publiés : la CLI se construit depuis les sources, en une commande.

La CLI sng est un binaire unique, sans dépendance, écrit en Go. Elle parle à l'API StackNGO et stocke sa configuration dans ~/.config/stackngo/config.yaml.

Prérequis​

  • Go 1.27 ou plus récent (go.dev/dl) et make.
  • Un navigateur sur la même machine, pour la connexion interactive (sng sso login). Pour une machine sans navigateur (serveur, CI), voir Comptes machines.

Linux et macOS​

git clone https://gitlab.com/stackngo/sng-cli.git
cd sng-cli
make build
sudo make install          # installe bin/sng dans /usr/local/bin
sng --version

Sans droits administrateur, installez dans un dossier à vous :

make install BINDIR="$HOME/.local/bin"

make build embarque l'adresse de l'API (https://api.dev.stackngo.fr) et du service d'authentification dans le binaire : il n'y a rien à configurer.

Windows​

Depuis un terminal PowerShell avec Go et make (par exemple via Scoop : scoop install go make) :

git clone https://gitlab.com/stackngo/sng-cli.git
cd sng-cli
make build
Copy-Item .\bin\sng.exe "$env:LOCALAPPDATA\Programs\sng\sng.exe"

Ajoutez %LOCALAPPDATA%\Programs\sng à votre PATH. Le fichier de configuration est alors %APPDATA%\stackngo\config.yaml.

WSL

Sous WSL, suivez simplement la procédure Linux.

Vérifier l'installation​

sng --version
sng --help
sng version dev

La version affichée est dev pour un binaire construit depuis les sources.

Complétion du shell​

# bash
sng completion bash | sudo tee /etc/bash_completion.d/sng > /dev/null
# zsh
sng completion zsh > "${fpath[1]}/_sng"
# fish
sng completion fish > ~/.config/fish/completions/sng.fish
# PowerShell
sng completion powershell | Out-String | Invoke-Expression

Mettre à jour​

cd sng-cli && git pull && make build && sudo make install

Pour aller plus loin​

  • make build-all produit des archives pour Linux, macOS et Windows (amd64 et arm64) avec leurs sommes de contrôle, si vous voulez distribuer le binaire dans votre équipe.
  • Les flags globaux (--config, --json, -v) et le fichier de configuration sont décrits dans la référence.

Étape suivante : Se connecter.