Guía de NCLI en Nutanix
En el último post hablé sobre las diferentes interfaces de línea de comandos que ofrece Nutanix, y dije que en los siguientes posts iba a profundizar en cada una de ellas, así que aquí tenéis el primero: NCLI
NCLI es una interfaz de línea de comandos que nos permite gestionar y supervisar nuestro clúster Nutanix sin necesidad de utilizar la interfaz gráfica, ya que con NCLI podemos ejecutar todo tipo de tareas y hacer cualquier cambio que necesitemos, como gestionar los hosts, el almacenamiento, las configuraciones del clúster, monitorizarlo, todo lo que necesites!! NCLI es una herramienta bastante amplia y con lo que te tienes que quedar es con que esta orientada a la administración general del clúster.
Instalación y Acceso a NCLI
Existen dos formas de usar NCLI, la primera y mas común es conectándote a una de las CVM de tu clúster, pero también puedes instalarte NCLI en tu ordenador, y gestionar clústers de Nutanix desde la terminar de tu terminal.
Instalación en un sistema local
Dentro de poco hare un post explicando como instalar NCLI en un sistema externo y como configurarlo para poder gestionar tu clúster Nutanix de manera remota.
Acceso desde una CVM
El primer paso para utilizar NCLI, es conectarte a una de las CVM del clúster mediante SSH. Esto lo puedes hacer con el siguiente comando:
ssh nutanix@<IP_DEL_NODO>
Una vez dentro, tienes dos opciones, puedes ejecutar ncli para ingresar a la interfaz de comandos interactiva y desde ahí lanzar comandos de ncli o puedes lanzar esos mismos comandos directamente desde la terminal sin entrar en el modo interactivo añadiendo ncli delante de cada uno, seria de esta forma:
Y como siempre, para salir de la interfaz, se usa el comando exit.
Ten en cuenta que si ejecutas los comandos dentro de ncli podrás usar el tabulador para autocompletar, pero si lo haces directamente en la cvm (La segunda forma del ejemplo) el autocompletado no estará disponible
Formato de Comandos y Ayuda Integrada
ncli <objeto> <accion> [parámetros]
ncli cluster status
ncli help ncli <objeto> help
La ayuda te mostrara una lista de las opciones disponibles y ejemplos de uso.
Principales Comandos de NCLI
Con lo que has visto hasta ahora ya puedes entrar en tu cvm y ponerte a hacer pruebas, pero para ayudarte un poco mas, por aquí te dejo una lista con algunos comandos, que he considerado útiles o simplemente interesantes, pero NCLI tiene muchos mas, y con la ayuda puedes ver y aprender como usarlos todos, en nada vas a poder eliminar, agregar o editar casi cualquier configuración de tu clúster usando solo la línea de comandos.
Comandos para la administración del Clúster
ncli cluster status
Ver el estado de la redundancia del cluster:
ncli cluster get-redundancy-state
Ver los parámetros generales del clúster:
ncli cluster get-params ncli cluster info
ncli cluster edit-params external-ip-address=192.168.1.100
Nota importante: En la CVM existen tanto el comando ncli cluster como el cluster, y esto puede generar confusión. ncli cluster se usa para modificar parámetros y configuraciones del clúster, mientras que cluster se utiliza para gestionar el estado del clúster (iniciar, detener, actualizar, etc.).
Pero hay un porqué detrás de esto, usando ncli también podrás iniciar o detener el clúster, pero hay que tener en cuenta que ncli solo esta disponible si el clúster esta correctamente iniciado, asique es por esto por lo que tenemos los comandos cluster que se ejecutan directamente en la CVM. Pero no te preocupes porque el formato es similar:
cluster start
Detener el cluster
cluster stop
Ver el estado del cluster
cluster status
Gestión de Hosts
ncli host list
ncli host list-stats
ncli host configure-node node-uuid=<host_uuid> ipmi-ip=192.168.30.100
ncli host remove-start id=<host_id> [force]
Máquinas Virtuales
ncli vm list
ncli vm list-stats
Gestión de Almacenamiento
ncli container list
ncli container create name=<nombre> sp-name=<nombre_del_storage_pool>
ncli container remove name=<nombre>
container edit name=<nombre> new-name=<nombre-nuevo>
container edit name=<nombre> enable-compression=false
ncli disk list
ncli storagepool list
Administración de usuarios
ncli user list
ncli user add user-name=<nombre_de_usuario> user-password=<Contraseña> first-name=<nombre> last-name=<apellido> email-id=<email>
Administracion del software de nutanix
ncli software list
ncli software download name=<nombre> software-type=<tipo_de_software>
ncli software remove name=<nombre> software-type=<tipo_de_software>
Monitorización y Salud del Clúster
ncli alerts list
ncli task list
Conclusión
NCLI es una herramienta potente que permite administrar de manera eficiente un clúster Nutanix mediante comandos simples y efectivos. Su uso es ideal para automatizar tareas, solucionar problemas rápidamente y manejar el clúster sin depender de una interfaz gráfica. Aprender y dominar NCLI puede ayudarte en la gestión de cualquier entorno Nutanix.
