Modes de connexion

bext-tui peut se connecter à bext de trois manières. Choisissez celui qui correspond à l'endroit où la TUI s'exécute par rapport au serveur bext.

Mode distant (par défaut)#

Connectez-vous via HTTP(S) à un point de terminaison d'administrateur bext :

bext-tui \
  --host activ-2.activcommunication.ch \
  --port 443 \
  --tls \
  --token "$BEXT_ADMIN_TOKEN"

C'est le mode le plus courant. Le TUI n'est qu'un client API d'administration : chaque octet passe par le réseau vers les mêmes points de terminaison /__bext/admin/api/* utilisés par le tableau de bord Web. La connexion est authentifiée par jeton du porteur ; pas de danse de connexion séparée.

Le jeton peut provenir :

1. L'indicateur CLI --token (priorité la plus élevée)
2. La variable d'environnement BEXT_ADMIN_TOKEN
3. (Futur) ~/.config/bext/credentials.toml

Quand l'utiliser#

• Piloter des serveurs de production depuis votre ordinateur portable
• Connexion à l'instance de développement d'un collègue via le réseau du bureau
• Partout où vous pouvez accéder au port d'administration mais n'avez pas accès au shell

Mode local#

Lorsque bext-tui s'exécute sur la même machine que bext :

bext-tui --local --host 127.0.0.1 --port 4000

Le mode local est identique au mode distant en termes de trafic réseau : il communique toujours avec l'API d'administration. La différence est que le TUI peut également lire l'état local :

Si bext.config.toml n'est pas dans le répertoire courant, pointez dessus avec --config :

bext-tui --local --config /etc/bext/bext.config.toml

Quand l'utiliser#

• Sur un serveur de production sur lequel vous vous êtes connecté via SSH
• Exécution locale pendant le développement avec un serveur bext dev
• Partout où le TUI peut lire les chemins du système de fichiers, l'API d'administration n'expose pas

Mode multi-instance#

Tableau de bord agrégé sur de nombreuses instances bext :

bext-tui --instances ~/.config/bext-tui/instances.toml

Le fichier d'instances répertorie tous les serveurs que vous souhaitez surveiller :

# ~/.config/bext-tui/instances.toml

[[instance]]
name = "activ-2"
host = "activ-2.activcommunication.ch"
port = 443
tls = true
token = "$BEXT_ADMIN_TOKEN_ACTIV2"

[[instance]]
name = "vps-staging"
host = "staging.example.com"
port = 4000
tls = false
token = "$BEXT_ADMIN_TOKEN_STAGING"

[[instance]]
name = "dev-laptop"
host = "127.0.0.1"
port = 4000
tls = false

Le tableau de bord affiche ensuite une vue agrégée : taux de requêtes total pour toutes les instances, nombre total de travailleurs, nombre total d'entrées mises en cache et éventuelles alertes d'intégrité par instance. Explorez une seule instance avec la palette de commandes ( : puis saisissez son nom).

Les jetons dans la configuration de l'instance peuvent être des chaînes littérales ou des références $ENV_VAR : la TUI développe les variables d'environnement au démarrage.

Quand l'utiliser#

• Exploitation d'une flotte de serveurs bext dans plusieurs régions
• Exécuter un MSP avec un tableau de bord par client
• Regarder la production + la préproduction + le développement dans un seul volet

Comparaison des modes#

Vous pouvez changer de mode au sein d'une session : appuyez sur : pour ouvrir la palette de commandes et tapez connect <name> pour passer à une autre instance.

En rapport#

• Installation TUI — construisez et installez d'abord le binaire
• Configuration de l'interface utilisateur — indicateur CLI complet et référence de la variable d'environnement
• Palette de commandes TUI — la commande connect et autres actions de la palette
• Configuration → Points de terminaison et informations d'identification — d'où proviennent les jetons d'administrateur