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á. # Atualizações do software de serviço no Amazon OpenSearch Service **nota** Consulte as [notas de versão](release-notes.md) para obter explicações sobre as alterações e adições feitas em cada atualização *principal* do software do serviço (sem patch). O Amazon OpenSearch Service lança regularmente atualizações de software de serviços que adicionam recursos ou melhoram seus domínios. O painel **Notificações** no console é a maneira mais fácil de ver se uma atualização está disponível ou verificar o status de uma atualização. Cada notificação inclui detalhes sobre a atualização do software de serviço. Todas as atualizações de software de serviço usam implantações azul/verde para minimizar o tempo de inatividade. As atualizações do software do OpenSearch serviço são diferentes das atualizações da *versão do* serviço. Para obter informações sobre a atualização para uma versão posterior do OpenSearch Serviço, consulte[Atualizando domínios do Amazon OpenSearch Service](version-migration.md). OpenSearch O serviço exige que você aplique as atualizações de software de serviço necessárias dentro de 30 dias de sua disponibilidade. Essas atualizações são essenciais para manter a conformidade de segurança. Se você não aplicar as atualizações necessárias dentro do período de 30 dias, receberá notificações de lembrete a cada 15 dias durante 30 dias. Após esse período sem conformidade, seu domínio será isolado com os seguintes efeitos: + Todo o acesso de rede ao seu domínio é removido + O status do domínio muda para **isolado** + O domínio permanece inutilizável até que você aplique as atualizações necessárias Durante o isolamento, você continuará recebendo notificações de lembretes a cada 15 dias por 60 dias. Se você não aplicar as atualizações necessárias dentro desse período, seu domínio do OpenSearch Serviço e todos os dados associados serão excluídos permanentemente. Para obter mais informações, consulte [Solução de problemas de erros de validação](managedomains-configuration-changes.md#validation). ## Atualizações opcionais x obrigatórias OpenSearch O serviço tem duas grandes categorias de atualizações de software de serviço: ### Atualizações opcionais As atualizações opcionais do software de serviço geralmente incluem aprimoramentos e suporte para novos atributos ou funcionalidades. As atualizações opcionais não são aplicadas aos seus domínios e não há um prazo fixo para instalá-las. A disponibilidade da atualização é comunicada por e-mail e uma notificação no console. Você pode optar por aplicar a atualização imediatamente ou reagendá-la para uma data e hora mais convenientes. Você também pode programá-la durante a [janela fora do horário de pico](off-peak.md) do domínio. A maioria das atualizações de software é opcional. Independentemente de você agendar ou não uma atualização, se você fizer uma alteração no domínio que cause uma [implantação azul/verde](managedomains-configuration-changes.md), o OpenSearch Service atualizará automaticamente o software do serviço para você. Você pode configurar seu domínio para aplicar automaticamente atualizações opcionais [fora do horário de pico.](off-peak.md) Quando essa opção está ativada, o OpenSearch Serviço espera pelo menos 13 dias a partir do momento em que uma atualização opcional está disponível e, em seguida, agenda a atualização após sete dias. Você recebe uma notificação do console quando a atualização é agendada e pode optar por reagendá-la para uma data posterior. Para ativar as atualizações automáticas de software, selecione **Habilitar atualização automática de software** ao criar ou atualizar seu domínio. Para definir a mesma configuração usando o AWS CLI, `--software-update-options` defina como `true` quando você cria ou atualiza seu domínio. ### Atualizações necessárias As atualizações obrigatórias de software de serviço geralmente incluem correções críticas de segurança ou outras atualizações indispensáveis para garantir a integridade e a funcionalidade contínuas do seu domínio. Exemplos de atualizações necessárias são as vulnerabilidades e exposições comuns do Log4j (CVEs) e a aplicação do serviço de metadados de instância versão 2 (). IMDSv2 O número de atualizações obrigatórias em um ano geralmente é menor que três. OpenSearch O serviço agenda automaticamente essas atualizações e notifica você sete dias antes da atualização agendada por e-mail e uma notificação no console. Você pode optar por aplicar a atualização imediatamente ou reprogramá-la para uma data e hora mais convenientes *dentro do prazo permitido*. Você também pode programá-la durante a próxima [janela fora do horário de pico](off-peak.md) do domínio. Se você não tomar nenhuma ação em relação a uma atualização necessária e não fizer nenhuma alteração no domínio que cause uma blue/green implantação, o OpenSearch Serviço poderá iniciar a atualização a qualquer momento além do prazo especificado (normalmente 14 dias a partir da disponibilidade), dentro da janela fora de pico do domínio. Independentemente de quando a atualização está agendada, se você fizer uma alteração no domínio que cause uma [implantação azul/verde](managedomains-configuration-changes.md), o OpenSearch Service atualizará automaticamente seu domínio para você. ## Atualizações de patch Versões de software de serviço que terminam em “-P” e um número, como R20211203-, são lançamentos de patches. {{P4}} É provável que os patches incluam melhorias de performance, pequenas correções de bugs e correções de segurança ou melhorias de postura. As versões de patch não incluem novos atributos ou alterações significativas e geralmente não têm um impacto direto ou perceptível para os usuários. A notificação do software de serviço informa se a versão de um patch é opcional ou obrigatória. ## Considerações Considere o seguinte ao decidir se deseja atualizar seu domínio: + A atualização manual do seu domínio permite aproveitar os novos recursos mais rapidamente. Quando você escolhe **Atualizar**, o OpenSearch Serviço coloca a solicitação em uma fila e inicia a atualização quando tiver tempo. + Quando você inicia uma atualização do software do OpenSearch serviço, o Serviço envia uma notificação quando a atualização é iniciada e concluída. + As atualizações de software usam blue/green implantações para minimizar o tempo de inatividade. As atualizações podem sobrecarregar temporariamente os nós principais dedicados de um cluster. Por isso, certifique-se de manter capacidade suficiente para lidar com a sobrecarga associada. + Normalmente, as atualizações são concluídas em minutos, mas também podem levar várias horas ou até dias se o sistema estiver lidando com muita carga. Considere atualizar seu domínio durante a [janela fora do horário de pico](off-peak.md) para evitar longos períodos de atualização. ## Iniciar uma atualização do software de serviço Você pode solicitar uma atualização do software de OpenSearch serviço por meio do console de serviço AWS CLI, do ou de um dos SDKs. ### Console **Solicitar uma atualização de software de serviço** 1. Abra o console do Amazon OpenSearch Service em [https://console.aws.amazon.com/aos/casa](https://console.aws.amazon.com/aos/home). 1. Selecione o nome do domínio para abrir a configuração. 1. Escolha **Ações**, **Atualizar** e selecione uma das seguintes opções: + **Aplicar a atualização agora**: programa a ação para acontecer imediatamente, *se houver capacidade disponível*. Se a capacidade não estiver disponível, outros slots de horários disponíveis serão sugeridos. + **Agendar fora do horário de pico**: disponível somente se a janela fora do horário de pico estiver ativada para o domínio. Agenda a atualização para ocorrer durante a janela fora do horário de pico configurada do domínio. Não há garantia de que a atualização ocorrerá durante a próxima janela imediata. Dependendo da capacidade, isso pode acontecer nos dias subsequentes. Para saber mais, consulte [Agendamento de atualizações do software fora do horário de pico](#service-software-offpeak). + **Agendar para data e hora específicas** agenda a atualização para ocorrer em uma data e hora específicas. Se o horário especificado não estiver disponível por motivos de capacidade, você poderá selecionar um slot de horário diferente. Se você agendar a atualização para uma data posterior (dentro ou fora da janela de horário de pico do domínio), poderá reagendá-la a qualquer momento. Para instruções, consulte [Ações de reagendamento](off-peak.md#off-peak-reschedule). 1. Selecione a opção **Confirmar**. ### AWS CLI Envie uma [start-service-software-update](https://docs.aws.amazon.com/cli/latest/reference/opensearch/start-service-software-update.html) AWS CLI solicitação para iniciar uma atualização do software de serviço. Este exemplo adiciona a atualização à fila imediatamente: ``` aws opensearch start-service-software-update \ --domain-name {{my-domain}} \ --schedule-at "NOW" ``` **Resposta:** ``` { "ServiceSoftwareOptions": { "CurrentVersion": "R20220928-P1", "NewVersion": "R20220928-P2", "UpdateAvailable": true, "Cancellable": true, "UpdateStatus": "PENDING_UPDATE", "Description": "", "AutomatedUpdateDate": "1969-12-31T16:00:00-08:00", "OptionalDeployment": true } } ``` **dica** Depois de solicitar uma atualização, você tem um período de tempo limitado para cancelá-la. A duração desse `PENDING_UPDATE` estado pode variar muito e depende de você Região da AWS e do número de atualizações simultâneas que o OpenSearch Serviço está executando. Para cancelar uma atualização, use o console ou o `cancel-service-software-update` AWS CLI comando. Se a solicitação falhar com uma `BaseException`, isso significa que o horário especificado não está disponível por motivos de capacidade e você deve especificar um horário diferente. OpenSearch O serviço fornece sugestões alternativas de slots disponíveis na resposta. ### AWS SDKs Esse exemplo de script Python usa os métodos [describe\_domain e start\_service\_software\_update](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html#OpenSearchService.Client.describe_domain) [do AWS SDK para Python (Boto3) para verificar se um domínio está qualificado para uma atualização](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/opensearch.html#OpenSearchService.Client.start_service_software_update) do software de serviço e, em caso afirmativo, inicia a atualização. Você deve fornecer um valor para `domain_name`: ``` import boto3 from botocore.config import Config import time # Build the client using the default credential configuration. # You can use the CLI and run 'aws configure' to set access key, secret # key, and default region. my_config = Config( # Optionally lets you specify a Region other than your default. region_name='us-east-1' ) domain_name = '' # The name of the domain to check and update client = boto3.client('opensearch', config=my_config) def getUpdateStatus(client): """Determines whether the domain is eligible for an update""" response = client.describe_domain( DomainName=domain_name ) sso = response['DomainStatus']['ServiceSoftwareOptions'] if sso['UpdateStatus'] == 'ELIGIBLE': print('Domain [' + domain_name + '] is eligible for a service software update from version ' + sso['CurrentVersion'] + ' to version ' + sso['NewVersion']) updateDomain(client) else: print('Domain is not eligible for an update at this time.') def updateDomain(client): """Starts a service software update for the eligible domain""" response = client.start_service_software_update( DomainName=domain_name ) print('Updating domain [' + domain_name + '] to version ' + response['ServiceSoftwareOptions']['NewVersion'] + '...') waitForUpdate(client) def waitForUpdate(client): """Waits for the domain to finish updating""" response = client.describe_domain( DomainName=domain_name ) status = response['DomainStatus']['ServiceSoftwareOptions']['UpdateStatus'] if status == 'PENDING_UPDATE' or status == 'IN_PROGRESS': time.sleep(30) waitForUpdate(client) elif status == 'COMPLETED': print('Domain [' + domain_name + '] successfully updated to the latest software version') else: print('Domain is not currently being updated.') def main(): getUpdateStatus(client) ``` ## Agendamento de atualizações do software fora do horário de pico [Cada domínio do OpenSearch Serviço criado após 16 de fevereiro de 2023 tem uma janela diária de 10 horas entre 22h e 8h, horário local, que consideramos a janela fora de pico.](off-peak.md) OpenSearch O serviço usa essa janela para agendar atualizações do software do serviço para o domínio. As atualizações fora do pico ajudam a minimizar a sobrecarga nos nós principais dedicados de um cluster durante períodos de maior tráfego. OpenSearch O serviço não pode iniciar atualizações fora dessa janela de 10 horas sem o seu consentimento. + Para atualizações *opcionais*, o OpenSearch Serviço notifica você sobre a disponibilidade da atualização e solicita que você agende a atualização durante um próximo período fora de pico. + Para as atualizações *necessárias*, o OpenSearch Serviço agenda automaticamente a atualização durante uma próxima janela fora de pico e notifica você com três dias de antecedência. Você pode reagendar a atualização (dentro ou fora da janela de pico), mas somente dentro do prazo necessário para que a atualização seja concluída. Para cada domínio, você pode optar por substituir o horário de início padrão das 22h por um horário personalizado. Para instruções, consulte [Configurar uma janela personalizada fora do horário de pico](off-peak.md#off-peak-custom). ### Console **Como agendar uma atualização durante uma próxima janela fora do horário de pico** 1. Abra o console do Amazon OpenSearch Service em [https://console.aws.amazon.com/aos/casa](https://console.aws.amazon.com/aos/home ). 1. Selecione o nome do domínio para abrir a configuração. 1. Escolha **Ações**, **Atualizar**. 1. Selecione **Agendar em uma janela fora do horário de pico.** 1. Selecione a opção **Confirmar**. Você pode visualizar a ação agendada na guia **Janela fora do horário de pico** e reagendá-la a qualquer momento. Consulte [Exibir ações agendadas](off-peak.md#off-peak-view). ### CLI Para agendar uma atualização durante uma próxima janela fora de pico usando o AWS CLI, envie uma [StartServiceSoftwareUpdate](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_StartServiceSoftwareUpdate.html)solicitação e especifique `OFF_PEAK_WINDOW` o `--schedule-at` parâmetro: ``` aws opensearch start-service-software-update \ --domain-name {{my-domain}} \ --schedule-at "OFF_PEAK_WINDOW" ``` ## Monitoramento das atualizações de software de serviço OpenSearch O serviço envia uma [notificação](managedomains-notifications.md) quando uma atualização do software do serviço está disponível, é necessária, iniciada, concluída ou falha. Você pode ver essas **notificações no painel Notificações** do console OpenSearch de serviço. A gravidade da notificação será `Informational` se a atualização for opcional e `High` se ela for necessária. OpenSearch O serviço também envia eventos de software de serviço para a Amazon EventBridge. Você pode usar EventBridge para configurar regras que enviam um e-mail ou executam uma ação específica quando um evento é recebido. Para ver um exemplo de apresentação, consulte[Tutorial: Envio de alertas do Amazon SNS para atualizações de software disponíveis](sns-events.md). Para ver o formato de cada evento de software de serviço enviado para a Amazon EventBridge, consulte[Eventos de atualização de software de serviço](monitoring-events.md#monitoring-events-sso). ## Quando os domínios não são elegíveis para uma atualização Seu domínio poderá ser inelegível para um serviço de atualização de software se ele estiver em qualquer um dos seguintes estados: | Estado | Description | | --- | --- | | 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](handling-errors.md#handling-errors-red-cluster-status). | | Alta taxa de erros | O OpenSearch cluster está retornando um grande número de 5 erros *xx* 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 seu OpenSearch cluster tem mais de um nó principal e se dividiu em dois clusters que nunca se reunirão sozinhos. Você pode evitar dividir o cérebro usando o número recomendado de [nós principais dedicados](managedomains-dedicatedmasternodes.md). Para ajudar na recuperação do cérebro dividido, entre em contato com [Suporte](https://console.aws.amazon.com/support/home). | | Problema de integração do Amazon Cognito | Seu domínio usa [autenticação para OpenSearch painéis](cognito-auth.md), e o OpenSearch Service não consegue encontrar um ou mais recursos do Amazon Cognito. Este problema normalmente ocorre quando o grupo de usuários do Amazon Cognito está ausente. Para corrigir o problema, recrie o recurso ausente e configure o domínio do OpenSearch serviço para usá-lo. | | Outro problema de serviço do | Problemas com o OpenSearch serviço em si podem fazer com que seu domínio seja exibido como inelegível para uma atualização. 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 o [Suporte](https://console.aws.amazon.com/support/home). | ## Revertendo uma atualização do software de serviço O Amazon OpenSearch Service oferece suporte à reversão de atualizações de software do serviço. Você pode iniciar uma reversão usando o console OpenSearch de serviço AWS CLI, o ou um dos. AWS SDKs As atualizações de software são revertidas usando uma blue/green implantação. **nota** A reversão é suportada somente para atualizações de software de serviço aplicadas em ou após 24 de abril de 2026. As atualizações da versão do motor não podem ser revertidas. ### Elegibilidade e considerações sobre a reversão Seu domínio deve atender a todas as condições a seguir para que uma reversão esteja disponível: + **O domínio está ativo** — O domínio deve estar em um `Active` estado. A reversão não está disponível enquanto uma alteração de configuração, atualização de software ou outra blue/green implantação está em andamento. + **Dentro da janela de tempo de reversão** — A atualização do software deve ter sido aplicada dentro do período de reversão permitido. Consulte [Janelas de tempo de reversão](#service-software-rollback-windows). + **Nenhuma alteração na configuração após a atualização** — Se você fez uma alteração na configuração do domínio após a aplicação da atualização de software, a reversão será bloqueada. As alterações na configuração podem afetar as configurações do domínio de maneiras incompatíveis com a versão anterior do software. Por exemplo, alterar os tipos de instância, ativar réplicas ou ajustar as configurações de armazenamento após uma atualização bloqueará a reversão. + A **atualização não foi aplicada automaticamente pelo serviço** — Se você não agiu em uma atualização obrigatória dentro da janela de disponibilidade de 30 dias e o OpenSearch Serviço aplicou a atualização automaticamente, a reversão não está disponível para essa atualização. + A **atualização não foi uma atualização da versão do mecanismo** — as alterações na versão do mecanismo (por exemplo, a atualização da versão OpenSearch 1.3 para a OpenSearch 2.11) são irreversíveis. Somente as reversões da versão do software de serviço são suportadas. + **Existe uma versão anterior do software** — a reversão está disponível somente para atualizações de software aplicadas depois que esse recurso se tornou disponível ao público em geral (GA). Os domínios que ainda não passaram por uma atualização de software desde o GA não têm uma versão anterior para a qual reverter. + **Somente uma reversão é permitida por atualização** — quando a reversão é concluída, o domínio é considerado em estado de reversão. Você não pode reverter novamente até que uma nova atualização de software tenha sido aplicada com sucesso. + A **atualização do software foi iniciada explicitamente** — a reversão só está disponível quando a atualização do software foi iniciada explicitamente por você ou agendada automaticamente pelo OpenSearch Serviço como parte de uma atualização obrigatória ou opcional. A reversão não está disponível quando: + A atualização do software foi aplicada durante uma blue/green implantação acionada por uma alteração na configuração. Isso inclui casos em que a `UseLatestServiceSoftwareForBlueGreen` configuração está ativada, o que agrupa a atualização de software mais recente com as alterações de configuração. Você tem a opção de desativar essa configuração. + A atualização foi aplicada durante uma operação de manutenção iniciada pelo serviço em seu domínio, como recuperação de infraestrutura, remediação automatizada ou outras operações internas realizadas pelo OpenSearch Serviço para manter a integridade e a disponibilidade do seu domínio. ### Janelas de tempo de reversão A janela de reversão depende do tipo de atualização de software aplicada. | Tipo de atualização | Janela de reversão | Observações | | --- | --- | --- | | Opcional | 15 dias a partir da data em que a atualização foi aplicada | Aplica-se se você aplicou a atualização manualmente, agendou-a ou se ela foi aplicada automaticamente fora do horário de pico. | | Obrigatório | 15 dias a partir da data em que a atualização foi aplicada | Disponível somente se você mesmo aplicou a atualização dentro da janela de disponibilidade de 30 dias. Se o serviço aplicou automaticamente a atualização após o prazo, a reversão não estará disponível. | Depois que a janela de reversão expirar, a reversão por autoatendimento não estará mais disponível. Entre em contato [Suporte](https://console.aws.amazon.com/support/home)se você estiver enfrentando um problema crítico após o fechamento da janela. ### Como solicitar uma reversão Você pode solicitar uma reversão usando a `RollbackServiceSoftwareUpdate` API. #### Solicitação ``` POST /2021-01-01/opensearch/serviceSoftwareUpdate/rollback ``` Corpo da solicitação: ``` { "DomainName": "{{your-domain-name}}" } ``` #### Resposta A API retorna uma resposta HTTP 200 em todos os casos sem erro. O `RollbackAvailable` campo no corpo da resposta indica se a reversão foi iniciada. ``` { "RollbackServiceSoftwareOptions": { "CurrentVersion": "string", "NewVersion": "string", "RollbackAvailable": boolean, "Description": "string" } } ``` Campos de resposta: | Campo | Tipo | Description | | --- | --- | --- | | CurrentVersion | String | A versão do software atualmente em execução no domínio. | | NewVersion | String | A versão do software para a qual o domínio será revertido. Retorna null se a reversão não estiver disponível. | | RollbackAvailable | Booleano | `true`se a reversão tiver sido iniciada com sucesso. `false`se o domínio não estiver qualificado para reversão. | | Description | String | Uma mensagem legível por humanos descrevendo o resultado ou o motivo pelo qual a reversão não está disponível. | #### Respostas de erro | Erro | Description | | --- | --- | | ResourceNotFoundException | O domínio especificado não existe. | | ValidationException | O domínio não está em um estado ativo. Aguarde a conclusão de todas as alterações em andamento antes de tentar novamente. | | InternalException | O serviço encontrou um erro interno. Repetir a solicitação . | | DisabledOperationException | A operação de reversão não é compatível com esse domínio. | #### Mensagens de resposta A tabela a seguir descreve as possíveis mensagens de resposta retornadas pela `RollbackServiceSoftwareUpdate` API. | Caso | Description | | --- | --- | | Bem-sucedida | A reversão foi iniciada com sucesso. O domínio será revertido de {{current-version}} para{{previous-version}}. | | Recurso não ativado | A reversão não está disponível. Entre em contato [Suporte](https://console.aws.amazon.com/support/home)para obter assistência. | | Software anterior não disponível | Nenhuma versão anterior do software está disponível para reversão. Entre em contato [Suporte](https://console.aws.amazon.com/support/home)para obter assistência. | | O software anterior é o mesmo que o atual | A reversão não está disponível. Nenhuma versão anterior do software está disponível para reversão. Entre em contato [Suporte](https://console.aws.amazon.com/support/home)para obter assistência. | | O domínio já foi revertido | O domínio já está em um estado revertido. | | O cluster está na versão fixa do software | A substituição de software está atualmente aplicada ao domínio. | | Fora da janela de tempo | A reversão não está disponível. A janela de reversão de 15 dias expirou. Entre em contato [Suporte](https://console.aws.amazon.com/support/home)para obter assistência. | | Atualização de serviço obrigatória aplicada automaticamente | A reversão não está disponível. A versão atual foi aplicada por meio de uma atualização de serviço obrigatória. Entre em contato [Suporte](https://console.aws.amazon.com/support/home)para obter assistência. | | Atualização da versão do motor | A reversão não está disponível. As atualizações da versão do motor são irreversíveis. Entre em contato [Suporte](https://console.aws.amazon.com/support/home)para obter assistência. | | Configuração alterada após a atualização | A reversão não está disponível. A configuração do cluster mudou desde a última atualização do software. Entre em contato [Suporte](https://console.aws.amazon.com/support/home)para obter assistência. | **Exemplo de resposta:** ``` { "RollbackServiceSoftwareOptions": { "CurrentVersion": "OpenSearch_2_11_R20240115", "NewVersion": "OpenSearch_2_11_R20231023", "RollbackAvailable": true, "Description": "Rollback initiated successfully. The domain will be rolled back from OpenSearch_2_11_R20240115 to OpenSearch_2_11_R20231023." } } ``` Quando a reversão não está disponível, `RollbackAvailable` retorna `false` e o `Description` campo contém o motivo da tabela acima.