As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Atualizando a Amazon OpenSearch Domínios de serviço
OpenSearch e as atualizações de versão do Elasticsearch diferem das atualizações do software de serviço. Para obter informações sobre como atualizar o software de serviço para seu OpenSearch Domínio do serviço, consulte Atualizações do software de serviço no Amazon OpenSearch Service.
Amazônia OpenSearch O serviço oferece duas maneiras de atualizar um domínio: uma atualização no local e uma atualização baseada em clones. Se você usa serviços como Amazon Data Firehose ou Amazon CloudWatch Registros para transmitir dados para OpenSearch Serviço, verifique se esses serviços oferecem suporte à versão mais recente do OpenSearch antes de migrar.
Métodos e termos de atualização
Um atualização no local atualiza o cluster existente do seu domínio para a nova versão. Funciona como um blue/green implantação. Você não pode pausar, cancelar ou reverter uma atualização no local. Ele está disponível para domínios executados OpenSearch 1.0 ou posterior, ou Elasticsearch 5.1 ou posterior.
UM atualização baseada em clones cria um cluster clonado do seu domínio na versão de destino e o mantém sincronizado com seus dados enquanto seu domínio continua fornecendo tráfego do cluster primário. É um blue/green implantação na qual o cluster clonado é o ambiente verde, mantido isolado para que você possa validá-lo antes de substituí-lo. Você valida o cluster clonado e depois passa para ele quando estiver pronto. Você pode cancelar antes da transferência e reverter depois dela. Uma atualização baseada em clones está disponível para domínios que executam o Elasticsearch 7.10 ou OpenSearch 1.1 ou posterior em todos AWS Regiões comerciais onde a Amazon OpenSearch O serviço está disponível, exceto Ásia-Pacífico (Nova Zelândia), Ásia-Pacífico (Taipei), Ásia-Pacífico (Tailândia) e México (Central). Para obter uma lista completa das regiões, consulte o AWS Tabela de regiões
Os termos a seguir descrevem uma atualização baseada em clones.
- Cluster primário
-
O cluster em que seu domínio é executado quando a atualização começa, na versão anterior. Ele continua atendendo ao tráfego até você parar. Após a transição, OpenSearch O serviço o mantém somente pelo período de retenção definido, para que você possa revertê-lo.
- Cluster clonado
-
O novo cluster que OpenSearch O serviço é criado na versão de destino. Ele recebe uma cópia dos seus dados e permanece sincronizado com o cluster primário.
- Validar
-
Teste o cluster clonado com suas próprias solicitações de leitura antes de cortá-lo. Você pode validar somente leituras.
- substituição
-
A etapa que move o tráfego do seu domínio do cluster primário para o cluster clonado. As gravações são bloqueadas durante a transição.
- Cancelar
-
Pare a atualização antes da transição. OpenSearch O serviço exclui o cluster clonado e seu domínio permanece como estava.
- Reverter
-
Retorne ao cluster primário após a transferência, durante o período de retenção.
- Período de retenção
-
Quanto tempo OpenSearch O serviço mantém o cluster primário após a transferência para que você possa reverter. O período começa quando a transição é concluída. Se você não definir um período de retenção, OpenSearch O serviço exclui o cluster primário imediatamente após a transferência.
Escolha um método de atualização
A tabela a seguir compara os dois tipos de upgrade.
| In-place atualizar | Clone-based atualizar | |
|---|---|---|
| Como funciona | Atualiza o cluster existente. Funciona como um blue/green implantação. | UM blue/green implantação na qual o cluster clonado é o ambiente verde. Ele é criado na versão de destino, mantido em sincronia com seus dados e mantido isolado para que você possa validá-lo. Você decide quando cortar. |
| Disponível para | OpenSearch 1.0 ou posterior, ou Elasticsearch 5.1 ou posterior. | Elasticsearch 7.10 ou OpenSearch 1.1 ou posterior. |
| Experimente a versão atualizada antes que ela entre em vigor | Não. As verificações de pré-atualização são executadas, mas o cluster atualizado assume o controle assim que a atualização é concluída. | Sim. Experimente o cluster clonado com suas próprias solicitações enquanto seu domínio continua fornecendo tráfego. |
| Cancelar um upgrade | Não. | Sim. Você pode cancelar a qualquer momento antes da transição. |
| Reverter | Não. Para retornar à versão anterior, restaure um instantâneo em um novo domínio. | Sim. Após a transferência, você pode reverter durante o período de retenção definido. |
| Escreve durante a atualização | O desempenho de gravação pode diminuir durante a atualização. | As gravações no cluster primário não são afetadas durante a execução da atualização. As gravações são bloqueadas até que a transferência seja concluída. |
Para obter informações sobre cobranças, consulte Cobranças por upgrades.
Antes da atualização
Antes de iniciar qualquer tipo de upgrade:
-
Crie um snapshot manual do seu domínio. Esse instantâneo serve como um backup que você pode: restaurar em um novo domínio se você quiser voltar a usar o anterior OpenSearch versão.
-
Verifique Caminhos de atualização com suporte para suas versões atual e de destino. Uma atualização baseada em clones está disponível somente para domínios que executam o Elasticsearch 7.10 ou OpenSearch 1.1 ou posterior.
-
Execute a verificação de pré-atualização para encontrar problemas que possam bloquear a atualização. As mesmas verificações são executadas para os dois tipos de atualização. Para obter mais informações, consulte Solução de problemas de falha de validação.
-
Se seus domínios usarem recuperação gerenciada de desastres, atualize primeiro o domínio secundário e, por último, o domínio primário. Antes de uma atualização baseada em clones, remova a relação de replicação. Para obter mais informações, consulte Atualize domínios que usam DR..
Caminhos de atualização com suporte
Atualmente, OpenSearch O serviço oferece suporte aos seguintes caminhos de atualização:
Cada caminho na tabela a seguir está disponível para um upgrade no local.
| Da versão | Para a versão |
|---|---|
| OpenSearch 1,3, 2.x, ou 3.x |
OpenSearch 3.x Se você estiver correndo OpenSearch 1.3 ou 2.x, você deve primeiro atualizar para OpenSearch 2,19 antes atualizando para OpenSearch 3.x. Ao fazer o upgrade do OpenSearch 2.19 a OpenSearch 3.x, talvez seja necessário resolver as seguintes configurações de índice incompatíveis. Elas se tornaram obsoletas na versão 2.x e causarão uma falha na validação da verificação de atualização se não forem removidas.
Para saber mais sobre configurações de índice obsoletas e etapas para corrigi-las, consulte Configurações de índice Se seu domínio contiver índices criados em OpenSearch 1.3, Elasticsearch 7.10 ou versões anteriores, você deve reindexá-las antes de fazer o upgrade para OpenSearch 3.x. OpenSearch O 3.x não suporta esses índices mais antigos, independentemente de estarem em alta, UltraWarm, ou armazenamento refrigerado. Para reindexar incompatíveis UltraWarm ou índices frios:
Como alternativa, exclua os índices se não precisar mais deles. Instantâneos tirados em OpenSearch 1.x e no Elasticsearch 7.10 e versões anteriores são incompatíveis com OpenSearch 3.x. Para repositórios manuais de instantâneos, exclua esses instantâneos incompatíveis antes de fazer o upgrade para OpenSearch 3.x. |
| OpenSearch 1.3 ou 2.x |
OpenSearch 2.x OpenSearch O 2.17 habilitará a pesquisa simultânea de segmentos por padrão com o modo automático se o domínio atender às seguintes condições:
A versão 2.3 tem as seguintes alterações importantes:
|
| OpenSearch 1.x | OpenSearch 1.x |
| Elasticsearch 7.x |
Elasticsearch 7.x ou OpenSearch 1.x Importante OpenSearch 1.x introduz inúmeras mudanças significativas. Para obter detalhes, consulte Renomeação do Amazon OpenSearch Service - Resumo das alterações. |
|
Elasticsearch 6.8 |
Elasticsearch 7.x ou OpenSearch 1.x Importante Elasticsearch 7.0 e OpenSearch 1.0 inclui várias mudanças significativas. Antes de iniciar uma atualização no local, recomendamos tirando um instantâneo manual dos 6.x domínio, restaurando-o em um teste 7.x ou OpenSearch 1.x domínio e usando esse domínio de teste para identificar possíveis problemas de atualização. Para alterações significativas em OpenSearch 1.0, consulte Renomeação do Amazon OpenSearch Service - Resumo das alterações. Assim como o Elasticsearch 6.x, os índices só podem conter um tipo de mapeamento, mas esse tipo agora deve ser chamado de Para novos índices, o Elasticsearch 7 é auto-hospedado.x e OpenSearch 1.x tenha uma contagem de fragmentos padrão de um. OpenSearch Domínios de serviço no Elasticsearch 7.x e depois manter o padrão anterior de cinco. |
Elasticsearch 6.x |
Elasticsearch 6.x |
| Elasticsearch 5.6 |
Elasticsearch 6.x Importante Os índices criados na versão 6.x não são mais compatíveis com vários tipos de mapeamento. Índices criados na versão 5.x ainda são compatíveis com vários tipos de mapeamento quando restaurados em um cluster 6.x. Verifique se o seu código de cliente cria apenas um único tipo de mapeamento por índice. Para minimizar o tempo de inatividade durante a atualização do Elasticsearch 5.6 para 6.x, OpenSearch O serviço reindexa o |
| Elasticsearch 5.x | Elasticsearch 5.x |
Uma atualização baseada em clones está disponível para os seguintes caminhos de atualização:
-
Elasticsearch 7.10 a OpenSearch 1.3
-
OpenSearch 1,1 a 1,3
-
OpenSearch 1,3 a 2,19
-
OpenSearch 2.x para 2,19
-
OpenSearch 2,19 a 3.x
Para outros caminhos de upgrade, use um upgrade no local.
Como funciona uma atualização no local
Uma atualização no local consiste em três etapas:
-
Pre-upgrade cheques — OpenSearch O serviço verifica se há problemas que possam bloquear uma atualização e não prossegue para a próxima etapa, a menos que essas verificações sejam bem-sucedidas.
-
Instantâneo — OpenSearch O serviço tira um instantâneo do OpenSearch ou cluster Elasticsearch e não prossegue para a próxima etapa, a menos que o snapshot seja bem-sucedido. Se a atualização falhar, OpenSearch O serviço usa esse instantâneo para restaurar o cluster ao seu estado original. Para obter mais informações, consulte Não é possível reverter para a versão anterior após a atualização..
-
Atualizar — OpenSearch O serviço inicia a atualização, que pode levar de 15 minutos a várias horas para ser concluída. OpenSearch Os painéis podem não estar disponíveis durante parte ou toda a atualização.
Como funciona uma atualização baseada em clones
Uma atualização baseada em clones consiste nas seguintes etapas:
-
Pre-upgrade cheques — OpenSearch O serviço executa as mesmas verificações de uma atualização local e não prossegue a menos que seja bem-sucedida.
-
Instantâneo — OpenSearch O serviço tira um instantâneo do seu domínio e não prossegue, a menos que o instantâneo seja bem-sucedido.
-
Criação de cluster clonado — OpenSearch O serviço cria um cluster clonado do seu domínio na versão de destino e copia seus dados para ele. Seu domínio continua servindo leituras e gravações do cluster primário, e o cluster clonado permanece sincronizado com seus dados.
-
Validação — Quando o cluster clonado estiver pronto, a atualização espera por você. Valide o cluster clonado e, opcionalmente, envie uma parte do tráfego de leitura para ele.
-
Transferência — Quando você corta, OpenSearch O serviço bloqueia a gravação até que a transferência seja concluída. Durante esse tempo, o cluster clonado se atualiza e, em seguida OpenSearch O serviço move o tráfego para ele. Seu endpoint de domínio não muda.
-
Período de retenção (opcional) — OpenSearch O serviço mantém o cluster primário pelo período de retenção definido, para que você possa revertê-lo. O período começa quando a transição é concluída. Se você não definir um período de retenção, OpenSearch O serviço exclui o cluster primário imediatamente após a transferência.
Você pode cancelar o upgrade a qualquer momento antes da transição. OpenSearch Em seguida, o serviço exclui o cluster clonado e seu domínio permanece como estava. Para obter informações sobre validação, redução, cancelamento e reversão, consulte Validando, cortando e revertendo durante uma atualização baseada em clones.
Limitações de uma atualização baseada em clones
Uma atualização baseada em clones tem as seguintes limitações:
-
Seu domínio deve executar o Elasticsearch 7.10 ou OpenSearch 1.1 ou posterior. Se seu domínio executar uma versão anterior, use uma atualização local para acessar primeiro uma versão compatível.
-
Domínios que usam OpenSearch Instâncias otimizadas (OR1 ou OR2) não são suportadas.
-
Domínios que usam UltraWarm instâncias não são suportadas.
-
Não há suporte para domínios que usam replicação entre clusters.
-
Se seu domínio usa recuperação gerenciada de desastres, remova a relação de replicação antes de iniciar uma atualização baseada em clones e configure a recuperação de desastres novamente depois. Para obter mais informações, consulte Atualize domínios que usam DR..
-
Domínios com pacotes de plug-ins personalizados ou de terceiros associados não são suportados.
-
Domínios que usam autenticação SAML para OpenSearch Não há suporte para painéis.
-
Domínios que usam a autenticação do Amazon Cognito para OpenSearch Não há suporte para painéis.
-
Você não pode alterar a configuração do domínio durante a atualização.
Cobranças por upgrades
Um upgrade no local não incorre em custos adicionais. No caso de um upgrade baseado em clones, o preço padrão será aplicado às instâncias e ao armazenamento do clone, como qualquer outro nó em seu domínio. Você é cobrado pelo cluster primário e pelo clone enquanto valida o clone. Se você mantiver o cluster primário para reversão, será cobrado por ambos até o término do período de retenção.
Solução de problemas de falha de validação
Quando você inicia um OpenSearch ou atualização da versão do Elasticsearch, OpenSearch Primeiro, o serviço realiza uma série de verificações de validação para garantir que seu domínio esteja qualificado para um upgrade. Se alguma dessas verificações falhar, você receberá uma notificação no console contendo os problemas específicos que deverão ser corrigidos antes da atualização do domínio. Para obter uma lista de possíveis problemas e as etapas para resolvê-los, consulte Solução de problemas de erros de validação.
Solução de problemas em uma atualização
As atualizações exigem domínios saudáveis. Seu domínio pode não estar qualificado para uma atualização ou não ser atualizado por vários motivos. A tabela a seguir mostra os problemas mais comuns.
| Problema | Description |
|---|---|
| Plug-in opcional não compatível |
Quando você atualiza um domínio com plug-ins opcionais, OpenSearch O serviço também atualiza automaticamente os plug-ins. Portanto, a versão de destino do seu domínio também deve oferecer suporte a esses plug-ins opcionais. Se o domínio tiver um plug-in opcional instalado que não esteja disponível para a versão de destino, a solicitação de upgrade falhará. |
| Muitos fragmentos por nó | OpenSearch, bem como 7.x versões do Elasticsearch têm uma configuração padrão de no máximo 1.000 fragmentos por nó. Se um nó em seu cluster atual exceder essa configuração, OpenSearch O serviço não permite que você faça o upgrade. Consulte Limite máximo de fragmentos excedido para obter opções de solução de problemas. |
| Domínio no processamento | O domínio está no meio de uma mudança de configuração. Verifique a qualificação da atualização após a conclusão da operação. |
| Status de cluster vermelho | Um ou mais índices no cluster estão vermelhos. Para obter etapas sobre a solução de problemas, consulte Status de cluster vermelho. |
| Alta taxa de erros | O cluster está retornando um grande número de erros 5xx ao tentar processar solicitações. Geralmente, esse problema é resultado de muitas solicitações de leitura ou gravação simultâneas. Considere reduzir o tráfego para o cluster ou dimensionar seu domínio. |
| Cérebro dividido | Cérebro dividido significa que o cluster tem mais de um nó principal e foi dividido em dois clusters que nunca se juntarão por conta própria. Você pode evitar dividir o cérebro usando o número recomendado de nós principais dedicados. Para ajudar na recuperação do cérebro dividido, entre em contato com Suporte |
| Nó principal não encontrado | OpenSearch O serviço não consegue encontrar o nó principal do cluster. Se o domínio usa multi-AZ, uma falha da zona de disponibilidade pode ter causado a perda de quorum do cluster e a incapacidade de escolher um novo nó principal. Se o problema não se resolver, entre em contato com Suporte |
| Muitas tarefas pendentes | O nó principal está sob carga pesada e tem muitas tarefas pendentes. Considere reduzir o tráfego para o cluster ou dimensionar seu domínio. |
| Volume de armazenamento prejudicado | O volume de disco de um ou mais nós não está funcionando corretamente. Esse problema geralmente ocorre junto com outros problemas, como uma alta taxa de erros ou muitas tarefas pendentes. Se o problema ocorrer isoladamente e não se resolver, entre em contato com Suporte |
| Problema de chave do KMS | A chave do KMS usada para criptografar o domínio está inacessível ou ausente. Para saber mais, consulte Monitoramento de domínios que criptografam dados em repouso. |
| Snapshot em andamento | O domínio está tirando um snapshot no momento. Verifique a qualificação da atualização após a conclusão do snapshot. Além disso, verifique se é possível listar repositórios de snapshots manuais, listar snapshots nesses repositórios e obter snapshots manuais. Se OpenSearch O serviço não consegue verificar se um snapshot está em andamento; os upgrades podem falhar. |
| Tempo limite ou falha de snapshot | O snapshot de pré-atualização demorou muito para ser concluído ou falhou. Verifique o status do cluster e tente novamente. Se o problema continuar, entre em contato com o Suporte |
| Índices incompatíveis | Um ou mais índices são incompatíveis com a versão de destino. Esse problema pode ocorrer se você migrou os índices de uma versão mais antiga do OpenSearch ou Elasticsearch. Reindexe os índices e tente novamente. |
| Uso elevado do disco | O uso de disco para o cluster está acima de 90%. Exclua os dados ou dimensione o domínio e tente novamente. |
| Uso elevado do JVM | A pressão de memória JVM está acima de 75%. Reduza o tráfego para o cluster ou dimensione o domínio e tente novamente. |
| OpenSearch Problema de alias de painéis | .dashboards já está configurado como um alias e mapeia para um índice incompatível, provavelmente de uma versão anterior do OpenSearch Painéis de controle. Reindexe e tente novamente. |
| Status de painéis vermelhos | OpenSearch O status dos painéis é vermelho. Tente usar o Dashboards quando a atualização for concluída. Se o status vermelho persistir, resolva-o manualmente e tente novamente. |
| Cross-cluster compatibilidade |
Você só pode atualizar se a compatibilidade entre clusters for mantida entre os domínios de origem e de destino após a atualização. Durante o processo de atualização, todas as conexões incompatíveis são identificadas. Para prosseguir, atualize o domínio remoto ou excluir as conexões incompatíveis. Observe que, se a replicação estiver ativa no domínio, você não poderá retomá-la depois de excluir a conexão. |
| Outros OpenSearch Problema no serviço | Problemas com OpenSearch O serviço em si pode fazer com que seu domínio seja exibido como inelegível para um upgrade. Se nenhuma das condições anteriores se aplicar ao seu domínio e o problema persistir por mais de um dia, entre em contato com Suporte |