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á.
Fazendo alterações de configuração no Amazon OpenSearch Service
O Amazon OpenSearch Service usa um processo de implantação azul/verde ao atualizar domínios. Uma blue/green deployment creates an idle environment for domain updates that copies the production environment, and routes users to the new environment after those updates are complete. In a blue/green implantação, o ambiente azul é o ambiente de produção atual. O ambiente verde é o ambiente inativo.
Os dados são migrados do ambiente azul para o ambiente verde. Quando o novo ambiente estiver pronto, o OpenSearch Serviço alterna os ambientes para promover o ambiente verde como o novo ambiente de produção. A transição ocorre sem perda de dados. Essa prática minimiza o tempo de inatividade e mantém o ambiente original caso a implantação no novo ambiente resulte em erro.
Alterações que normalmente causam implantações azuis/verdes
As seguintes operações causam implementações azuis/verdes:
-
Alterar o tipo de instância
-
Habilitar o controle de acesso detalhado
-
Atualizações de software de serviço
-
Habilitar ou desabilitar os nós principais dedicados
-
Ativar ou desativar o Multi-AZ sem modo de espera
-
Alterar o tipo de armazenamento, o tipo do volume ou o tamanho do volume
-
Escolha de VPC sub-redes diferentes
-
Adicionar ou remover grupos VPC de segurança
-
Ativar ou desativar a autenticação do Amazon Cognito para painéis OpenSearch
-
Escolha de outro grupo de usuários ou grupo de identidades do Amazon Cognito
-
Modificar configurações avançadas
-
Atualização para uma nova OpenSearch versão (os OpenSearch painéis podem estar indisponíveis durante parte ou toda a atualização)
-
Habilitando a criptografia de dados em repouso ou node-to-node criptografia
-
Ativando ou desativando nosso UltraWarm armazenamento a frio
-
Desabilitação do Auto-Tune e reversão de suas alterações
-
Associar um plug-in opcional a um domínio e dissociar um plug-in opcional de um domínio
-
Aumento da contagem de nós principais dedicados para domínios Multi-AZ com dois nós principais dedicados
-
Diminuindo o tamanho do EBS volume
-
Alteração do tamanho do EBS volume ou da taxa de transferência, se a última alteração feita estiver em andamento ou tiver ocorrido há menos de 6 horas IOPS
-
Habilitando a publicação de registros de auditoria para CloudWatch.
Para domínios multi-AZ com modo de espera, você só pode fazer uma solicitação de alteração por vez. Se uma alteração já estiver em andamento, a nova solicitação será rejeitada. Você pode verificar o status da alteração atual com DescribeDomainChangeProgress
API o.
Alterações que normalmente não causam implantações azuis/verdes
Na maioria dos casos, as seguintes operações não causam implantações azuis/verdes:
-
Modificar a política de acesso
-
Como modificar o endpoint personalizado
-
Alterando a política Transport Layer Security (TLS)
-
Alterar o horário do snapshot automatizado
-
Ativar ou desativar Exigir HTTPS
-
Habilitação do Auto-Tune ou desabilitação sem reverter suas alterações
-
Se seu domínio tiver nós mestres dedicados, alterando o nó de dados ou a contagem de UltraWarm nós
-
Se seu domínio tiver nós principais dedicados, altere o tipo de instância principal dedicada ou a contagem (exceto para domínios Multi-AZ com dois nós principais dedicados)
-
Ativar ou desativar a publicação de registros de erros ou registros lentos no CloudWatch
-
Desabilitando a publicação de registros de auditoria no CloudWatch
-
Aumentar o tamanho do volume em até 3 TiB por nó de dados, alterar o tipo de volume ou a taxa de IOPS transferência
-
Adicionar ou remover tags
nota
Há algumas exceções, dependendo da versão do software de serviço. Se você quiser ter certeza de que uma alteração não causará uma implantação azul/verde, execute uma simulação antes de atualizar seu domínio, se essa opção estiver disponível. Algumas mudanças não oferecem a opção de simulação. Geralmente, recomendamos que você faça alterações em seu cluster fora dos horários de pico de tráfego.
Determinar se uma alteração causará uma implantação azul/verde
É possível testar alguns tipos de alterações de configuração planejadas para determinar se elas causarão uma implantação azul/verde. Antes de iniciar uma alteração na configuração, use o console ou um API para executar uma verificação de validação para garantir que seu domínio esteja qualificado para uma atualização.
Início e acompanhamento de uma alteração de configuração
nota
Você pode solicitar uma alteração de configuração por vez. Você também pode agrupar várias alterações de configuração em uma única solicitação. Aguarde até que o status de seu domínio esteja Active
antes de solicitar qualquer alteração de configuração adicional.
Você pode visualizar os campos Domain Processing Status e Config Change Status no console do Amazon OpenSearch Service para rastrear alterações de domínio e configuração. Você também pode rastrear alterações de domínio e configuração por meio dos ConfigChangeStatus
parâmetros DomainProcessingStatus
e nas API respostas. Para obter mais informações, consulte o tipo de DomainStatusdados na API referência do OpenSearch serviço.
Visibilidade do status de processamento do domínio: você pode determinar facilmente o status da configuração de um domínio examinando o campo Status de processamento do domínio no console. Da mesma forma, o DomainProcessingStatus
API parâmetro pode ser usado para identificar o status. Os valores a seguir são status de processamento de um domínio:
-
Active
: nenhuma alteração de configuração está em andamento. Você pode enviar uma nova solicitação de alteração de configuração. -
Creating
: o domínio está sendo criado. -
Modifying
: mudanças na configuração, como adição de novos nós de dadosEBS, gp3, IOPS provisionamento ou configuração de KMS chaves, estão em andamento.nota
Você pode ver o status como
Modifying
em situações em que um domínio exige movimentação de fragmentos para concluir as alterações de configuração. Para compatibilidade com versões anteriores, o comportamento doProcessing
parâmetro é mantido inalterado nas API respostas e definido como falso assim que as alterações da configuração principal são concluídas, sem esperar pela conclusão da movimentação do fragmento. -
Upgrading Engine Version
: uma atualização da versão do mecanismo está em andamento. -
Updating Service Software
: uma atualização de software do serviço está em andamento. -
Deleting
: o domínio está sendo excluído. -
Isolated
: o domínio está suspenso.
Visibilidade do status da configuração: as alterações de configuração podem ser iniciadas pelo operador (por exemplo, adição de novo nó de dados, alteração do tipo de instância) ou pelo serviço (por exemplo, ajuste automático e atualizações fora do horário de pico). Você pode encontrar o status dos detalhes da última alteração de configuração no campo Status da alteração de configuração do console do Amazon OpenSearch Service e na ConfigChangeStatus
API resposta. Os valores a seguir indicam o status da configuração de um domínio:
-
Pending
: uma solicitação de alteração de configuração foi enviada. -
Initializing
: o serviço está inicializando uma solicitação de alteração de configuração. -
Validating
: o serviço está validando as alterações solicitadas e os recursos necessários. -
Awaiting user inputs
: aplica-se quando o operador espera que algumas alterações na configuração, como a alteração do tipo de instância, prossigam. Você pode editar as alterações de configuração. -
Applying changes
: o serviço está aplicando as alterações de configuração solicitadas. -
Cancelled
: a alteração na configuração foi cancelada. Se você receber o status de falha na validação, poderá clicar em Cancelar no console ou chamar aCancelDomainConfigChange
API operação. Se você fizer isso, todas as alterações aplicadas serão revertidas. -
Completed
: as alterações de configuração solicitadas foram concluídas com êxito. -
Validation Failed
: falha na validação das alterações solicitadas. Nenhuma alteração de configuração foi aplicada.nota
Falhas de validação podem ser o resultado de índices vermelhos presentes em seu domínio, indisponibilidade de um tipo de instância escolhido ou pouco espaço em disco. Para obter uma lista de erros de validação, consulte Solução de problemas de erros de validação. Durante um evento de falha na validação, você pode cancelar, tentar novamente ou editar as alterações de configuração.
APIResumo: Você pode usar as DescribeDomainConfig
API operaçõesDescribeDomain
,DescribeDomainChangeProgress
, e para obter status detalhados de atualização de configuração. Além disso, você pode usar CancelDomainConfigChange
para cancelar as atualizações em caso de falhas na validação. Para obter mais informações, consulte a APIdocumentação do OpenSearch serviço
Quando as alterações de configuração são concluídas, o estado do domínio volta a ser Active
.
Você pode analisar a integridade do cluster e CloudWatch as métricas da Amazon e ver que o número de nós no cluster aumenta temporariamente, geralmente dobrando, enquanto a atualização do domínio ocorre. No exemplo a seguir, você pode ver o número de nós que dobram de 11 para 22 durante uma alteração de configuração e que retornam para 11 quando a atualização é concluída.
Esse aumento temporário pode sobrecarregar os nós principais dedicados do cluster, que repentinamente poderão ter muito mais nós para gerenciar. Também pode aumentar as latências de pesquisa e indexação à medida que o OpenSearch Service copia dados do cluster antigo para o novo. É importante manter capacidade suficiente no cluster para lidar com a sobrecarga associada a essas implantações azuis/verdes.
Importante
Não há nenhuma cobrança adicional nas alterações de configuração e na manutenção do serviço. Você será cobrado apenas pelo número de nós que solicitar para seu cluster. Para obter detalhes, consulte Cobranças para alterações de configuração.
Para evitar a sobrecarga de nós mestres dedicados, você pode monitorar o uso com as CloudWatch métricas da Amazon. Para obter os valores máximos recomendados, consulte CloudWatch Alarmes recomendados para o Amazon Service OpenSearch .
Etapas de uma alteração de configuração
Depois de iniciar uma alteração na configuração, o OpenSearch Service passa por uma série de etapas para atualizar seu domínio. Você pode visualizar o progresso da alteração de configuração em Status da alteração de configuração no console. As etapas exatas para a realização de uma atualização depende do tipo de alteração que você está fazendo. Você também pode monitorar uma alteração na configuração usando a DescribeDomainChangeProgressAPIoperação.
A seguir, estão as possíveis etapas de uma atualização durante uma alteração de configuração:
Nome da etapa | Descrição |
---|---|
Validação |
Validação se o domínio está qualificado para uma atualização e identificação de problemas de validação, se necessário. |
Criação de um novo ambiente |
Cumprimento dos pré-requisitos exigidos e criação dos recursos necessários para iniciar a implantação azul/verde. |
Provisionamento de novos nós |
Criando um novo conjunto de instâncias no novo ambiente. |
Roteamento de tráfego em novos nós |
Redirecionamento do tráfego para os nós de dados recém-criados. |
Roteamento de tráfego em nós antigos |
Desabilitação tráfego em nós de dados antigos. |
Preparação dos nós para remoção |
Preparação para a remoção de nós. Esta etapa só ocorre quando você reduz a escala do seu domínio (por exemplo, de 8 nós para 6 nós). |
Cópia de fragmentos para novos nós |
Transferência de fragmentos dos nós antigos para os novos nós. |
Encerramento de nós |
Encerramento e exclusão de nós antigos após a remoção dos fragmentos. |
Exclusão de recursos mais antigos |
Exclusão de recursos associados ao ambiente antigo (por exemplo, o balanceador de carga). |
Atualização dinâmica |
Eles serão exibidos quando a atualização não exigir uma implantação azul/verde e eles forem aplicáveis dinamicamente. |
Aplicando alterações dedicadas relacionadas à entidade principal |
Exibido quando o tipo ou a contagem de instâncias principais dedicadas são alterados. |
Aplicar alterações relacionadas ao volume |
Exibido quando o tamanho, o tipo IOPS e a taxa de transferência do volume são alterados. |
Impacto no desempenho de implantações azuis/verdes
Durante a implantação azul/verde, seu cluster do Amazon OpenSearch Service está disponível para solicitações de pesquisa e indexação recebidas. No entanto, você pode enfrentar os seguintes problemas de desempenho:
-
Aumento temporário no uso nos nós principais, pois os clusters têm mais nós para gerenciar.
-
Maior latência de pesquisa e indexação à medida que o OpenSearch Serviço copia dados de nós antigos para novos nós.
-
Maior rejeição para solicitações recebidas, pois a carga do cluster aumenta durante as implantações azuis/verdes.
-
Para evitar problemas de latência e rejeições de solicitações, você deve executar implantações azuis/verdes quando o cluster estiver íntegro e houver pouco tráfego de rede.
Cobranças para alterações de configuração
Se você alterar a configuração de um domínio, o OpenSearch Service criará um novo cluster conforme descrito emFazendo alterações de configuração no Amazon OpenSearch Service. Durante a migração do antigo para o novo, você é cobrado pelos seguintes encargos:
-
Se você alterar o tipo de instância, será cobrado por ambos os clusters para a primeira hora. Após a primeira hora, você será cobrado apenas pelo novo cluster. EBSos volumes não são cobrados duas vezes porque fazem parte do seu cluster, então o faturamento segue o faturamento por instância.
Exemplo: Você altera a configuração de três instâncias
m3.xlarge
para quatro instânciasm4.large
. Na primeira hora, você é cobrado por ambos os clusters (3 *m3.xlarge
+ 4 *m4.large
). Após a primeira hora, você será cobrado apenas pelo novo cluster (4 *m4.large
). -
Se você não alterar o tipo de instância, será cobrado apenas pelo cluster maior para a primeira hora. Após a primeira hora, você será cobrado apenas pelo novo cluster.
Exemplo: Você altera a configuração de seis instâncias
m3.xlarge
para três instânciasm3.xlarge
. Para a primeira hora, você será cobrado pelo cluster maior (6 *m3.xlarge
). Após a primeira hora, você será cobrado apenas pelo novo cluster (3 *m3.xlarge
).
Solução de problemas de erros de validação
Quando você inicia uma alteração na configuração ou realiza uma OpenSearch atualização de versão do Elasticsearch, o OpenSearch Service primeiro executa uma série de verificações de validação para garantir que seu domínio esteja qualificado para uma atualização. 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. A tabela a seguir lista os possíveis problemas de domínio que o OpenSearch Serviço pode surgir e as etapas para resolvê-los.
Problema | Código de erro | Etapas de solução de problemas |
---|---|---|
Grupo de segurança não encontrado | SecurityGroupNotFound |
O grupo de segurança associado ao seu domínio de OpenSearch serviço não existe. Para resolver esse problema, crie um grupo de segurança com o nome especificado. |
Sub-rede não encontrada | SubnetNotFound |
A sub-rede associada ao seu domínio OpenSearch de serviço não existe. Para resolver esse problema, crie uma sub-rede na suaVPC. |
Função vinculada ao serviço não configurada | SLRNotConfigured |
A função vinculada ao OpenSearch serviço para Serviço não está configurada. A função vinculada ao serviço é predefinida pelo OpenSearch Serviço e inclui todas as permissões que o serviço exige para chamar outros AWS serviços em seu nome. Se a função não existir, talvez seja necessário criá-la manualmente. |
Não há endereços IP suficientes | InsufficientFreeIPsForSubnets |
Uma ou mais das suas VPC sub-redes não têm endereços IP suficientes para atualizar seu domínio. Para calcular quantos endereços IP são necessários, consulte Reservar endereços IP em uma sub-rede VPC. |
O grupo de usuários do Cognito não existe | CognitoUserPoolNotFound |
OpenSearch O serviço não consegue encontrar o grupo de usuários do Amazon Cognito. Confirme se você criou um e se tem o ID correto. Para encontrar o ID, você pode usar o console do Amazon Cognito ou o seguinte comando da AWS CLI :
|
O grupo de identidades do Cognito não existe | CognitoIdentityPoolNotFound |
OpenSearch O serviço não consegue encontrar o pool de identidade do Cognito. Confirme se você criou um e se tem o ID correto. Para encontrar o ID, você pode usar o console do Amazon Cognito ou o seguinte comando da AWS CLI :
|
Domínio do Cognito não encontrado para grupo de usuários | CognitoDomainNotFound |
O grupo de usuários não tem um nome de domínio. Você pode configurar um usando o console do Amazon Cognito ou o seguinte comando: AWS CLI
|
Função do Cognito não configurada | CognitoRoleNotConfigured |
A IAM função que concede permissão ao OpenSearch Serviço para configurar os grupos de usuários e identidades do Amazon Cognito e usá-los para autenticação não está configurada. Configure a função com um conjunto de permissões e uma relação de confiança apropriados. Você pode usar o console, que cria a CognitoAccessForAmazonOpenSearchfunção padrão para você, ou você pode configurar manualmente uma função usando o AWS CLI ou AWS SDK o. |
Não é possível descrever o grupo de usuários | UserPoolNotDescribable |
A função especificada do Amazon Cognito não tem permissão para descrever o grupo de usuários associado ao seu domínio. Verifique se a política de permissões da função permite a ação cognito-identity:DescribeUserPool . Consulte Sobre a função CognitoAccessForAmazonOpenSearch para ver a política de permissões completa. |
Não é possível descrever o grupo de identidades | IdentityPoolNotDescribable |
A função especificada do Amazon Cognito não tem permissão para descrever o grupo de identidades associado ao seu domínio. Verifique se a política de permissões da função permite a ação cognito-identity:DescribeIdentityPool . Consulte Sobre a função CognitoAccessForAmazonOpenSearch para ver a política de permissões completa. |
Não é possível descrever os grupos usuários e de identidades | CognitoPoolsNotDescribable |
A função especificada do Amazon Cognito não tem permissão para descrever os grupos de usuários e de identidades associados ao seu domínio. Verifique se a política de permissões da função permite as ações cognito-identity:DescribeIdentityPool e cognito-identity:DescribeUserPool . Consulte Sobre a função CognitoAccessForAmazonOpenSearch para ver a política de permissões completa. |
KMSchave não ativada | KMSKeyNotEnabled |
A chave AWS Key Management Service (AWS KMS) usada para criptografar seu domínio está desativada. Reative a chave imediatamente. |
Certificado personalizado não está no ISSUED estado | InvalidCertificate |
Se seu domínio usa um endpoint personalizado, você o protege gerando um SSL certificado em AWS Certificate Manager (ACM) ou importando um de sua preferência. O status do certificado deve ser Emitido. Se você receber esse erro, verifique o status do seu certificado no ACM console. Se o status for Expirado, Falha, Inativo ou Validação pendente, consulte a documentação de ACM solução de problemas para resolver o problema. |
Capacidade insuficiente para iniciar o tipo de instância escolhido | InsufficientInstanceCapacity |
A capacidade do tipo de instância solicitada não está disponível. Por exemplo, você pode ter solicitado cinco |
Índices vermelhos no cluster | RedCluster |
Um ou mais índices em seu cluster têm um status vermelho, o que leva a um status geral de cluster vermelho. Para solucionar e corrigir esse problema, consulte Status de cluster vermelho. |
Disjuntor de memória, excesso de solicitações | TooManyRequests |
Há muitas solicitações de pesquisa e gravação em seu domínio, então o OpenSearch Serviço não pode atualizar sua configuração. Você pode reduzir o número de solicitações, escalar instâncias verticalmente até 64 GiB RAM ou escalar horizontalmente adicionando instâncias. |
A nova configuração não pode acomodar os dados (pouco espaço em disco) | InsufficientStorageCapacity |
O tamanho de armazenamento configurado não é capaz de acomodar todos os dados no seu domínio. Para resolver esse problema, escolha um volume maior, exclua índices não utilizados |
Fragmentos fixados em nós específicos | ShardMovementBlocked |
Um ou mais índices em seu domínio estão anexados a nós específicos e não podem ser reatribuídos. Isso provavelmente aconteceu porque você configurou a filtragem de alocação de fragmentos, que permite especificar quais nós têm permissão para hospedar os fragmentos de um índice específico. Para resolver esse problema, remova os filtros de alocação de fragmentos de todos os índices afetados:
|
A nova configuração não pode conter todos os fragmentos (contagem de fragmentos) | TooManyShards |
A contagem de fragmentos em seu domínio é muito alta, o que impede que o OpenSearch Serviço os mova para a nova configuração. Para resolver esse problema, dimensione seu domínio horizontalmente adicionando nós do mesmo tipo de configuração que os nós de cluster atuais. Observe que o tamanho máximo do EBS volume depende do tipo de instância do nó. Para evitar esse problema no futuro, consulte Como escolher o número de fragmentos e defina uma estratégia de fragmentação que seja apropriada para o seu caso de uso. |
A sub-rede associada ao seu domínio não suporta endereços IPv4 |
|
Para resolver esse problema, crie uma sub-rede ou atualize a sub-rede existente na sua de VPC acordo com o tipo de endereço IP configurado do domínio. Se seu domínio usa um IPv4único tipo de endereço, use uma IPv4 sub-rede somente. Se o domínio usa o modo de pilha dupla, use uma sub-rede de pilha dupla. |
A sub-rede associada ao seu domínio não suporta endereços IPv6 |
|
Para resolver esse problema, crie uma sub-rede ou atualize a sub-rede existente na sua de VPC acordo com o tipo de endereço IP configurado do domínio. Se seu domínio usa um IPv4único tipo de endereço, use uma IPv4 sub-rede somente. Se o domínio usa o modo de pilha dupla, use uma sub-rede de pilha dupla. |