Cluster, nós e serviços
O que é um cluster
Um cluster é um grupo de servidores que o vStack Center gerencia como um único recurso. Cada servidor do cluster é chamado de nó: ele hospeda um hipervisor, discos locais e pools de armazenamento. As máquinas virtuais e os data centers virtuais (VDCs) são executados sobre esse grupo, e não em um servidor específico.
O cluster expõe seus parâmetros por meio de suas opções. Elas incluem o nome e o
identificador do cluster, o site e a localização, os limites para novos objetos
(vcpu_max, max_disk_size, max_ram_size, mtu_max), o limite de ocupação dos
pools (pool_capacity_treshold) e um conjunto de flags dos recursos ativados. As
opções são exibidas junto com a lista de nós, oferecendo uma visão única do estado do
cluster.
Quem gerencia o quê
O vStack Center não interage diretamente com os nós. Os comandos de gerenciamento dos membros do cluster — ativar um nó, desativar um nó, iniciar ou parar um serviço — vão para o Cluster Manager, um componente do vStack OS. O dispatcher do cluster troca mensagens com ele via ZeroMQ, e o Cluster Manager entrega o comando aos nós via AMQP. É por isso que a indisponibilidade do Cluster Manager aparece na API como uma categoria separada de erros: o próprio vStack Center está em execução, mas não há nenhum componente disponível para entregar o comando.
Cluster Manager e Cluster master são coisas diferentes. O Cluster Manager é o
componente do vStack OS que gerencia os nós (sua CLI em um nó é vstack-cluster,
consulte a documentação do vStack OS). O Cluster master é o
papel de acesso nº 1, com permissões totais no cluster. O primeiro determina quem
executa os comandos; o segundo determina quem tem permissão para solicitá-los.
O vStack Center coleta alguns dados por meio de fontes diferentes do Cluster Manager. O inventário de hardware, as versões de pacotes e os parâmetros de configuração dos nós vêm do agente do nó e são armazenados no banco de dados. O consumo real de CPU e memória vem do InfluxDB. Essas fontes se comportam de forma diferente, e essas diferenças são visíveis na interface.
| O que você visualiza | Fonte | O que acontece se a fonte falhar |
|---|---|---|
| Lista de nós, status de nós e serviços | Cluster Manager via ZeroMQ | Nenhum estado é exibido; a tela informa um erro ao obter o status |
| Inventário de hardware, versões de software, configuração | Banco de dados preenchido pelo agente do nó | Os valores são exibidos, mas estão desatualizados — verifique a coluna Last_seen |
| Consumo real de CPU e RAM | InfluxDB | O consumo é zero; a capacidade do nó não é exibida |
| Provisionamento (recursos alocados às VMs) | Banco de dados do vStack Center | Sempre calculado, independentemente das métricas |
A implicação prática: "utilização zero" e "sem dados" são estados diferentes. Os valores provisionados continuam confiáveis mesmo quando as métricas não estão sendo coletadas.
Dois status para cada objeto
Um nó ou serviço é descrito por um par de status, e não por um único status. O status administrativo é o que o administrador permitiu. O status operacional é o que de fato está acontecendo. A diferença entre eles indica se um nó foi retirado de serviço intencionalmente ou se falhou por conta própria.
| Campo | Objeto | Valores | Significado |
|---|---|---|---|
admin_status | nó | ONLINE, OFFLINE | Se o administrador permitiu que o nó opere |
oper_status | nó | estado do nó | O estado real informado pelo nó |
enabled | nó, serviço | true, false | Forma abreviada da permissão administrativa para operar |
admin_status | serviço | STARTED, STOPPED | Estado desejado do serviço |
oper_status | serviço | estado do serviço | Estado real do serviço |
nodeId | serviço | identificador do nó | O nó em que o serviço é executado |
Um serviço do cluster é uma unidade que o Cluster Manager inicia em um nó específico.
Os serviços incluem os pools de armazenamento (com nomes como zpool_tank0) e os
serviços de sistema do cluster. Portanto, um serviço tem duas dimensões independentes:
se está ativado ou desativado e se está iniciado ou parado. Ativar um serviço não o
inicia, e um serviço em execução para se for desativado.
O que diferentes usuários podem ver
Todos os usuários compartilham o mesmo mapa de status do cluster, mas o que eles podem ver depende de seus privilégios. Um administrador do cluster obtém o mapa completo, um observador obtém o mesmo mapa no modo "somente painel", e um usuário comum obtém apenas uma lista dos seus VDCs.
| Privilégio | O que fica visível |
|---|---|
View Cluster Status Map (full) (6003) | Mapa completo: nós, serviços, opções do cluster |
View Cluster Status Map (6000) sem 6003 | A lista de VDCs do usuário e as opções; sem dados de composição do cluster |
View Cluster Status Map (dashboard) (6004) sem 6003 nem 6000 | Os mesmos dados, mas marcados como painel — apenas para visualizar o resumo |
Os privilégios são avaliados nesta ordem: 6003, depois 6000, depois 6004. Para um usuário com os papéis vDC Admin (role_id=2) e Resource Viewer (role_id=5), o privilégio 6000 tem, portanto, precedência sobre o 6004. Esse usuário obtém uma lista de VDCs. O modo painel está disponível para usuários que têm 6004, mas não têm 6003 nem 6000.
Junto com os nós e os serviços, o vStack Center exibe o estado da máquina de gerenciamento: seus sistemas de arquivos, a carga de CPU e a memória. Esse é o próprio plano de controle, e não um nó do cluster — mantenha os dois bem distintos.
Recursos controlados por flags
Alguns recursos nem sempre estão disponíveis. As opções do cluster contêm flags como
feature.*, e um recurso controlado por flag fica indisponível quando esse flag está
desativado — inclusive para o papel Cluster master. Verifique o flag com antecedência:
isso exige menos esforço do que diagnosticar uma solicitação rejeitada.
| Flag | O que ativa |
|---|---|
feature.hardware_inventory | Inventário de hardware dos nós e utilização de núcleos de CPU por nó |
feature.node_config_management | Configuração de nós: visualização e alteração de parâmetros, coleta das versões de software |
feature.physical_disc_management | Trabalho com os discos físicos dos nós |
feature.network_ports_management | Grupos de portas dos nós |
Um flag tem três valores possíveis: ativado, desativado e não definido. Trate um flag não definido como desativado.
Onde visualizar o estado
Trabalhe de cima para baixo. A tela Overview em Provider Data Center mostra quanto da capacidade do cluster está disponível e quanto está em uso, enquanto sua guia Resources detalha as mesmas informações por nó. Server Nodes mostra a lista de nós e o estado de cada nó. Storage Resources mostra os pools de armazenamento e os nós que os hospedam no momento. O cartão do nó oferece a visão mais detalhada: suas seções Software, Hardware, Disks e Perfdata mostram as versões de pacotes, o inventário, os discos e as métricas de um único nó.
Veja também
- Como visualizar os recursos do cluster — uma visão geral dos recursos do cluster e das métricas agregadas.
- Como gerenciar os nós do cluster — retirada de um nó de serviço e seu retorno, inventário e configuração.
- Como gerenciar os serviços do cluster — ativação, inicialização e parada de serviços.
Métodos de API
Operações de API abordadas nesta página: get-statusmap, cluster-totals,
cluster-overview — consulte a referência da API.