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á.
Periodicamente, o Amazon DocumentDB realiza a manutenção em seus recursos. Geralmente, a manutenção envolve atualizações do mecanismo de banco de dados (manutenção do cluster) ou do sistema operacional (SO) subjacente da instância (manutenção da instância). As atualizações do mecanismo de banco de dados são patches obrigatórios e incluem correções de segurança, correções de bugs e aprimoramentos no mecanismo de banco de dados. Embora a maioria dos patches do sistema operacional sejam opcionais, se você não os aplicar por algum tempo, o patch poderá ser necessário e aplicado automaticamente para manter sua postura de segurança. Portanto, recomendamos que você aplique atualizações do sistema operacional às suas instâncias do Amazon DocumentDB assim que elas estiverem disponíveis.
Os patches do mecanismo de banco de dados exigem que você coloque os clusters do Amazon DocumentDB offline por um curto período. Uma vez disponíveis, esses patches são automaticamente programados para serem aplicados durante uma próxima janela de manutenção programada do seu cluster do Amazon DocumentDB.
A manutenção do cluster e de instâncias tem suas próprias janelas de manutenção. As modificações no cluster e na instância que você optou por não aplicar imediatamente também são aplicadas durante a janela de manutenção. Por padrão, quando você cria um cluster, o Amazon DocumentDB atribui uma janela de manutenção para um cluster e cada instância. Você pode escolher a janela de manutenção ao criar um cluster ou uma instância. Você também pode modificar as janelas de manutenção a qualquer momento para atender às suas programações ou práticas comerciais. Em geral, é recomendável escolher janelas de manutenção que minimizem o impacto da manutenção em sua aplicação (por exemplo, em noites ou fins de semana).
Notificações para patches do mecanismo do Amazon DocumentDB
Você receberá notificações de manutenção dos patches necessários do mecanismo de banco de dados por meio de eventos de integridade no AWS Health Dashboard (AHD) no AWS console e por meio de e-mails. Quando um patch de manutenção do mecanismo Amazon DocumentDB estiver disponível em uma AWS região específica, todas as contas de usuário do Amazon DocumentDB afetadas na região receberão uma notificação por AHD e por e-mail para cada versão do Amazon DocumentDB afetada pelo patch. Você pode ver essas notificações na seção Alterações programadas do AHD no AWS console. A notificação terá detalhes sobre o momento da disponibilidade do patch, o cronograma de aplicação automática, a lista de clusters afetados e as notas de lançamento. Essa notificação também será enviada por e-mail para o endereço de e-mail do usuário raiz da AWS conta.
Depois de receber essa notificação, você pode optar por aplicar automaticamente esses patches de mecanismo aos seus clusters do Amazon DocumentDB antes da data programada de aplicação automática. Ou você pode esperar que os patches do mecanismo sejam aplicados automaticamente durante uma próxima janela de manutenção (opção padrão).
nota
O status da notificação no AHD será definido como “Em andamento” até que um novo patch do mecanismo do Amazon DocumentDB com uma nova versão do patch do mecanismo seja lançado.
Depois que o patch do mecanismo for aplicado ao seu cluster do Amazon DocumentDB, a versão do patch do mecanismo do cluster será atualizada para refletir a versão na notificação. Você pode executar o comando db.runCommand({getEngineVersion: 1}) para verificar essa atualização.
AWS Health também se integra à Amazon EventBridge , que usa eventos para criar aplicativos escaláveis orientados a eventos e se integra a mais de 20 destinos AWS Lambda, incluindo Amazon Simple Queue Service (SQS) e outros. Você pode usar o código do AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED evento para configurar a Amazon EventBridge antes que os patches do motor estejam disponíveis. Você pode configurar EventBridge para responder ao evento e realizar ações automaticamente, como capturar informações do evento, iniciar eventos adicionais, enviar notificações por meio de canais adicionais, como notificações push para o AWS Console Mobile Application, e tomar ações corretivas ou outras, quando um patch do mecanismo Amazon DocumentDB estiver disponível em sua região.
No raro cenário de o Amazon DocumentDB, se cancelar um patch de mecanismo, você receberá uma notificação do AHD e um e-mail informando sobre o cancelamento. Assim, você pode usar o código do AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED evento para configurar EventBridge a Amazon para responder a esse evento. Consulte o Guia EventBridge do usuário da Amazon para saber mais sobre o uso EventBridge das regras da Amazon.
Consultar ações de manutenção pendentes do Amazon DocumentDB
Você pode ver se uma atualização de manutenção está disponível para seu cluster usando AWS Management Console o. ou AWS CLI o.
Se uma atualização estiver disponível, você poderá executar uma das seguintes ações:
-
Adiar uma ação de manutenção atualmente programada para a próxima janela de manutenção (somente para patches do sistema operacional).
-
Aplicar as ações de manutenção imediatamente.
-
Agendar as ações de manutenção para serem iniciadas durante a próxima janela de manutenção.
nota
Se você não tomar nenhuma ação, as ações de manutenção necessárias, como patches de motor, serão aplicadas automaticamente em uma próxima janela de manutenção programada.
A janela de manutenção determina quando as operações pendentes começam, mas não limita o tempo total de execução dessas operações.
-
No painel de navegação, escolha Clusters.
-
Se uma atualização estiver disponível, ela será indicada pela palavra Disponível, Obrigatória ou Próxima janela na coluna Manutenção do cluster no console do Amazon DocumentDB, conforme mostrado aqui:
-
Para executar uma ação, escolha a instância o cluster de banco de dados para mostrar seus detalhes e escolha Manutenção e backups. Os itens de manutenção pendentes são exibidos.
Atualizações do mecanismo do Amazon DocumentDB
Com o Amazon DocumentDB, você pode escolher quando aplicar operações de manutenção. Você pode decidir quando o Amazon DocumentDB aplica as atualizações usando o AWS Management Console ou. AWS CLI
Use os procedimentos neste tópico para atualizar imediatamente ou programar uma atualização para seu cluster.
Você pode usar o console para gerenciar atualizações para seus clusters do Amazon DocumentDB.
Para gerenciar a atualização de um cluster
-
No painel de navegação, escolha Clusters.
-
Na lista de clusters, escolha o botão ao lado do nome do cluster ao qual você deseja aplicar a operação de manutenção.
-
No menu Actions (Ações), escolha uma das opções a seguir:
-
Upgrade now (Atualizar agora) para executar imediatamente as tarefas de manutenção pendentes.
-
Upgrade at next window (Atualizar na próxima janela) para executar as tarefas de manutenção pendentes durante a próxima janela de manutenção do cluster.
Como alternativa, você pode clicar em Aplicar agora ou Aplicar na próxima janela de manutenção na seção Manutenção pendente da guia Manutenção e backups do cluster (consulte Usando o AWS Management Console na seção anterior).
nota
Se não houver tarefas de manutenção pendentes, as opções anteriores estarão inativas.
-
Aplicar datas
Cada ação de manutenção tem uma respectiva data de aplicação que você pode encontrar ao descrever as ações de manutenção pendentes. Quando você lê o resultado das ações de manutenção pendentes do AWS CLI, três datas são listadas. Esses valores de data são null quando a manutenção é opcional. Os valores são preenchidos quando a ação de manutenção correspondente é programada ou aplicada.
-
CurrentApplyDate- Data em que a ação de manutenção será aplicada imediatamente ou durante a próxima janela de manutenção. -
ForcedApplyDate- Data em que a manutenção será aplicada automaticamente, independente de sua janela de manutenção. -
AutoAppliedAfterDate- Data depois da qual a manutenção será aplicada durante a janela de manutenção do cluster.
Atualizações iniciadas pelo usuário
Como usuário do Amazon DocumentDB, você pode iniciar atualizações para seus clusters ou instâncias. Por exemplo, você pode modificar a classe de uma instância para uma com mais ou menos memória ou alterar o grupo de parâmetros de um cluster. O Amazon DocumentDB visualiza essas alterações de forma diferente das atualizações iniciadas pelo Amazon DocumentDB. Para obter mais informações sobre como modificar um cluster ou uma instância, consulte o seguinte:
Para ver uma lista de modificações pendentes iniciadas pelo usuário, execute o comando a seguir.
Para ver as alterações pendentes iniciados pelo usuário para suas instâncias
Para Linux, macOS ou Unix:
aws docdb describe-db-instances \ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'
Para Windows:
aws docdb describe-db-instances ^ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'
A saída dessa operação é semelhante ao seguinte (formato JSON).
Nesse caso, sample-cluster-instance tem uma alteração pendente em uma classe de instância db.r5.xlarge e sample-cluster-instance-2 não tem alterações pendentes.
[
[
"sample-cluster",
"sample-cluster-instance",
{
"DBInstanceClass": "db.r5.xlarge"
}
],
[
"sample-cluster",
"sample-cluster-instance-2",
{}
]
]Gerenciar suas janelas de manutenção do Amazon DocumentDB
Cada instância e cluster têm uma janela de manutenção semanal durante a qual todas as alterações pendentes são aplicadas. A janela de manutenção é uma oportunidade para controlar quando ocorrerão as modificações e aplicações de patches de software, caso elas sejam solicitadas ou exigidas. Se um evento de manutenção estiver programado para uma determinada semana, ele é iniciado durante a janela de manutenção de 30 minutos que você identificar. A maioria dos eventos de manutenção também é concluída durante a janela de manutenção de 30 minutos, embora os eventos de manutenção mais longos possam levar mais de 30 minutos para serem concluídos.
A janela de manutenção de 30 minutos é selecionada aleatoriamente de um bloco de tempo de 8 horas por região. Se você não especificar uma janela de manutenção preferencial ao criar ou modificar uma instância ou cluster, o Amazon DocumentDB atribuirá uma janela de manutenção de 30 minutos em um dia da semana selecionado aleatoriamente.
A tabela a seguir lista os blocos de tempo de cada região dos quais as janelas de manutenção padrão são atribuídas.
| Nome da região | Região | Bloco de tempo UTC |
|---|---|---|
| Leste dos EUA (Ohio) | us-east-2 | 03:00-11:00 |
| Leste dos EUA (Norte da Virgínia) | us-east-1 | 03:00-11:00 |
| Oeste dos EUA (Oregon) | us-west-2 | 06:00-14:00 |
| África (Cidade do Cabo) | af-south-1 | 03:00-11:00 |
| Ásia-Pacífico (Hong Kong) | ap-east-1 | 06:00-14:00 |
| Ásia-Pacífico (Hyderabad) | ap-south-2 | 06:30–14:30 |
| Ásia-Pacífico (Mumbai) | ap-south-1 | 06:00-14:00 |
| Ásia-Pacífico (Seul) | ap-northeast-2 | 13:00-21:00 |
| Ásia-Pacífico (Singapura) | ap-southeast-1 | 14:00-22:00 |
| Ásia-Pacífico (Sydney) | ap-southeast-2 | 12:00-20:00 |
| Ásia-Pacífico (Tóquio) | ap-northeast-1 | 13:00-21:00 |
| Canadá (Central) | ca-central-1 | 03:00-11:00 |
| China (Pequim) | cn-north-1 | 06:00-14:00 |
| China (Ningxia) | cn-northwest-1 | 06:00-14:00 |
| Europa (Frankfurt) | eu-central-1 | 21:00-05:00 |
| Europa (Irlanda) | eu-west-1 | 22:00-06:00 |
| Europa (Londres) | eu-west-2 | 22:00-06:00 |
| Europa (Milão) | eu-south-1 | 02:00-10:00 |
| Europa (Paris) | eu-west-3 | 23:59-07:29 |
| Europa (Espanha) | eu-south-2 | 02:00-10:00 |
| Oriente Médio (Emirados Árabes Unidos) | me-central-1 | 05:00-13:00 |
| América do Sul (São Paulo) | sa-east-1 | 00:00-08:00 |
| AWS GovCloud (Leste dos EUA) | us-gov-east-1 | 17:00-01:00 |
| AWS GovCloud (Oeste dos EUA) | us-gov-west-1 | 06:00-14:00 |
Gerenciar suas janelas de manutenção do Amazon DocumentDB
A janela de manutenção deve ser definida no horário de menor utilização e, portanto, talvez precise ser alterada de vez em quando. Seu cluster ou a instância estará indisponível durante esse tempo somente se as alterações do sistema (como uma operação de armazenamento em escala ou uma alteração da classe de instância) estiverem sendo aplicadas e exigirem uma interrupção. E, depois, estará indisponível apenas pelo intervalo mínimo de tempo necessário para fazer as alterações necessárias.
Para atualizações no mecanismo de banco de dados, o Amazon DocumentDB usa a janela de manutenção preferencial do cluster e não a janela de manutenção para instâncias individuais.
Para alterar a janela de manutenção
-
Para um cluster: consulte Modificar um cluster do Amazon DocumentDB.
-
Para uma instância: consulte Modificar uma instância do Amazon DocumentDB.
Atualizações do sistema operacional do Amazon DocumentDB
As instâncias nos clusters do Amazon DocumentDB ocasionalmente exigem atualizações do sistema operacional. O Amazon DocumentDB faz upgrade do sistema operacional para uma versão mais recente para melhorar a performance do banco de dados e o procedimento de segurança geral dos clientes. As atualizações do sistema operacional não alteram a versão do mecanismo do cluster nem a classe de uma instância do Amazon DocumentDB.
Recomendamos que você atualize primeiro as instâncias do leitor em um cluster, e depois a instância do gravador a fim de maximizar a disponibilidade de seu cluster. Não recomendamos atualizar as instâncias do leitor e do gravador ao mesmo tempo, pois pode ocasionar um período de inatividade mais longo no caso de um failover.
A maioria das atualizações do sistema operacional do Amazon DocumentDB são opcionais e não têm uma data definida para aplicá-las. No entanto, se você não aplicar essas atualizações por um tempo, elas poderão eventualmente se tornar necessárias e aplicadas automaticamente durante a janela de manutenção da sua instância. Isso ajuda a manter a postura de segurança de seu banco de dados. Para evitar qualquer tempo de inatividade inesperado, recomendamos que você aplique atualizações do sistema operacional às suas instâncias do Amazon DocumentDB assim que elas estiverem disponíveis e defina a janela de manutenção da instância no momento de sua conveniência, de acordo com as necessidades de sua empresa.
Para ser notificado quando uma nova atualização opcional estiver disponível, você poderá assinar o RDS-EVENT-0230 na categoria de evento de aplicação de patch de segurança. Para obter informações sobre como se inscrever em eventos do Amazon DocumentDB, consulte Inscrição em eventos do Amazon DocumentDB.
Você deve esperar que, quando a manutenção for realizada em seu cluster ou na instância, se a instância for principal, ocorrerá o failover. Para melhorar sua disponibilidade, recomendamos que você use mais de uma instância para seus clusters do Amazon DocumentDB. Para obter mais informações, consulte Failover do Amazon DocumentDB.
nota
Para alguns recursos de gerenciamento, o Amazon DocumentDB usa a tecnologia operacional que é compartilhada com o Amazon Relational Database Service (Amazon RDS).
Importante
Sua instância do Amazon DocumentDB permanecerá off-line durante a atualização do sistema operacional. Você pode minimizar o tempo de inatividade do cluster com um cluster de várias instâncias. Se você não tiver um cluster de várias instâncias, poderá optar por criar temporariamente um adicionando instâncias secundárias para realizar essa manutenção e, em seguida, excluindo as instâncias de leitura adicionais quando a manutenção for concluída (cobranças regulares pela instância secundária serão aplicadas).
nota
A aplicação de todas as atualizações opcionais e obrigatórias pode ser necessária para cumprir várias obrigações de conformidade. Recomendamos que você aplique todas as atualizações disponibilizadas pelo Amazon DocumentDB rotineiramente durante suas janelas de manutenção.
Você pode usar o AWS Management Console ou o AWS CLI para determinar se uma atualização está disponível.
Como determinar se uma atualização está disponível usando o AWS Management Console:
No painel de navegação, escolha Clusters e selecione a instância.
Escolha Manutenção.
Na seção Manutenção pendente, encontre a atualização do sistema operacional.
Você pode selecionar a atualização do sistema operacional e clicar em Aplicar agora ou Aplicar na próxima janela de manutenção na seção Manutenção pendente. Se o valor de manutenção for próxima janela, adie os itens de manutenção escolhendo Adiar atualização. Não é possível adiar uma ação de manutenção que já tiver sido iniciada.
Como alternativa, você pode escolher a instância em uma lista de clusters clicando em Clusters no painel de navegação e selecionando Aplicar agora ou Aplicar na próxima janela de manutenção no menu Ações.
As atualizações do sistema operacional são específicas da versão do mecanismo e das classes de instância do Amazon DocumentDB. Portanto, as instâncias do Amazon DocumentDB recebem ou exigem atualizações em momentos diferentes. Quando uma atualização do sistema operacional estiver disponível para sua instância com base na versão do mecanismo e na classe de instância, essa atualização aparecerá no console. Ele também pode ser visualizado executando o AWS CLI describe-pending-maintenance-actions comando ou chamando a operação DescribePendingMaintenanceActions da API.
Se você não estiver executando a versão mais recente do patch de cluster do seu mecanismo do Amazon DocumentDB, talvez não veja a atualização do sistema operacional listada como manutenção disponível. Para visualizar e gerenciar a atualização do sistema operacional, você deve primeiro atualizar para a versão mais recente do patch do mecanismo.
