Qu'est-ce que l'interface CLI d'Versa ?

L'interface de ligne de commande (CLI) d'Versa Il s'agit de l'interface en ligne de commande textuelle permettant de visualiser, de configurer et de gérer Versa Director, les nœuds d'Versa Analytics et les périphériques VOS. Les administrateurs y accèdent depuis un compte shell – sur Director, Analytics ou un périphérique VOS – et exécutent la commande cli commande pour la saisir, puis configure pour apporter des modifications.

Points clés à retenir

• L'interface CLI d'Versa permet de gérer les appareils Director, Analytics et VOS à partir d'un shell.
• Pour y accéder depuis un compte shell, il suffit d'exécuter la commande cli.
• La commande « configure » permet de passer en mode configuration ; la commande « commit » enregistre les modifications.
• WebSSH a remplacé Shell In a Box comme solution de shell accessible via un navigateur.
• L'accès au cluster CLI par le directeur couvre les nœuds principal, secondaire et arbitre.

Sur cette page : Pourquoi est-ce important ? · Comment ça marche · Versa Méthodes d'accès à l'interface CLI · Versa L'interface CLI et la plateforme d'VersaONE · FAQ

Pourquoi l'interface de ligne de commande (CLI) de l'Versa est-elle importante ?

L'interface graphique de Director couvre la grande majorité des tâches d'administration quotidiennes, mais elle n'en représente pas l'intégralité. Le dépannage approfondi, les vérifications diagnostiques ponctuelles et les paramètres que l'interface graphique ne met pas en avant s'effectuent toujours via une invite de commande. En effet, les appareils Director, Analytics et VOS suivent tous le même principe de base : se connecter à un compte shell, exécuter cli pour accéder à l'interface, éventuellement configure pour apporter des modifications : un administrateur qui maîtrise une fois l'interface de ligne de commande (CLI) d'Versa peut intervenir en toute confiance à tous les niveaux du déploiement : la console d'orchestration, le backend de télémétrie et les terminaux eux-mêmes.

C'est également la solution de secours lorsque quelque chose d'autre ne fonctionne pas. Si la configuration d’un appareil a dérivé, si un service doit être redémarré ou si l’interface graphique elle-même est inaccessible, l’interface en ligne de commande (CLI) constitue le lien direct avec l’appareil. Cette directivité a toutefois un double effet : les modifications effectuées et validées depuis la CLI d’un appareil VOS désynchronisent sa configuration en cours d’exécution par rapport à celle stockée dans la base de données de Director. C’est pourquoi l’accès via la CLI est considéré comme une fonctionnalité délibérée et soumise à audit, plutôt que comme une alternative informelle à l’interface utilisateur.

Qu'est-ce que l'interface CLI d'Versa ?

Chaque type de nœud dispose de son propre compte shell par défaut – admin sur les appareils VOS, Administrateur au directeur, versa sur Analytics – et l'interface CLI d'Versa elle-même est accessible de la même manière depuis n'importe lequel d'entre eux : exécutez la commande cli commande à l'invite du shell, et l'invite devient > pour vérifier que vous êtes bien dans l'interface en ligne de commande. À n'importe quelle invite, tapez ? répertorie les commandes disponibles, qui varient en fonction du type de nœud et du mode CLI actuel.

Entrée configure modifie l'invite de commande pour qu'elle devienne %, le mode de configuration, dans lequel vous pouvez exécuter des commandes de configuration et d’affichage – par exemple, pour définir les interfaces associées à une instance de routage sur un périphérique de succursale. A commit Cette commande enregistre les modifications ; exit revient à la > invite, et exit revient à nouveau au shell. Il s'agit d'un vocabulaire restreint et cohérent : shell, cli, configure, commit, exit – réutilisé partout où l'interface en ligne de commande (CLI) est exécutée.

Versa Méthodes d'accès à l'interface en ligne de commande (CLI)

La manière d’accéder à un compte shell dépend du type de nœud. Les nœuds Director sont accessibles depuis l’interface utilisateur (UI) de Director elle-même : sélectionnez « Director CLI » dans le menu « Nom d’utilisateur », puis (à partir de la version 23.1.2) choisissez le nœud du cluster Director auquel vous souhaitez vous connecter (primaire, secondaire ou arbitre), en consultant l’état de configuration de chaque nœud ainsi que ses adresses IP « northbound » et « southbound » avant de vous connecter. Les nœuds Analytics utilisent l’utilitaire SSH standard pour se connecter directement au shell.

