Elasticsearch

O que dá errado ao fazer upgrade do Elasticsearch atravessando várias versões major?

Scott Sternloff

Por Scott Sternloff, Arquiteto corporativo sênior

LinkedIn · Atualizado em

6.xSTALLED7.x8.xTARGETIntermediate Hop RequiredMulti-Version Upgrade Planning
Nesta página

Upgrades do Elasticsearch têm fama de ser mais arriscados e exigentes do ponto de vista operacional do que parecem à primeira vista, e as evidências reais confirmam isso. Em um caso documentado, um upgrade do Elasticsearch ficou parado por 18 meses, muito além do cronograma original, por causa de requisitos de releases intermediárias e de uma sobrecarga operacional contínua que não haviam sido totalmente considerados no início.

Este artigo mostra o que realmente faz os upgrades do Elasticsearch travarem e como planejar um que não trave.

Por que upgrades do Elasticsearch travam com tanta frequência em comparação com outros upgrades de infraestrutura?

Por dois fatores estruturais, ambos presentes de forma direta em um caso real de upgrade parado:

  • Requisitos de versões intermediárias. Como muitos sistemas distribuídos maduros, o Elasticsearch nem sempre permite pular diretamente de uma versão major antiga para a atual: muitas vezes são necessárias etapas intermediárias de upgrade, e cada etapa exige sua própria validação, seus próprios testes e (muitas vezes) uma janela de manutenção. Um caso real identificou especificamente os requisitos de releases intermediárias do upgrade do Elasticsearch como um ponto de discussão em aberto no meio do upgrade. Ou seja, a equipe descobriu no meio do caminho que o percurso não era um salto único, uma lacuna de planejamento comum e evitável quando o caminho completo de versões é mapeado antes de o trabalho começar.
  • Disponibilidade de recursos e priorização. Upgrades que não são estritamente obrigatórios (sem um EOL iminente impondo o cronograma) são os primeiros a perder prioridade quando outras demandas disputam o mesmo tempo da engenharia. No caso do upgrade parado, a licença médica prolongada de um membro da equipe foi apontada como um fator que contribuiu diretamente para o atraso, o que mostra como a margem de recursos costuma ser apertada em projetos de upgrade de infraestrutura sem um prazo externo rígido.

O que verificar antes de começar um upgrade do Elasticsearch que atravessa várias versões?

  • Mapeie primeiro o caminho completo de versões, e não apenas as versões de origem e de destino. Confirme se o upgrade pretendido exige paradas intermediárias e trate cada versão intermediária como um ponto de validação próprio, em vez de supor que todo o salto pode ser planejado e executado como um único projeto contínuo.
  • Confirme a compatibilidade de clientes e aplicações em cada versão intermediária, e não apenas no destino final. Uma aplicação construída sobre uma biblioteca cliente mais antiga do Elasticsearch pode se comportar de outro jeito (ou simplesmente falhar) diante da API de uma versão intermediária, mesmo que no fim seja compatível com o destino final.
  • Considere o tempo e o custo de recursos da reindexação. Upgrades de versão major no Elasticsearch costumam exigir a reindexação dos dados em novos formatos de índice. Em índices grandes, essa não é uma operação rápida: ela consome bastante CPU, memória e I/O de disco e precisa ser agendada e ter recursos alocados como uma fase própria do projeto, e não tratada como um passo incidental.
  • Defina um responsável dedicado, com tempo protegido, e não uma atribuição em tempo parcial competindo com outras prioridades. O caso parado por 18 meses ilustra bem o que acontece quando a responsabilidade pelo upgrade não é protegida: o projeto não fracassa de forma dramática, ele simplesmente deixa de avançar, sem alarde.

Que sobrecarga operacional um upgrade de versão major realmente traz além do próprio upgrade?

