Elasticsearch:Connect to a cluster by using Cerebro

Etapa 1: Identificar o endereço IP a ser adicionado

Etapa 2: Adicionar o endereço IP à lista de permissões

1. Faça login no console do Elasticsearch e acesse a página Basic Information do seu cluster. No painel de navegação, escolha Configuration and Management > Security Settings.

2. Clique em Modify para abrir a caixa de diálogo da lista de permissões.

   

3. Clique em Configure à direita do grupo padrão e adicione seus endereços IP.

   • Separe vários endereços IP ou blocos CIDR com vírgulas, sem espaços antes ou depois.

   • Um único cluster suporta até 300 endereços IP ou blocos CIDR.

   • Para criar um grupo separado, clique em Add IP Whitelist Group. Os grupos servem apenas para organizar os endereços IP; todos os IPs de todos os grupos compartilham as mesmas permissões de acesso.

   Importante

   Não defina a lista de permissões como 0.0.0.0/0 ou ::/0. Essas configurações permitem acesso de qualquer endereço IP e representam um risco significativo à segurança. Algumas versões de cluster (como 7.16 e 8.5) e regiões não suportam esses valores. O suporte a listas de permissões IPv6 limita-se a clusters que usam a arquitetura de implantação v2 na região China (Hangzhou).

   Formatos suportados:

   Tipo	Formato	Exemplo
   Endereço único IPv4	A.B.C.D	192.168.0.1
   Bloco CIDR IPv4	A.B.C.D/N	192.168.0.0/24
   Negar tudo IPv4	—	127.0.0.1
   Permitir tudo IPv4 (alto risco)	—	0.0.0.0/0
   Endereço único IPv6	—	2401:XXXX:1000:24::5
   Bloco CIDR IPv6	—	2401:XXXX:1000::/48
   Negar tudo IPv6	—	::1
   Permitir tudo IPv6 (alto risco)	—	::/0

   

4. Clique em Confirm.

   

1. Instalar e configurar o Cerebro

Conecte-se à sua instância ECS. As etapas a seguir usam um sistema Linux. Consulte Conectar-se a uma instância ECS para obter instruções de conexão.

1. Instale o JDK 1.8 ou superior na instância ECS. Consulte Implantar manualmente o OpenJDK.

2. Baixe e extraia o pacote do Cerebro.

   Este exemplo usa a versão v0.9.0. Para usar a versão mais recente, verifique Cerebro releases e atualize a URL de download adequadamente.

   # Download Cerebro v0.9.0
   wget https://github.com/lmenezes/cerebro/releases/download/v0.9.0/cerebro-0.9.0.tgz
   
   # Extract the package
   tar -zxvf cerebro-0.9.0.tgz

3. Abra o arquivo de configuração do Cerebro.

   vim cerebro-0.9.0/conf/application.conf

4. Configure o parâmetro hosts para direcionar o Cerebro ao seu cluster Elasticsearch e salve o arquivo.

   Para conectar o Cerebro a múltiplos clusters, adicione várias entradas ao array hosts , separadas por vírgulas.

   Parâmetro	Descrição
   host	O endpoint do cluster. Use http://<VPC private endpoint>:9200 para acesso privado ou http://<public endpoint>:9200 para acesso público. Clusters ES têm HTTP habilitado por padrão. Para criptografar o tráfego, ative HTTPS em Configuration and Management > Security Settings. Antes de ativar HTTPS, atualize o código da sua aplicação para suportar conexões HTTPS, pois códigos existentes baseados em HTTP deixarão de funcionar.
   name	O ID do seu cluster Elasticsearch. Encontre-o na lista de clusters no console do Elasticsearch.
   username	O nome de usuário do cluster. O padrão é elastic, que possui permissões totais no cluster. Em ambientes de produção, crie usuários dedicados com permissões restritas usando o Gerenciamento de funções do Elasticsearch X-Pack.
   password	A senha do usuário especificado.

   

2. Iniciar o serviço do Cerebro

Iniciar em primeiro plano (para depuração):

cd cerebro-0.9.0
bin/cerebro

Quando o Cerebro for iniciado com sucesso, o terminal exibirá uma mensagem de confirmação.

Iniciar em segundo plano (para ambientes de produção):

cd cerebro-0.9.0
nohup bin/cerebro > cerebro.log 2>&1 &

Para visualizar logs: tail -f cerebro.log

Para parar o serviço: pkill -f cerebro

3. Abrir o Cerebro no navegador e conectar-se ao cluster

1. No grupo de segurança do ECS, abra a porta 9000 para tráfego de entrada proveniente do endereço IP do dispositivo que acessará o Cerebro. Consulte Adicionar uma regra de grupo de segurança para obter as etapas.

   

2. No navegador, acesse http://<Public IP address of the ECS instance>:9000.

3. Na página de login do Cerebro, os clusters configurados em application.conf aparecerão. Clique em um cluster para conectar-se.

   

4. Após a conexão, o console do Cerebro exibe a integridade do cluster, índices e outras opções de gerenciamento.

   

Para mais informações sobre o uso do Cerebro, consulte a documentação do Cerebro.

Falha ao iniciar o Cerebro

Verifique os seguintes pontos:

• JDK não instalado ou versão anterior a 1.8. Execute java -version para verificar. Caso a versão seja inferior a 1.8, instale um JDK compatível.

• Porta 9000 já está em uso. Altere a porta definindo http.port com um valor diferente em application.conf.

• O script de inicialização não tem permissões de execução. Execute chmod +x bin/cerebro para adicioná-las.

Falha ao conectar-se ao cluster Elasticsearch

Analise as seguintes possibilidades:

• Lista de permissões de endereços IP não configurada. Confirme se o endereço IP do host do Cerebro foi adicionado à lista de permissões correta (privada da VPC ou pública) no console do Elasticsearch.

• Endpoint ou porta incorretos na configuração. Verifique se o valor de host em application.conf corresponde ao endpoint do cluster e utiliza a porta 9200.

• Grupo de segurança do ECS bloqueando tráfego. Certifique-se de que o grupo de segurança permite tráfego de entrada nas portas 9200 (Elasticsearch) e 9000 (Cerebro).

• Nome de usuário ou senha incorretos. Valide se as credenciais em application.conf estão corretas.