Les appareils VOS sont classés par version. À partir de la version 23.1.1, WebSSH – une interface SSH accessible via un navigateur ne nécessitant aucun client externe tel que PuTTY – s’ouvre à partir de l’icône « Shell » sur l’écran « Appliances » de l’onglet « Administration » de Director, et prend en charge la journalisation des sessions avec des journaux téléchargeables ainsi que la prise en charge du presse-papiers dans le navigateur. Les versions 22.1.4 et antérieures utilisent quant à elles « Shell In a Box », un émulateur de terminal web accessible depuis le même écran « Appliances ». WebSSH a également ajouté une double authentification : seuls les utilisateurs PDCSA (Provider Data Center System Admin) bénéficient d’un accès direct au shell, tandis que tous les autres doivent saisir à nouveau un nom d’utilisateur et un mot de passe spécifiques pour accéder à l’interface en ligne de commande (CLI).

Versa CLI et la plateforme « VersaONE »

L'interface CLI ( Versa ) est l'un des trois moyens dont disposent les administrateurs pour accéder à VersaONE, aux côtés de l'interface graphique (GUI) de Director et des API REST « northbound » : il s'agit d'une option directe, basée sur du texte, lorsque la précision ou la profondeur du dépannage priment sur un workflow graphique. WebSSH est aujourd’hui ce qui unifie cet accès entre les différents types de nœuds : plutôt que d’exiger un client SSH installé localement et une accessibilité réseau directe à chaque appareil, il centralise l’accès au terminal au sein de l’interface utilisateur du navigateur de Director, ce qui est important lorsque la politique de sécurité restreint l’utilisation de SSH directement depuis l’ordinateur portable d’un administrateur.

Cette cohérence n'efface toutefois pas les différences entre les types de nœuds : les noms des comptes shell, les commandes disponibles et même la méthode d'accès elle-même (SSH, WebSSH ou le menu Director) dépendent toujours du type d'appareil utilisé (Director, Analytics ou VOS), comme indiqué dans la section « Accéder à l'interface CLI d'Versa ».

Questions fréquentes

Comment lancer l'interface de ligne de commande (CLI) d'Versa ?

Connectez-vous à un compte shell sur un nœud Director, un nœud Analytics ou un périphérique VOS, puis exécutez la commande cli commande à l'invite du shell. L'invite devient alors >, ce qui indique que vous êtes dans l'interface en ligne de commande ; à partir de là, configure passe en mode configuration pour effectuer des modifications.

Quelle est la différence entre le mode opérationnel et le mode de configuration ?

À la > Une fois à l'invite, vous êtes en mode opérationnel, où vous pouvez exécuter des commandes « show » et saisir ? pour répertorier les éléments disponibles. Émettre configure modifie l'invite de commande pour qu'elle devienne %, le mode de configuration, dans lequel vous saisissez les modifications de configuration, puis vous les enregistrez à l'aide d'une commande de validation.

La modification de la configuration d'un périphérique VOS via l'interface CLI a-t-elle une incidence sur Director ?

Oui. Lorsque vous modifiez la configuration d’un périphérique VOS depuis l’interface de ligne de commande (CLI) et que vous validez ces modifications, la configuration active du périphérique n’est plus synchronisée avec celle stockée dans la base de données de Director – un état qui doit être réconcilié séparément de l’utilisation habituelle de la CLI.

Qu'est-ce qui a remplacé Shell In a Box pour accéder à l'interface de ligne de commande (CLI) de l'appareil VOS ?

WebSSH, disponible à partir de la version 23.1.1. Il s'agit d'une interface Secure Shell accessible via un navigateur qui ne nécessite aucun client SSH externe, offre une journalisation complète des sessions avec des journaux téléchargeables, et impose à la plupart des utilisateurs de s'authentifier à nouveau à l'aide d'un nom d'utilisateur et d'un mot de passe, même après s'être connectés à Director.

Les appareils Director, Analytics et VOS utilisent-ils la même interface de ligne de commande (CLI) ?

Ils partagent le même modèle de commande : un compte shell, le cli commande à saisir, configure pour le mode de configuration – mais le nom par défaut du compte shell et les commandes spécifiques disponibles varient selon le type de nœud, et la méthode d'accès (SSH, WebSSH ou l'interface utilisateur du Director) diffère également.

En savoir plus sur l'interface de ligne de commande (CLI) d'Versa

Si vous souhaitez en savoir plus, voici des sources auxquelles nous faisons confiance.

Termes associés

Si vous vous renseignez sur l'interface de ligne de commande (CLI) d'Versa , voici quelques ressources qui pourraient vous intéresser.