Upgrades do Elasticsearch costumam trazer à tona problemas latentes na configuração do cluster, no gerenciamento de índices e no monitoramento, que não bloqueavam nada na versão antiga, mas ficam visíveis ou passam a causar problemas na nova. Reserve tempo para:

  • Validação das políticas de index lifecycle management (ILM): configurações que funcionavam com os padrões da versão antiga podem se comportar de outro jeito com os padrões da nova versão
  • Compatibilidade de plugins e integrações: qualquer integração com Logstash, Kibana ou ferramentas de terceiros atrelada a uma versão específica do Elasticsearch precisa de sua própria verificação de compatibilidade
  • Mudanças no monitoramento da saúde do cluster: às vezes, novas versões mudam o que significa "saudável" no nível da API, o que pode quebrar regras de alerta existentes que pressupunham a semântica de status da versão antiga

Devo fazer o upgrade in-place ou subir um novo cluster e migrar?

As duas opções são válidas, e a escolha certa depende de quanto risco operacional a estabilidade do seu cluster atual tolera e de quanto orçamento de infraestrutura você tem disponível para uma implantação paralela.

  • O rolling upgrade in-place costuma ser mais rápido de executar em clusters menores e não exige infraestrutura duplicada, mas coloca o cluster de produção diretamente no caminho do upgrade, com menos margem para um rollback limpo se algo der errado no meio do processo.
  • O cluster paralelo com reindexação e cutover oferece um ponto de rollback limpo (o cluster antigo continua rodando até você ter confiança no novo), ao custo de manter infraestrutura duplicada por um tempo e de precisar de uma estratégia de sincronização de dados ou de reindexação para manter o novo cluster atualizado até o cutover.

Especificamente em um salto de várias versões major, em que a compatibilidade das versões intermediárias já é um risco conhecido, como no caso parado citado acima, o cluster paralelo costuma ser a opção mais segura, porque isola totalmente o risco do upgrade do tráfego de produção até você estar pronto para o cutover.

Metas de resposta a partir de 15 minutos, conforme o plano. Engenheiros sêniores designados.

Fale conosco

Como evitar que o upgrade do Elasticsearch vire um projeto parado por 18 meses?

  • Defina o escopo de todo o caminho de versões logo no início, incluindo cada parada intermediária, antes de se comprometer com um cronograma. Não descubra requisitos intermediários no meio do projeto.
  • Designe um responsável dedicado, com tempo protegido, em vez de tratar o upgrade como trabalho de segundo plano para alguém que já está sobrecarregado com outras responsabilidades. Se esse responsável ficar indisponível (doença, mudança de função, saída da empresa), tenha um plano explícito de como o projeto continua, em vez de deixá-lo parar sem alarde.
  • Estabeleça um prazo rígido atrelado a um fator real de pressão sempre que possível (uma data de EOL se aproximando, um requisito de segurança ou uma dependência de outro projeto), já que os upgrades sem prazo externo são os que mais tendem a perder prioridade indefinidamente.
  • Reserve de forma explícita o tempo de reindexação e validação, e não apenas o das etapas mecânicas do upgrade, porque normalmente é aí que está o custo real de tempo em um salto de versão major.

E se o upgrade do Elasticsearch já estiver parado?

Recomece com uma nova rodada de definição de escopo, em vez de retomar de onde parou. Confirme que o cenário de versões não mudou desde que o projeto travou (novos requisitos intermediários, novas datas de EOL, mudanças na compatibilidade das suas integrações), redefina claramente o responsável e estabeleça um cronograma concreto e com recursos alocados antes de retomar a execução. Um upgrade parado que é retomado sem redefinir o escopo tende a travar de novo pelos mesmos motivos de fundo.

Para entender como planejar um upgrade de versão major de infraestrutura sem downtime, veja Upgrade do RabbitMQ 3.x para 4.x sem downtime: os trade-offs entre rolling upgrade e cluster paralelo se aplicam diretamente.

Conte com ajuda em um upgrade do Elasticsearch parado ou planejado

