¿Qué es noid-cli #

noid-cli es el acrónimo de RELIANOID Interfaz de línea de comandos. Esta herramienta permite gestionar múltiples balanceadores de carga desde una línea de comando o automatizar las acciones del balanceador de carga en los scripts de operación.

noid-cli es una envoltura del API (RELIANOID Interfaz de programación de aplicaciones), tiene una función de autocompletado para navegar más fácilmente a través de los módulos del balanceador de carga y sus objetos.

Se puede utilizar con RELIANOID balanceadores de carga con versión EE 8.1 o superior.

Primeros pasos con noid-cli #

Instalación #

noid-cli está disponible en el sitio oficial RELIANOID Repositorios APT y se puede instalar en un RELIANOID balanceador de carga usando:

apt-get update y apt-get install noid-cli

Además, este paquete también es válido para cualquier Debian, Ubuntu o cualquier distro basada en debutante paquetes para ejecutar comandos de forma remota a sus balanceadores de carga.

Perfiles de usuario #

Perfiles de usuario contiene la información con respecto al balanceador de carga donde se ejecutarán los comandos y el usuario que ejecutará el comando. El usuario La función solo está disponible para RELIANOID Enterprise y se administra en el módulo RBAC, los comandos que se ejecutarán dependerán de los permisos del usuario. noid-cli es capaz de gestionar diferentes perfiles.

Configuración #

Antes de correr noid-cli a Clave API se requiere. Se puede habilitar desde el RELIANOID GUI web, en el menú Sistema > Usuario.

En el momento que todos los DARWINs coticen incluyendo los deslizamientos noid-cli está instalado, se puede iniciar ejecutando noid-cli en el caparazón. Si se ejecuta desde el balanceador de carga, se ejecutará con el perfil predeterminado localhost que gestiona el balanceador de carga local y se solicitará la clave ZAPI. En cualquier otro caso se iniciará el asistente de configuración.

Si es necesario modificar la configuración del perfil o crear otro perfil, el noid-cli perfiles objeto debe ser ejecutado.

Es posible configurar el perfil durante el noid-cli tiempo de invocación usando el -p opción como se muestra a continuación.

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

o usando el comando con noid-cli en modo interactivo:

noid-cli: perfil aplicar my_profile

Cómo se usa #

noid-cli tiene dos modos de trabajo:

1. Lanzado sin argumentos, el noid-cli shell se ejecuta en modo interactivo. Este modo proporciona autocompletado y no finaliza una vez que se ejecuta un comando, para salir del noid-cli cáscara, tipo renuncia o pulse Ctrl + D.

2. noid-cli se invoca con argumentos. Esto ejecutará el comando, sin entrar en el noid-cli shell interactivo y el regreso a la consola del sistema.

Veamos a continuación los comandos disponibles en el RELIANOID Interfaz de línea de comandos.

Comandos #

Un comando tiene la siguiente sintaxis:

raíz@noid-ee-01:~$ noid-cli [opciones] [ objeto ] [acción] [lista de identificadores] [parámetros]

Como un ejemplo:

root@noid-ee-01:~$ noid-cli -nc -p test-lb2 farms-services-backend set farm1 service1 0 -ip 1.1.1.1 -port 80 ^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^ ^^^ ^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^ opciones objeto acción id lista parámetros

Encuentre a continuación la descripción de cada parámetro.

opciones: Están establecidos en el noid-cli invocación. La lista completa de opciones se detalla en la ayuda.
objeto: Es el tipo de objeto equilibrador de carga que se selecciona.
action: Es el verbo que se ejecutará.
lista de identificadores: Son los identificadores que hacen referencia al objeto. Estos ID están relacionados con el módulo.
parámetros: Son los parámetros a configurar en el objeto. En su mayoría, se esperan cuando se crea, agrega o modifica un objeto.

Todos estos parámetros se pueden utilizar en formato JSON utilizando el -j (–json) opción.

Los argumentos esperados del comando se pueden recuperar presionando entrar:. A veces los parámetros no se expanden hasta que se establezcan los argumentos anteriores.

noid-cli tiene una función de autocompletar que se puede activar presionando doble TAB .

La ayuda actualizada se puede consultar con el siguiente comando.

root@noid-ee-01:~$ ayuda de noid-cli

Datos resultantes #

Los noid-cli El mensaje cambiará el color según el código de error del comando. Entonces la salida se mostrará en claro si el comando fue exitoso o rojo si hubo un error durante la ejecución del comando. Además, el nombre del perfil se imprimirá como gris cuándo noid-cli No se pudo conectar al balanceador de carga. Para este tipo de errores, es útil revisar la configuración del perfil y la clave ZAPI del balanceador de carga.

La salida se imprime en formato JSON en color, pero se pueden desactivar usando la opción -Carolina del Norte (–No-colores). Se podrían mostrar algunos mensajes informativos, esos mensajes se omiten cuando noid-cli se inicia en modo de ejecución de comandos (sin interacción noid-cli).

Los mensajes de error se muestran a través del ESTDERR salida.

Ejemplos de comandos #

Se puede consultar una lista completa de ejemplos en el Documentación zapi. Aquí sólo algunos ejemplos útiles:

Obtener información del sistema

root@noid-ee-01:~$ sistema noid-cli obtener

Obtener estadísticas del sistema

root@noid-ee-01:~$ noid-cli sistema de estadísticas obtener

Enumere una descripción general de las granjas.

root@noid-ee-01:~$ lista de granjas noid-cli

Crear una granja

root@noid-ee-01:~$ noid-cli granja crear -profile http -farmname granja1 -vip 10.0.0.241 -vport 443

Recuperar la configuración de una granja

root@noid-ee-01:~$ noid-cli granja obtener granja1

Modificar una granja

raíz@noid-ee-01:~$ noid-cli granja set farm1 -listener https

Reiniciar una granja

root@noid-ee-01:~$ noid-cli granja reiniciar granja1

Crea un servicio

root@noid-ee-01:~$ noid-cli farm-service agregar granja1 -id imágenes

Modificar un servicio

root@noid-ee-01:~$ noid-cli farm-service establece imágenes de granja1 -urlp /images

Agregar un servidor

root@noid-ee-01:~$ noid-cli farm-service-backend agregar imágenes de la granja1 -ip 10.0.4.40 -puerto 443

Modificar un backend

root@noid-ee-01:~$ noid-cli farm-service-backend establece las imágenes de la granja1 0 -prioridad 1

Eliminar un backend

root@noid-ee-01:~$ noid-cli farm-service-backend eliminar imágenes de la granja1 0

Desarmar un backend en modo de mantenimiento

root@noid-ee-01:~$ noid-cli farm-service-backend mantenimiento granja1 imágenes 0

Establecer un backend en modo de mantenimiento

root@noid-ee-01:~$ noid-cli servicio-de-granja-backend no_de_mantenimiento granja1 imágenes 0

¡Disfruta noid-cli, RELIANOID ¡Interfaz de línea de comando!