Installation de bext -tui

bext-tui est un binaire statique unique dans l'espace de travail bext. Il n'y a aucune dépendance système au-delà d'un terminal fonctionnel.

De la source#

bext-tui réside dans crates/bext-tui à l’intérieur du monorepo bext. Construisez-le avec du fret :

bash

cd /path/to/bext
cargo build --release -p bext-tui

Le binaire est alors à target/release/bext-tui. Copiez-le dans un répertoire de votre PATH :

bash

sudo cp target/release/bext-tui /usr/local/bin/
bext-tui --version

Exigences#


Rouille	1.85+ (l'espace de travail bext épingle une chaîne d'outils nocturnes - `bext-tui` lui-même n'a besoin que de stabilité mais hérite du `.cargo/config.toml` de l'espace de travail)
Borne	tout terminal prenant en charge une palette de 256 couleurs et l'écran alternatif - `xterm`, `iTerm2`, `WezTerm`, `Alacritty`, `kitty`, terminal GNOME moderne, Konsole moderne. Aucune prise en charge de l'ancienne console Linux framebuffer.
Paramètres régionaux	Paramètres régionaux UTF-8 (les icônes d'état utilisent des caractères de bloc Unicode)

Ce qu'il installe#

Un seul binaire lié statiquement, environ 10 à 14 Mo supprimés. Aucun démon, aucun fichier de configuration requis pour le mode distant par défaut.

Vérification#

bash

bext-tui --help

Vous devriez voir l'utilisation de la CLI. Pour vérifier qu'il peut se connecter à une instance bext en cours d'exécution :

bash

bext-tui --host 127.0.0.1 --port 4000 --token "$BEXT_ADMIN_TOKEN"

Appuyez sur q pour quitter.

Où le binaire se connecte#

Par défaut, bext-tui interroge ces points de terminaison d'API d'administration sous votre instance bext :

GET /__bext/admin/api/overview
GET /__bext/admin/api/requests
GET /__bext/admin/api/cache
GET /__bext/admin/api/workers
GET /__bext/admin/api/proxy
GET /__bext/admin/api/waf
GET /__bext/admin/api/sites (revient à /apps )
GET /__bext/admin/api/certs
GET /__bext/admin/api/deployments
GET /__bext/admin/api/license
GET /__bext/admin/api/config
WS /__bext/admin/ws/logs pour le flux de requêtes en direct

Le jeton du porteur doit avoir un accès administrateur. Pour les jetons à l'échelle du locataire, la TUI ne verra que les données du locataire auquel appartient le jeton – cela est appliqué côté serveur.

Dépannage#

broken pipe (os error 32) — votre session SSH a été interrompue sans arrêt propre. Relancez le TUI ; rien n'est persistant côté serveur.

failed to enable raw mode — le terminal n'est pas un ATS. bext-tui nécessite un terminal interactif : il ne peut pas être redirigé ou exécuté dans un CI non PTY.

L'écran est plein de séquences d'échappement — le crochet anti-panique n'a pas restauré le terminal proprement. Exécutez reset ou tput reset pour le nettoyer.

certificate verify failed — bext-tui accepte par défaut les certificats auto-signés en mode distant. Si vous voyez cela, reconstruisez avec la chaîne d'outils de l'espace de travail pour vous assurer que les racines de Rustls sont à jour.

Conseil

Pour les jetons à l'échelle du locataire, la TUI affichera uniquement les données de ce locataire : des jetons de niveau administrateur sont requis pour voir la vue complète de la flotte.

En rapport#

Présentation de TUI — résumé des fonctionnalités et tableau de comparaison
Modes de connexion TUI — comment pointer le TUI vers une instance bext
Configuration de l'interface utilisateur — Indicateurs CLI et variables d'environnement
Architecture → Référence de caisse — la caisse bext-tui dans le monorepo