O que é a noid-cli #
noid-cli é o acrônimo de RELIANOID Interface da Linha de comando. Essa ferramenta permite gerenciar vários balanceadores de carga a partir de uma linha de comandos ou automatizar as ações do balanceador de carga nos scripts de operação.
noid-cli é um invólucro do API (RELIANOID Interface de Programação de Aplicativo), possui um recurso de preenchimento automático para navegar mais facilmente pelos módulos do balanceador de carga e seus objetos.
Pode ser usado com RELIANOID balanceadores de carga com versão EE 8.1 ou superior.
Primeiros passos com noid-cli #
Instalação #
noid-cli está disponível no site oficial RELIANOID Repositórios APT e pode ser instalado em um RELIANOID balanceador de carga usando:
apt-get update && apt-get install noid-cli
Além disso, este pacote também é válido para qualquer Debian, Ubuntu ou qualquer distribuição baseada em deb pacotes para iniciar comandos remotamente para seus balanceadores de carga.
Perfis de usuário #
Perfis de usuário contém as informações relacionadas ao balanceador de carga em que os comandos serão executados e o usuário que executará o comando. o usuário recurso está disponível apenas para RELIANOID Enterprise e é gerenciado no módulo RBAC, os comandos serão executados dependendo das permissões do usuário. noid-cli é capaz de gerenciar perfis diferentes.
instalação #
Antes de executar noid-cli a Chave API é necessário. Ele pode ser habilitado a partir do RELIANOID GUI da Web, no menu Sistema> Usuário.
Uma vez noid-cli está instalado, pode ser iniciado executando noid-cli na concha. Se for executado a partir do balanceador de carga, será executado com o perfil padrão localhost que gerencia o balanceador de carga local e a chave ZAPI será solicitada. Em qualquer outro caso, o assistente de configuração será iniciado.
Se as configurações do perfil precisarem ser modificadas ou outro perfil tiver que ser criado, o noid-cli profile objeto deve ser executado.
É possível definir o perfil durante o noid-cli tempo de chamada usando o -p opção como é mostrado abaixo.
root@noid-ee-01:~$ noid-cli -p meu_perfil
ou usando o comando com noid-cli em um modo interativo:
noid-cli: perfil aplicar meu_perfil
Como é usado #
noid-cli tem dois modos de trabalho:
1. Lançado sem argumentos, o noid-cli shell é executado no modo interativo. Esse modo fornece preenchimento automático e não termina quando um comando é executado, para sair do noid-cli concha, tipo desistir ou pressione Ctrl + D.
2. noid-cli é invocado com argumentos. Isso executará o comando, sem entrar no noid-cli shell interativo e o retorno ao console do sistema.
Vejamos abaixo os comandos disponíveis no RELIANOID Interface da Linha de comando.
comandos #
Um comando tem a seguinte sintaxe:
root@noid-ee-01:~$ noid-cli [opções] [objeto] [açao] [lista de IDs] [parâmetros]
Como um exemplo:
root@noid-ee-01:~$ noid-cli -nc -p test-lb2 farms-services-backend set farm1 service1 0 -ip 1.1.1.1 -port 80 ^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^ ^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ opções objeto ação ids lista parâmetros
Encontre abaixo a descrição de cada parâmetro.
opções: Eles estão definidos no noid-cli invocação. A lista completa de opções está detalhada na ajuda.
objeto: É o tipo de objeto do balanceador de carga selecionado.
açao: É o verbo que será executado.
lista de ids: São os identificadores que se referem ao objeto. Esses IDs estão relacionados ao módulo.
parâmetros: São os parâmetros a serem definidos no objeto. Principalmente, eles são esperados quando um objeto é criado / adicionado ou modificado.
Todos esses parâmetros podem ser usados no formato JSON usando o comando -j (–Json) opção.
Os argumentos de comando esperados podem ser recuperados pressionando Entrar. Às vezes, os parâmetros não são expandidos até que os argumentos anteriores sejam definidos.
noid-cli possui uma funcionalidade de preenchimento automático que pode ser acionada pressionando ABA botão.
A ajuda atualizada pode ser verificada com o comando abaixo.
root@noid-ee-01:~$ noid-cli ajuda
Dados de saída #
As noid-cli O prompt mudará a cor, dependendo do código de erro do comando. Portanto, a saída será mostrada em verde se o comando foi bem sucedido ou vermelho se houve um erro durante a execução do comando. Além disso, o nome do perfil será impresso como cinzento quando noid-cli não foi possível conectar ao balanceador de carga. Para esse tipo de erro, é útil revisar a configuração do perfil e a chave ZAPI do balanceador de carga.
A saída é impressa em um formato JSON colorido, mas eles podem ser desativados usando a opção -nc (-Não há cores) Algumas mensagens informativas podem ser mostradas, essas mensagens são omitidas quando noid-cli é iniciado no modo de execução de comando (sem interativo noid-cli).
As mensagens de erro são exibidas através do STDERR saída.
Exemplos de comando #
Uma lista completa de exemplos pode ser consultada no Documentação ZAPI. Aqui apenas alguns exemplos úteis:
Obter informações do sistema
root@noid-ee-01:~$ sistema noid-cli obter
Obter estatísticas do sistema
root@noid-ee-01:~$ noid-cli sistema-estatístico obter
Listar uma visão geral dos farms
root@noid-ee-01:~$ lista de fazendas noid-cli
Crie um farm
root@noid-ee-01:~$ noid-cli farm criar -perfil http -nomedafazenda farm1 -vip 10.0.0.241 -vport 443
Recuperar a configuração de um farm
root@noid-ee-01:~$ noid-cli farm obter farm1
Modificar um farm
root@noid-ee-01:~$ noid-cli farm set farm1 -listener https
Reinicie um farm
root@noid-ee-01:~$ noid-cli farm reiniciar farm1
Crie um serviço
root@noid-ee-01:~$ noid-cli farm-service adicionar farm1 -id imagens
Modifique um serviço
root@noid-ee-01:~$ noid-cli farm-service definir imagens farm1 -urlp /images
Adicionar um back-end
root@noid-ee-01:~$ noid-cli farm-service-backend adicionar imagens farm1 -ip 10.0.4.40 -porta 443
Modificar um back-end
root@noid-ee-01:~$ noid-cli farm-service-backend definir farm1 imagens 0 -prioridade 1
Excluir um back-end
root@noid-ee-01:~$ noid-cli farm-service-backend remover imagens farm1 0
Desativar um back-end no modo de manutenção
root@noid-ee-01:~$ noid-cli farm-service-backend manutenção farm1 imagens 0
Definir um back-end no modo de manutenção
root@noid-ee-01:~$ noid-cli farm-service-backend não_manutenção farm1 imagens 0
Enjoy noid-cli, RELIANOID Interface da Linha de comando!
