Qu'est-ce que le noid-cli #

noid-cli est l'acronyme de RELIANOID Interface de ligne de commande. Cet outil permet de gérer plusieurs équilibreurs de charge à partir d'une ligne de commande ou d'automatiser des actions d'équilibreur de charge dans les scripts d'opération.

noid-cli est un wrapper du API (RELIANOID Interface de programmation d'application), il dispose d'une fonction d'auto-complétion pour naviguer plus facilement dans les modules d'équilibrage de charge et ses objets.

Il peut être utilisé avec RELIANOID équilibreurs de charge avec la version EE 8.1 ou supérieure.

Premiers pas avec noid-cli #

Installation #

noid-cli est disponible dans la version officielle RELIANOID Les référentiels APT peuvent être installés dans un RELIANOID équilibreur de charge utilisant :

apt-get update && apt-get install noid-cli

De plus, ce paquet est également valable pour tout Debian, Ubuntu ou toute distribution basée sur deb afin de lancer des commandes à distance sur vos équilibreurs de charge.

Des profils d'utilisateurs #

Des profils d'utilisateurs contiennent les informations concernant l'équilibreur de charge où les commandes seront exécutées et l'utilisateur qui exécutera la commande. le utilisateur la fonctionnalité n'est disponible que pour RELIANOID Enterprise et il est géré dans le module RBAC, les commandes seront exécutées en fonction des autorisations de l'utilisateur. noid-cli est capable de gérer différents profils.

installation #

Avant de courir noid-cli a Clé API est requis. Il peut être activé à partir du RELIANOID Interface graphique Web, dans le menu Système> Utilisateur.

Une fois noid-cli est installé, il peut être démarré en exécutant noid-cli dans la coquille. S'il est exécuté à partir de l'équilibreur de charge, il s'exécutera avec le profil par défaut localhost qui gère l'équilibreur de charge local et la clé ZAPI sera demandée. Dans tous les autres cas, l'assistant de configuration sera démarré.

Si les paramètres de profil doivent être modifiés ou qu'un autre profil doit être créé, le noid-cli profil doit être exécuté.

Il est possible de définir le profil pendant la noid-cli temps d'invocation à l'aide du -p option comme indiqué ci-dessous.

root@noid-ee-01:~$ noid-cli -p mon_profil

ou en utilisant la commande avec noid-cli en mode interactif:

noid-cli : profil appliquer mon_profil

Comment il est utilisé #

noid-cli a deux modes de fonctionnement:

1. Lancé sans arguments, le noid-cli le shell est exécuté en mode interactif. Ce mode fournit la saisie semi-automatique et il ne se termine pas une fois qu'une commande est exécutée, pour quitter le noid-cli coquille, type quitter ou appuyez sur Ctrl + D.

2. noid-cli est invoqué avec des arguments. Cela exécutera la commande, sans entrer dans le noid-cli shell interactif, et le retour à la console système.

Voyons ci-dessous les commandes disponibles dans le RELIANOID Interface de ligne de commande.

Commandes #

Une commande a la syntaxe suivante:

root@noid-ee-01:~$ noid-cli [ options ] [ objet ] [action] [liste des identifiants] [ paramètres ]

A titre d'exemple:

root@noid-ee-01:~$ noid-cli -nc -p test-lb2 farms-services-backend set farm1 service1 0 -ip 1.1.1.1 -port 80 ^^ ...

Retrouvez ci-dessous la description de chaque paramètre.

Options: Ils sont définis dans le noid-cli invocation. La liste complète des options est détaillée dans l'aide.
objet: C'est le type d'objet d'équilibrage de charge qui est sélectionné.
action: C'est le verbe qui sera exécuté.
liste des identifiants: Ce sont les identifiants qui font référence à l'objet. Ces ID sont liés au module.
paramètres: Ce sont les paramètres à définir dans l'objet. Généralement, ils sont attendus lorsqu'un objet est créé / ajouté ou modifié.

Tous ces paramètres peuvent être utilisés au format JSON en utilisant le -j (–Json) option.

Les arguments de commande attendus peuvent être récupérés en appuyant sur Entrer. Parfois, les paramètres ne sont développés que lorsque les arguments précédents sont définis.

noid-cli a une fonctionnalité de complétion automatique qui peut être déclenchée en appuyant deux fois TAB .

L'aide mise à jour peut être vérifiée avec la commande ci-dessous.

root@noid-ee-01:~$ noid-cli aide

Des données de sortie #

Le noid-cli l'invite changera la couleur en fonction du code d'erreur de la commande. Ainsi, la sortie sera affichée dans et une transition qui soit juste. si la commande a réussi ou rouge s'il y a eu une erreur lors de l'exécution de la commande. De plus, le nom du profil sera imprimé comme gris quand noid-cli impossible de se connecter à l'équilibreur de charge. Pour ce type d'erreurs, il est utile d'examiner la configuration du profil et la clé ZAPI de l'équilibreur de charge.

La sortie est imprimée au format JSON coloré, mais ils peuvent être désactivés à l'aide de l'option -NC (–Pas de couleurs). Certains messages d'information peuvent s'afficher, ces messages sont omis lorsque noid-cli est lancé en mode d'exécution de commande (sans interactif noid-cli).

Les messages d'erreur sont affichés via le STDERR sortie.

Exemples de commandes #

Une liste complète d'exemples peut être consultée dans le Documentation ZAPI. Voici seulement quelques exemples utiles:

Obtenir des informations sur le système

root@noid-ee-01:~$ noid-cli système get

Obtenez les statistiques du système

root@noid-ee-01:~$ noid-cli système de statistiques obtenir

Énumérer un aperçu des fermes

root@noid-ee-01:~$ noid-cli liste de fermes

Créer une ferme

root@noid-ee-01:~$ noid-cli création de ferme -profile http -farmname ferme1 -vip 10.0.0.241 -vport 443

Récupérer la configuration d'une batterie de serveurs

root@noid-ee-01:~$ noid-cli ferme obtenir ferme1

Modifier une ferme

root@noid-ee-01:~$ noid-cli ensemble de fermes farm1 -listener https

Redémarrez une ferme

root@noid-ee-01:~$ noid-cli redémarrer la ferme farm1

Créer un service

root@noid-ee-01:~$ noid-cli farm-service ajouter farm1 -id images

Modifier un service

root@noid-ee-01:~$ noid-cli farm-service définir farm1 images -urlp /images

Ajouter un backend

root@noid-ee-01:~$ noid-cli farm-service-backend ajouter farm1 images -ip 10.0.4.40 -port 443

Modifier un backend

root@noid-ee-01:~$ noid-cli farm-service-backend définir farm1 images 0 -priorité 1

Supprimer un backend

root@noid-ee-01:~$ noid-cli farm-service-backend supprimer les images farm1 0

Désinstaller un backend en mode maintenance

root@noid-ee-01:~$ noid-cli farm-service-backend maintenance farm1 images 0

Définir un backend en mode maintenance

root@noid-ee-01:~$ noid-cli farm-service-backend images de la ferme1 sans maintenance 0

Profitez de noid-cli, le RELIANOID Interface de ligne de commande !