Está lidando com um upgrade de versão major do Elasticsearch parado ou prestes a começar? A AceMQ faz avaliações do caminho de versões que mapeiam cada salto intermediário, validam a compatibilidade de clientes e plugins e dimensionam o tempo de reindexação antes de você se comprometer com um cronograma. Contrate o suporte para Elasticsearch ou fale com um engenheiro da AceMQ sobre o seu caminho de upgrade.

Perguntas frequentes

Por que upgrades do Elasticsearch travam com mais frequência do que outros upgrades de infraestrutura?

Dois fatores estruturais explicam isso: os requisitos de versões intermediárias, que obrigam a seguir caminhos de upgrade em várias etapas, cada uma com sua própria validação e janela de manutenção, e a escassez de recursos, já que upgrades sem um prazo de EOL rígido são os primeiros a perder prioridade quando outros projetos disputam o tempo da engenharia. Um caso real mostrou as duas coisas: um requisito de versão intermediária que ninguém havia identificado e a licença médica de um membro da equipe, juntos, deixaram o projeto parado por 18 meses.

O que verificar antes de começar um upgrade do Elasticsearch que atravessa várias versões?

Mapeie primeiro o caminho completo de versões, incluindo cada parada intermediária, e não apenas as versões de origem e de destino. Confirme a compatibilidade de clientes e aplicações em cada versão intermediária, considere de forma explícita o tempo e o custo de recursos da reindexação e designe um responsável dedicado, com tempo protegido, em vez de tratar o upgrade como trabalho de segundo plano.

Que sobrecarga operacional um upgrade de versão major do Elasticsearch traz além do próprio upgrade?

Reserve tempo para validar as políticas de index lifecycle management (ILM), já que os padrões da versão antiga podem se comportar de outro jeito na nova; para checar a compatibilidade de plugins e integrações com Logstash, Kibana e ferramentas de terceiros atreladas a uma versão específica; e para ajustar o monitoramento da saúde do cluster, já que novas versões podem mudar o que significa "saudável" no nível da API e quebrar regras de alerta existentes.

Devo fazer o upgrade do Elasticsearch in-place ou subir um novo cluster e migrar?

As duas abordagens são válidas. Rolling upgrades in-place são mais rápidos em clusters menores, mas colocam a produção diretamente no caminho do upgrade, com menos margem para rollback. Um cluster paralelo com reindexação e cutover custa infraestrutura duplicada por um tempo, mas oferece um ponto de rollback limpo. Especificamente em saltos de várias versões major, nos quais a compatibilidade intermediária já é um risco conhecido, o cluster paralelo costuma ser a opção mais segura.

Como evitar que o upgrade do Elasticsearch vire um projeto parado por 18 meses?

Defina o escopo de todo o caminho de versões logo no início, incluindo cada parada intermediária, antes de se comprometer com um cronograma. Designe um responsável dedicado, com tempo protegido e um plano explícito de continuidade caso essa pessoa fique indisponível. Estabeleça um prazo rígido atrelado a um fator real de pressão e reserve de forma explícita o tempo de reindexação e validação, em vez de embuti-lo nas etapas mecânicas do upgrade.

O que fazer se o upgrade do Elasticsearch já estiver parado?

Recomece com uma nova rodada de definição de escopo, em vez de retomar de onde parou. Confirme que o cenário de versões não mudou desde que o projeto travou (novos requisitos intermediários, novas datas de EOL, mudanças na compatibilidade das integrações), redefina claramente o responsável e estabeleça um cronograma concreto e com recursos alocados antes de retomar a execução.

Um upgrade do Elasticsearch parado raramente é um beco sem saída técnico: quase sempre é uma lacuna de escopo e de responsabilidade. Mapeie todo o caminho de versões, proteja o tempo do responsável e defina um prazo real antes de retomar.

Consulta gratuita

Um olhar especializado sobre seu cluster Elasticsearch

Seja para resolver um incidente em produção, planejar uma migração ou ter uma segunda opinião sobre sua arquitetura, nossa equipe está pronta. Sem discurso de vendas, só respostas.

Envie um e-mail