Instalação de cluster Elasticsearch (3+ nodes, TLS, Kibana)

Cria do zero um cluster Elasticsearch 8.x / 9.x com 3 ou mais nodes: repositório da Elastic, heap dimensionado conforme a RAM, memory lock, vm.max_map_count, segurança automática no primeiro node (TLS + senha do elastic), entrada dos demais nodes com enrollment token, papéis master/data combinados ou separados, instalação e enrollment do Kibana, repositório de snapshot compartilhado e política SLM noturna. O resultado é um cluster green, protegido por TLS e senha, com Kibana e snapshot toda noite. A operação diária do cluster instalado (shards, disco, adição/remoção de nodes), o hardening de segurança, snapshot/restore e o upgrade de versão estão em guias Elasticsearch separados.

Topologia: 3+ nodes Elasticsearch (+ servidor Kibana opcional)

Antes de começar

• Todos os servidores estão na mesma versão de sistema operacional, suportada e atualizada. Relógios sincronizados (chrony): com diferença de horário, certificados TLS e tokens podem ser considerados inválidos.
• Cada node tem … GB de RAM (o heap será … MB) e no mínimo 2 CPUs. O Elasticsearch traz o próprio JDK; não instale Java à parte.
• Há espaço livre suficiente em … (com o disco 85% cheio nenhum shard novo é alocado ao data node; a 90% os shards começam a ser movidos para outros nodes). Recomenda-se SSD.
• Hostnames e IPs fixos: ……=……, ………, …=……. Liberadas: 9300 (transport) entre os nodes, 9200 (HTTPS) dos clientes para os nodes…, 5601 dos usuários para o Kibana….
• Os servidores acessam artifacts.elastic.co via HTTPS (ou há um mirror interno configurado). Depois de adicionar o repositório, o comando abaixo lista as versões disponíveis.
• Não há instalação antiga do Elasticsearch nem diretório de dados nos servidores (dados de um cluster antigo impedem que o node entre no cluster novo).
• … está montado a partir do mesmo compartilhamento NFS em todos os master e data nodes (persistente no fstab). O usuário elasticsearch precisa de permissão de escrita no compartilhamento: se o UID do usuário não for o mesmo em todos os nodes, use all_squash,anonuid=… no lado do NFS ou iguale os UIDs.
• Acesso root/sudo, janela de manutenção e snapshot dos servidores prontos. Os enrollment tokens valem 30 minutos; execute sem pausa os passos que fazem os demais nodes entrarem.

Fases do guia

• Preparação do sistema operacional — Configurar o hostname · Configurar o hostname (Kibana) · Configurar a resolução de nomes (/etc/hosts) · Instalar as ferramentas básicas e sincronizar o relógio · Gravar as configurações do kernel (vm.max_map_count) · Aplicar as configurações do sysctl …
• Repositório Elastic e instalação do software — Importar a chave GPG da Elastic · Definir o repositório da Elastic · Definir o repositório da Elastic · Listar as versões disponíveis · Instalar o Elasticsearch · Travar a versão
• Heap, trava de memória e diretórios — Definir o tamanho do heap · Ajustar a propriedade do arquivo (heap.options) · Permitir o travamento de memória no systemd · Recarregar o systemd · Preparar o diretório de dados · Ajustar as permissões do diretório de snapshot
• Primeiro node: inicializar o cluster — Gravar o arquivo elasticsearch.yml (node 1) · Ajustar a propriedade do arquivo (elasticsearch.yml) · Iniciar o serviço (node 1) · Definir a senha do usuário elastic · Criar um arquivo temporário de credenciais para acesso à API · Verificar o estado do cluster (node único) …
• Concluir a formação do cluster — Verificar se todos os nodes entraram · Remover a linha cluster.initial_master_nodes · Converter o node 1 em master dedicado: esvaziar os shards · Mudar o papel do node 1 para master e limpar o diretório de dados · Remover a regra temporária de allocation
• Verificação — Verificar a saúde do cluster · Verificar a trava de memória e o heap · Verificar a eleição de master e a configuração de votação · Verificar a distribuição de shards com um index de teste · Verificar o arquivo de log
• Instalação e enrollment do Kibana — Instalar o Kibana · Definir o endereço de escuta · Criar o enrollment token do Kibana · Conectar o Kibana ao cluster (kibana-setup) · Conectar o Kibana a vários nodes · Gerar as chaves de criptografia …
• Repositório de snapshot — Registrar e validar o repositório · Definir a política de snapshot noturna (SLM)
• Pós-instalação — Criar o usuário e a role da aplicação · Preparar o certificado da CA para os clientes · Aplicar o checklist de monitoramento e backup · Excluir o arquivo temporário de credenciais