Visão geral
O Elasticsearch (ES) potencializa a funcionalidade de pesquisa em sua instância do GitHub Enterprise Server. Para trazer os benefícios de melhor desempenho e postura de segurança, quando você atualizar sua instância para a versão 3.13 ou posterior, a versão do Elasticsearch no dispositivo será atualizada da 5.6.16 para a 8.7.0.
As seções a seguir ajudam os administradores a se preparar e monitorar a atualização do Elasticsearch. Os pontos principais são:
- A atualização degradará temporariamente a experiência dos recursos de log de auditoria e de pesquisa.
- Se você estiver atualizando uma instância em uma configuração de cluster, deverá executar um script para preparar o cluster para a atualização ES. Confira Atualizar o cluster.
- Para backups, todos os clientes devem capturar um instantâneo da sua instância quando a atualização for concluída.
Impacto nos logs de auditoria e de pesquisa
Todos os índices de pesquisa serão reconstruídos após a atualização para o ES8. Os usuários perceberão uma experiência de pesquisa degradada durante a reconstrução, mas espera-se que a instância seja funcional e disponível. O processo de reconstrução do índice depende do tamanho do conjunto de dados e pode levar de algumas horas a dias.
Os logs de auditoria não estarão disponíveis imediatamente após a atualização e várias horas poderão ser necessárias para a migração de todos os logs de auditoria.
É altamente recomendável que você faça um backup (usando utilitários de backup) imediatamente após a conclusão da reconstrução do índice e use esse instantâneo para todas as restaurações futuras. Confira Como configurar backups em sua instância. Se você restaurar um backup de uma instância executando o GitHub Enterprise Server 3.11 ou 3.12, qualquer conteúdo que dependa do ES só estará disponível depois que os índices do ES tiverem sido migrados e recriados na instância 3.13.
Monitorando a atualização do Elasticsearch
Você pode monitorar o progresso da atualização do ES no painel de administração do site.
- No canto superior direito de qualquer página, clique em .
- Na barra lateral esquerda, clique em Índices de pesquisa.
Quando a reconstrução do índice estiver concluída, todos os índices de pesquisa deverão mostrar verde e "100%".
Alterar o número de trabalhadores de reparo
Por padrão, o número de trabalhadores de reparo de índice é definido como o número de núcleos de CPU dividido por 8 (com um limite superior de 8). Para acelerar a reconstrução do índice, você pode ajustar a contagem de trabalhadores. No entanto, antes de fazer isso, considere o impacto potencial para a carga.
-
Conecte-se via SSH ao sua instância do GitHub Enterprise Server. Se sua instância for composta por vários nós, por exemplo, se a alta disponibilidade ou a replicação geográfica estiver configurada, efetue SSH no nó primário. Se você usar um cluster, poderá efetuar SSH em qualquer nó. Substitua HOSTNAME pelo nome do host da instância ou pelo nome do host ou endereço IP de um nó. Para obter mais informações, confira "Acesar o shell administrativo (SSH)".
Shell ssh -p 122 admin@HOSTNAME
ssh -p 122 admin@HOSTNAME -
Para alterar o número de trabalhadores, digite o comando a seguir.
Shell ghe-config app.github.es-workers NUMBER-OF-WORKERS
ghe-config app.github.es-workers NUMBER-OF-WORKERS -
Execute
ghe-config-apply.
Você também pode ajustar a contagem de trabalhadores para reconstruções de índices individuais na seção "Índices de pesquisa" do painel de administração do site. Confira a seção Monitorando a atualização do Elasticsearch.