# Manutenção de um cluster de banco de dados do Amazon Aurora
Periodicamente, o Amazon RDS realiza a manutenção em seus recursos. Os tópicos a seguir descrevem essas ações de manutenção e como aplicá-las.
## Visão geral das atualizações de manutenção do cluster de banco de dados
A manutenção geralmente envolve atualizações dos seguintes atributos no cluster de banco de dados:
+ Hardware subjacente
+ Sistema operacional subjacente
+ Versão do mecanismo de banco de dados
As atualizações no sistema operacional geralmente ocorrem para problemas de segurança. Recomendamos que você os faça o quanto antes. Para ter mais informações sobre os sistemas operacionais compatíveis, consulte [Atualizações do sistema operacional para clusters de banco de dados do Aurora](#Aurora_OS_updates).
**Topics**
+ [
### Recursos off-line durante as atualizações de manutenção
](#USER_UpgradeDBInstance.Maintenance.Overview.offline)
+ [
### Modificações adiadas da instância de banco de dadose do cluster de banco de dados
](#USER_UpgradeDBInstance.Maintenance.Overview.Deferred)
+ [
### Consistência eventual da API DescribePendingMaintenanceActions
](#USER_UpgradeDBInstance.Maintenance.Overview.eventual-consistency)
### Recursos off-line durante as atualizações de manutenção
Alguns itens de manutenção exigem que o Amazon RDS coloque o cluster de banco de dados off-line por um curto período. Entre os itens de manutenção que exigem um recurso esteja offline estão sistema operacional obrigatório ou patches de banco de dados. A aplicação obrigatória de patches é automaticamente programada somente para patches relacionados à segurança e à confiabilidade da instância. Essa correção ocorre com pouca frequência, normalmente uma vez a cada poucos meses. Raramente requer mais do que uma fração de sua janela de manutenção.
### Modificações adiadas da instância de banco de dadose do cluster de banco de dados
As modificações adiadas no cluster e na instância de banco de dados que você optou por não aplicar imediatamente são aplicadas durante a janela de manutenção. Por exemplo, você pode optar por alterar classes de instância de banco de dados ou grupos de parâmetros de cluster ou banco de dados durante a janela de manutenção. Essas modificações especificadas usando a configuração **pending reboot (reinicialização pendente)** não aparecem na lista **Pending maintenance (Manutenção pendente)**. Para obter informações sobre como modificar um cluster de banco de dados, consulte [Modificar um cluster de bancos de dados Amazon Aurora](Aurora.Modifying.md).
Para ver as modificações pendentes para a próxima janela de manutenção, use o comando [describe-db-clusters](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/describe-db-clusters.html) da AWS CLI e selecione o campo `PendingModifiedValues`.
### Consistência eventual da API DescribePendingMaintenanceActions
A API `DescribePendingMaintenanceActions` do Amazon RDS segue o modelo de consistência eventual. Isso significa que o resultado do comando `DescribePendingMaintenanceActions` poderá não ser imediatamente visível para todos os comandos subsequentes do RDS. Lembre-se disso ao usar `DescribePendingMaintenanceActions` imediatamente após usar um comando de API anterior.
A consistência eventual pode afetar a maneira como você gerencia suas atualizações de manutenção. Por exemplo, se você executar o comando `ApplyPendingMaintenanceActions` para atualizar a versão do mecanismo de banco de dados para um cluster de banco de dados, ela ficará visível para `DescribePendingMaintenanceActions`. Nesse cenário, `DescribePendingMaintenanceActions` pode mostrar que a ação de manutenção não foi aplicada, embora tenha sido.
Para gerenciar a consistência eventual, é possível fazer o seguinte:
+ Confirme o estado do cluster de banco de dados antes de executar um comando para modificá-lo. Execute o comando `DescribePendingMaintenanceActions` apropriado usando um algoritmo de recuo exponencial para garantir tempo suficiente para que o comando anterior se propague pelo sistema. Para fazer isso, execute o comando `DescribePendingMaintenanceActions` repetidamente, começando com alguns segundos de espera e aumentando gradualmente até cinco minutos de espera.
+ Adicione o tempo de espera entre os comandos subsequentes, mesmo que um comando `DescribePendingMaintenanceActions` exiba uma resposta precisa. Aplique um algoritmo de recuo exponencial começando com alguns segundos de espera e aumente gradualmente até cerca de cinco minutos de espera.
## Visualizar atualizações de manutenção pendentes
Veja se uma atualização de manutenção está disponível para seu cluster de banco de dados utilizando o console do RDS, a AWS CLI ou a API do RDS. Se estiver disponível, uma atualização será indicada na coluna **Manutenção** do cluster de banco de dados no console do Amazon RDS, conforme mostrado nesta figura.
![\[A ação de manutenção está disponível e será aplicada na próxima janela de manutenção.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/offlinepatchavailable.png)
Se nenhuma atualização de manutenção estiver disponível para um cluster de banco de dados, o valor da coluna será **none**.
Se uma atualização de manutenção estiver disponível para um cluster de banco de dados, os seguintes valores de coluna serão possíveis:
+ **obrigatório** – a ação de manutenção será aplicada ao recurso e não pode ser adiada indefinidamente.
+ **available (disponível)** – a ação de manutenção está disponível, mas não será aplicada automaticamente ao recurso. Você pode aplicá-la manualmente.
+ **next window (próxima janela)** – a ação de manutenção será aplicada ao recurso durante a próxima janela de manutenção.
+ **Em andamento**: a ação de manutenção está sendo aplicada ao recurso.
Se uma atualização estiver disponível, será possível executar uma das seguintes ações:
+ Se o valor de manutenção for **próxima janela**, adie as ações de manutenção escolhendo **Adiar atualização** em **Ações**. Não é possível adiar uma ação de manutenção que já tiver sido iniciada.
+ Aplicar as ações de manutenção imediatamente.
+ Aplique as ações de manutenção durante a próxima janela de manutenção.
+ Não tome nenhuma ação.
**Como realizar uma ação usando o Console de gerenciamento da AWS**
1. Escolha a instância ou cluster de banco de dados para mostrar os detalhes.
1. Escolha **Maintenance & backups (Manutenção e backups)**. As ações de manutenção pendentes são exibidas.
1. Escolha a ação a ser tomada e, em seguida, escolha quando aplicá-la.
![\[Item de manutenção pendente para uma instância de banco de dados do Aurora.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/pending_maintenance_aurora_instance.png)
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. Não há garantia de que as operações de manutenção terminem antes de a janela de manutenção se encerrar, podendo continuar além do tempo de encerramento especificado. Para obter mais informações, consulte [Janela de manutenção do Amazon RDS](#Concepts.DBMaintenance).
Você pode ver se uma atualização de manutenção está disponível para seu cluster de banco de dados executando o comando [describe-pending-maintenance-actions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-pending-maintenance-actions.html) da AWS CLI.
Para ter informações sobre a aplicação de atualizações de manutenção, consulte [Aplicar atualizações para um clusterde banco de dados](#USER_UpgradeDBInstance.OSUpgrades).
### Ações de manutenção do Amazon Aurora
As ações de manutenção a seguir se aplicam a clusters de banco de dados do Aurora:
+ `os-upgrade`: atualize os sistemas operacionais de todas as instâncias de banco de dados no cluster de banco de dados, usando atualizações progressivas. Para obter mais informações, consulte [Atualizações do sistema operacional para clusters de banco de dados do Aurora](#Aurora_OS_updates).
+ `system-update`: aplique patch no mecanismo de banco de dados para o Aurora PostgreSQL.
As ações de manutenção a seguir se aplicam a instâncias de banco de dados do Aurora:
+ `ca-certificate-rotation`: atualize o certificado da Autoridade Certificadora do Amazon RDS para a instância de banco de dados.
+ `hardware-maintenance`: execute a manutenção no hardware subjacente da instância de banco de dados.
+ `system-update`: atualize o sistema operacional da instância de banco de dados.
## Escolher a frequência das atualizações de manutenção do Aurora MySQL
Você pode controlar se as atualizações do Aurora MySQL ocorrem com frequência ou raramente para cada cluster de banco de dados. A melhor opção depende do seu uso do Aurora MySQL e das prioridades das aplicações que são executadas no Aurora. Para saber mais sobre as versões de estabilidade a longo prazo (LTS) do Aurora MySQL que exigem upgrades menos frequentes, consulte [Versões de suporte de longo prazo (LTS) do Aurora MySQL](AuroraMySQL.Update.SpecialVersions.md#AuroraMySQL.Updates.LTS).
Você pode optar por atualizar um cluster Aurora MySQL raramente se algumas ou todas as seguintes condições se aplicarem:
+ O ciclo de testes para o aplicativo exige muito tempo para cada atualização no mecanismo de banco de dados Aurora MySQL.
+ Você tem muitos clusters de banco de dados ou muitos aplicativos, todos em execução na mesma versão do Aurora MySQL. Você prefere atualizar todos os clusters de banco de dados e aplicativos associados ao mesmo tempo.
+ Use o Aurora MySQL e o RDS para MySQL. Você prefere manter os clusters do Aurora MySQL e as instâncias de banco de dados do RDS para MySQL compatíveis com o mesmo nível do MySQL.
+ Seu aplicativo Aurora MySQL está em produção ou é essencial para os negócios. Não é possível permitir tempo de inatividade para atualizações fora de ocorrências raras para patches importantes.
+ O aplicativo Aurora MySQL não é limitado por problemas de performance ou falhas de recursos que são abordados nas versões subsequentes do Aurora MySQL.
Se os fatores anteriores se aplicarem à situação, você poderá limitar o número de atualizações forçadas para um cluster de banco de dados do Aurora MySQL. Você faz isso escolhendo uma versão específica do Aurora MySQL conhecida como versão de "suporte de longo prazo" (LTS) quando cria ou atualiza esse cluster de banco de dados. Isso minimiza o número de ciclos de atualização, ciclos de testes e interrupções relacionadas à atualização para esse cluster de banco de dados.
Você pode optar por atualizar um cluster Aurora MySQL frequentemente se algumas ou todas as seguintes condições se aplicarem:
+ O ciclo de testes para o aplicativo é simples e breve.
+ O aplicativo ainda está na fase de desenvolvimento.
+ O ambiente de banco de dados usa diversas versões do Aurora MySQL ou as versões do Aurora MySQL e do RDS for MySQL. Cada cluster do Aurora MySQL tem seu próprio ciclo de atualização.
+ Você está esperando por melhorias específicas de performance ou recursos antes de aumentar o uso do Aurora MySQL.
Se os fatores anteriores se aplicarem à situação, você poderá habilitar o Aurora para aplicar atualizações importantes com maior frequência. Para fazer isso, atualize um cluster de banco de dados do Aurora MySQL para uma versão mais recente do Aurora MySQL que a versão LTS. Fazer isso disponibiliza os mais recentes aprimoramentos de performance, correções de erros e recursos mais rapidamente.
## Janela de manutenção do Amazon RDS
A janela de manutenção é um intervalo de tempo semanal durante o qual todas as alterações do sistema são aplicadas. Cada cluster de banco de dados tem uma janela de manutenção semanal. A janela de manutenção é uma oportunidade de controlar quando as modificações e a aplicação de patches de software ocorrem. Para ter mais informações sobre como ajustar a janela de manutenção, consulte [Ajustar a janela de manutenção do cluster de banco de dados preferencial](#AdjustingTheMaintenanceWindow.Aurora).
O RDS consome alguns dos recursos em seu cluster de banco de dados enquanto a manutenção é aplicada. Você poderá observar um impacto mínimo na performance. Quanto a uma instância de banco de dados, em raras ocasiões, pode ser necessário realizar um failover Multi-AZ para concluir uma atualização de manutenção.
Se um evento de manutenção estiver programado para determinada semana, ele será 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 é pausada quando o cluster de banco de dados é interrompido.
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 ao criar o cluster de banco de dados, o RDS atribuirá uma janela de manutenção de 30 minutos em um dia da semana selecionado aleatoriamente.
A tabela a seguir mostra os blocos de tempo de cada Região da AWS dos quais as janelas de manutenção padrão são atribuídas.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html)
**Topics**
+ [
### Ajustar a janela de manutenção do cluster de banco de dados preferencial
](#AdjustingTheMaintenanceWindow.Aurora)
### Ajustar a janela de manutenção do cluster de banco de dados preferencial
A janela de manutenção do cluster de banco de dados do Aurora deve ser definida no horário de menor utilização e, portanto, talvez precise ser modificada de vez em quando. Seu cluster de banco de dados ficará indisponível durante esse período apenas se as atualizações aplicadas exigirem uma interrupção. A interrupção ocorre durante o tempo mínimo necessário para fazer as atualizações necessárias.
**nota**
Para atualizações no mecanismo de banco de dados, o Amazon Aurora gerencia a janela de manutenção preferencial de um cluster de banco de dados e não de instâncias individuais.
#### Console
**Para ajustar a janela de manutenção do cluster de banco de dados preferencial**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Databases (Bancos de dados)**.
1. Escolha o cluster de banco de dados para o qual deseja alterar a janela de manutenção.
1. Selecione **Modify**.
1. Na seção **Maintenance (Manutenção)**, atualize a janela de manutenção.
1. Escolha **Continue**.
Na página de confirmação, revise suas alterações.
1. Para aplicar as alterações à janela de manutenção imediatamente, escolha **Immediately (Imediatamente)** na seção **Schedule of modifications (Programação de modificações)**.
1. Selecione **Modify cluster (Modificar cluster)** para salvar suas alterações.
Como alternativa, escolha **Back (Voltar)** para editar suas alterações ou escolha **Cancel (Cancelar)** para cancelar as alterações.
#### AWS CLI
Para ajustar a janela de manutenção do cluster de banco de dados preferencial, use o comando [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) da `modify-db-cluster` com os seguintes parâmetros:
+ `--db-cluster-identifier`
+ `--preferred-maintenance-window`
**Example**
O exemplo de código a seguir define a janela de manutenção como terças, das 4h–4h30 UTC.
Para Linux, macOS ou Unix:
```
aws rds modify-db-cluster \
--db-cluster-identifier my-cluster \
--preferred-maintenance-window Tue:04:00-Tue:04:30
```
Para Windows:
```
aws rds modify-db-cluster ^
--db-cluster-identifier my-cluster ^
--preferred-maintenance-window Tue:04:00-Tue:04:30
```
#### API do RDS
Para ajustar a janela de manutenção do cluster de banco de dados de sua preferência, use a operação [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) da API do Amazon RDS com os seguintes parâmetros:
+ `DBClusterIdentifier`
+ `PreferredMaintenanceWindow`
## Aplicar atualizações para um clusterde banco de dados
Com o Amazon RDS, você pode escolher quando aplicar operações de manutenção. Você pode decidir quando o Amazon RDS aplicará atualizações usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS.
### Console
**Para gerenciar uma atualização de um cluster de banco de dados**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Databases (Bancos de dados)**.
1. Escolha o cluster de banco de dados que exige uma atualização obrigatória.
1. Em **Actions (Ações)**, escolha uma das seguinte opções:
+ **Aplicar patch agora**
+ **Aplicar patch na próxima janela**
**nota**
Se escolher **Aplicar patch na próxima janela** e depois quiser atrasar a atualização do sistema operacional, você poderá escolher **Adiar atualização**. Não é possível adiar uma ação de manutenção que já tiver sido iniciada.
Para cancelar uma ação de manutenção, modifique a instância de banco de dados e desative **Auto minor version upgrade (Atualização automática da versão secundária)**.
### AWS CLI
Para aplicar uma atualização pendente a um cluster de banco de dados, use o comando [apply-pending-maintenance-action](https://docs.aws.amazon.com/cli/latest/reference/rds/apply-pending-maintenance-action.html) da AWS CLI.
**Example**
Para Linux, macOS ou Unix:
```
aws rds apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-west-2:001234567890:db:mysql-db \
--apply-action system-update \
--opt-in-type immediate
```
Para Windows:
```
aws rds apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-west-2:001234567890:db:mysql-db ^
--apply-action system-update ^
--opt-in-type immediate
```
**nota**
Para adiar uma ação de manutenção, especifique `undo-opt-in` para `--opt-in-type`. Não será possível especificar `undo-opt-in` para `--opt-in-type` se a ação de manutenção já tiver sido iniciada.
Para cancelar uma ação de manutenção, execute o comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) da AWS CLI e especifique `--no-auto-minor-version-upgrade`.
Para retornar uma lista de recursos que tenham pelo menos uma atualização pendente, use o comando [describe-pending-maintenance-actions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-pending-maintenance-actions.html) da AWS CLI.
**Example**
Para Linux, macOS ou Unix:
```
aws rds describe-pending-maintenance-actions \
--resource-identifier arn:aws:rds:us-west-2:001234567890:db:mysql-db
```
Para Windows:
```
aws rds describe-pending-maintenance-actions ^
--resource-identifier arn:aws:rds:us-west-2:001234567890:db:mysql-db
```
Você também pode exibir uma lista de recursos para um cluster de banco de dados especificando o parâmetro `--filters` do comando `describe-pending-maintenance-actions` da AWS CLI. O formato do comando `--filters` é `Name=filter-name,Value=resource-id,...`.
Os valores a seguir são os valores aceitos para o parâmetro `Name` de um filtro:
+ `db-instance-id` – aceita uma lista de identificadores de instância de banco de dados ou nomes de recurso da Amazon (ARNs). A lista retornada inclui apenas ações de manutenção pendentes para as instâncias de bancos de dados identificadas por esses identificadores ou ARNs.
+ `db-cluster-id` – aceita uma lista de identificadores de cluster de banco de dados ou ARNs para o Amazon Aurora. A lista retornada inclui apenas ações de manutenção pendentes para os clusters de bancos de dados identificados por esses identificadores ou ARNs.
Por exemplo, o exemplo a seguir retorna as ações de manutenção pendentes para os clusters de banco de dados `sample-cluster1` e `sample-cluster2`.
**Example**
Para Linux, macOS ou Unix:
```
aws rds describe-pending-maintenance-actions \
--filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2
```
Para Windows:
```
aws rds describe-pending-maintenance-actions ^
--filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2
```
### API do RDS
Para aplicar uma atualização a um cluster de banco de dados, chame a operação [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ApplyPendingMaintenanceAction.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ApplyPendingMaintenanceAction.html) da API do Amazon RDS.
Para retornar uma lista de recursos que tenham pelo menos uma atualização pendente, chame a operação [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribePendingMaintenanceActions.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribePendingMaintenanceActions.html) da API do Amazon RDS.
## Atualizações da versão secundária automáticas para clusters de banco de dados do Aurora
A configuração **Upgrade automático de versões secundárias** especifica se o Aurora aplica upgrades automaticamente em seu cluster. Esses upgrades incluem novas versões secundárias que contêm atributos adicionais e patches que contêm correções de bugs.
As atualizações automáticas de versões secundárias atualizam periodicamente o banco de dados para versões recentes do respectivo mecanismo. No entanto, a atualização nem sempre inclui a versão mais recente do mecanismo de banco de dados. Se precisar manter seus bancos de dados em determinadas versões em momentos específicos, recomendamos atualizar manualmente para as versões de banco de dados necessárias de acordo com o cronograma exigido. Em casos de problemas críticos de segurança ou quando uma versão atinge a data de fim do suporte, o Amazon Aurora pode aplicar uma atualização de versão secundária, mesmo que você não tenha habilitado a opção **Upgrade automático de versões secundárias**. Para ter mais informações, consulte a documentação sobre atualização do seu mecanismo de banco de dados específico.
Consulte [Atualizando a versão secundária ou o nível de patch de um cluster de banco de dados de Aurora MySQL](AuroraMySQL.Updates.Patching.md) e [Realizar uma atualização da versão secundária](USER_UpgradeDBInstance.PostgreSQL.MinorUpgrade.md).
**nota**
O Aurora Global Database não é compatível com atualizações automáticas de versões secundárias.
Essa configuração está ativada por padrão. Para cada novo cluster de banco de dados, selecione o valor apropriado para essa configuração. Esse valor é baseado em sua importância, tempo de vida esperado e a quantidade de testes de verificação que você faz após cada atualização.
Para obter instruções sobre como ativar ou desativar a configuração **Upgrade automático de versões secundárias**, consulte o seguinte:
+ [Ativar upgrades automáticos de versões secundárias para um cluster de banco de dados do Aurora](#aurora-amvu-cluster)
+ [Ativar upgrades automáticos de versões secundárias para instâncias individuais em um cluster de banco de dados do Aurora](#aurora-amvu-instance)
**Importante**
É altamente recomendável que, para clusters de banco de dados novos e existentes, você aplique essa configuração ao cluster de banco de dados e não às instâncias de banco de dados do cluster individualmente. Se alguma instância de banco de dados em seu cluster tiver essa configuração desativada, o cluster de banco de dados não receberá upgrade automaticamente.
A tabela a seguir mostra como a configuração **Upgrade automático de versões secundárias** funciona quando aplicada nos níveis de cluster e instância.
| Ação | Configuração do cluster | Configurações das instâncias | O cluster recebe upgrade automaticamente? |
| --- | --- | --- | --- |
| Você define como True no cluster de banco de dados. | Verdadeiro | True para todas as instâncias novas e existentes | Sim |
| Você define como False no cluster de banco de dados. | Falso | False para todas as instâncias novas e existentes | Não |
| Já estava definido como True no cluster de banco de dados. Você define como False em pelo menos uma instância de banco de dados. | Muda para False | False para uma ou mais instâncias | Não |
| Já estava definido como False no cluster de banco de dados. Você define como True em pelo menos uma instância de banco de dados, mas não em todas as instâncias. | Falso | True para uma ou mais instâncias, mas não para todas as instâncias | Não |
| Já estava definido como False no cluster de banco de dados. Você define como True em todas as instâncias de banco de dados. | Muda para True | True para todas as instâncias | Sim |
As atualizações automáticas de versões secundárias são comunicadas com antecedência por meio de um evento de cluster de banco de dados do Amazon RDS com a categoria `maintenance` e o ID `RDS-EVENT-0156`. Para obter mais informações, consulte [Categorias de eventos e mensagens de eventos para o Amazon RDS](USER_Events.Messages.md).
Os upgrades automáticos ocorrem durante as janelas de manutenção. Se as instâncias de banco de dados individuais no cluster de banco de dados tiverem janelas de manutenção diferentes da janela de manutenção do cluster, a janela de manutenção do cluster terá precedência.
Para ter mais informações sobre atualizações de mecanismos para o Aurora PostgreSQL, consulte [Atualizações do mecanismo de banco de dados do Amazon Aurora PostgreSQL](AuroraPostgreSQL.Updates.md).
Para ter mais informações sobre a configuração **Auto minor version upgrade (Atualização automática de versão secundária)** para o Aurora MySQL, consulte [Habilitar atualizações automáticas entre versões secundárias do Aurora MySQL](AuroraMySQL.Updates.AMVU.md). Para obter informações gerais sobre atualizações de mecanismos para o Aurora MySQL, consulte [Atualizações do mecanismo de banco de dados Amazon Aurora MySQLSuporte de longo prazo (LTS) e versões beta do Amazon Aurora MySQL](AuroraMySQL.Updates.md).
**Topics**
### Ativar upgrades automáticos de versões secundárias para um cluster de banco de dados do Aurora
Siga o procedimento geral em [Modificar o cluster de banco de dados usando o console, a CLI e a API](Aurora.Modifying.md#Aurora.Modifying.Cluster).
**Console**
Na seção **Manutenção** da página **Modificar cluster de banco de dados**, marque a caixa de seleção **Habilitar o upgrade automático da versão secundária**.
**AWS CLI**
Chame o comando [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) da AWS CLI. Especifique o nome do cluster de banco de dados para a opção `--db-cluster-identifier` e `true` para a opção `--auto-minor-version-upgrade`. Opcionalmente, especifique a opção `--apply-immediately` para habilitar imediatamente essa configuração para o cluster de banco de dados.
**API do RDS**
Chame a operação de API [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) e especifique o nome do cluster de banco de dados para o parâmetro `DBClusterIdentifier` e `true` para o parâmetro `AutoMinorVersionUpgrade`. Opcionalmente, defina o parâmetro `ApplyImmediately` como `true` para habilitar imediatamente essa configuração para o cluster de banco de dados.
### Ativar upgrades automáticos de versões secundárias para instâncias individuais em um cluster de banco de dados do Aurora
Siga o procedimento geral em [Modificar uma instância de banco de dados em um cluster de banco de dados](Aurora.Modifying.md#Aurora.Modifying.Instance).
**Console**
Na seção **Manutenção** da página **Modificar instância de banco de dados**, marque a caixa de seleção **Habilitar o upgrade automático da versão secundária**.
**AWS CLI**
Chame o comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) da AWS CLI. Especifique o nome da instância de banco de dados para a opção `--db-instance-identifier` e `true` para a opção `--auto-minor-version-upgrade`. Opcionalmente, especifique a opção `--apply-immediately` para habilitar imediatamente essa configuração para sua instância de banco de dados. Execute um comando `modify-db-instance` separado para cada instância de banco de dados no cluster.
**API do RDS**
Chame a operação de API [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) e especifique o nome do cluster de banco de dados para o parâmetro `DBInstanceIdentifier` e `true` para o parâmetro `AutoMinorVersionUpgrade`. Opcionalmente, defina o parâmetro `ApplyImmediately` como `true` para habilitar imediatamente essa configuração para sua instância de banco de dados. Chame uma operação `ModifyDBInstance` separada para cada instância de banco de dados no cluster.
É possível usar um comando de CLI como o seguinte para conferir o status da configuração `AutoMinorVersionUpgrade` para todas as instâncias de banco de dados em seus clusters do Aurora MySQL.
```
aws rds describe-db-instances \
--query '*[].{DBClusterIdentifier:DBClusterIdentifier,DBInstanceIdentifier:DBInstanceIdentifier,AutoMinorVersionUpgrade:AutoMinorVersionUpgrade}'
```
Esse comando gerará uma saída semelhante à seguinte:
```
[
{
"DBInstanceIdentifier": "db-writer-instance",
"DBClusterIdentifier": "my-db-cluster-57",
"AutoMinorVersionUpgrade": true
},
{
"DBInstanceIdentifier": "db-reader-instance1",
"DBClusterIdentifier": "my-db-cluster-57",
"AutoMinorVersionUpgrade": false
},
{
"DBInstanceIdentifier": "db-writer-instance2",
"DBClusterIdentifier": "my-db-cluster-80",
"AutoMinorVersionUpgrade": true
},
... output omitted ...
```
Neste exemplo, a opção **Habilitar atualização automática da versão secundária** está desativada para o cluster de banco de dados `my-db-cluster-57` porque está desativada para uma das instâncias de banco de dados no cluster.
## Atualizações do sistema operacional para clusters de banco de dados do Aurora
As instâncias de banco de dados nos clusters de banco de dados do Aurora MySQL e do Aurora PostgreSQL ocasionalmente exigem atualizações do sistema operacional. O Amazon RDS faz upgrade do sistema operacional para uma versão mais recente para melhorar o desempenho do banco de dados e o procedimento de segurança geral dos clientes. Em geral, essas atualizações demoram cerca de dez minutos. As atualizações do sistema operacional não alteram a versão do mecanismo de banco de dados nem a classe de uma instância de banco de dados.
Há dois tipos de atualização do sistema operacional, diferenciados pela descrição da ação de manutenção pendente:
+ **Atualização da distribuição do sistema operacional**: usada para migrar para a versão principal mais recente compatível do Amazon Linux. A descrição é `New Operating System upgrade is available`.
+ **Patch do sistema operacional**: usado para aplicar várias correções de segurança e, às vezes, para melhorar a performance do banco de dados. A descrição é `New Operating System patch is available`.
As atualizações do sistema operacional podem ser opcionais ou obrigatórias:
+ Uma **atualização opcional** pode ser aplicada a qualquer momento. Embora essas atualizações sejam opcionais, recomendamos que você as aplique periodicamente para manter sua frota do RDS atualizada. O RDS *não* aplica essas atualizações automaticamente.
Para ser notificado quando um novo patch opcional do sistema operacional estiver disponível, você poderá assinar o [RDS-EVENT-0230](USER_Events.Messages.md#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 RDS, consulte [Inscrever-se em notificações de eventos do Amazon RDS](USER_Events.Subscribing.md).
**nota**
`RDS-EVENT-0230` não se aplica às atualizações de distribuição do sistema operacional.
+ É necessária uma **atualização obrigatória** e enviamos uma notificação antes da atualização obrigatória. A notificação pode conter um prazo. Agende sua atualização para antes desse prazo. Após a data de prazo especificada, o Amazon RDS atualiza automaticamente o sistema operacional da instância de banco de dados para a versão mais recente durante uma das janelas de manutenção atribuídas.
Os upgrades da distribuição do sistema operacional são obrigatórios.
**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 RDS rotineiramente durante suas janelas de manutenção.
Para clusters de banco de dados do Aurora, você pode usar a opção de manutenção em **nível de cluster** para realizar atualizações do sistema operacional (SO). Encontre a opção de realizar atualizações em nível de cluster na guia **Manutenção e backups** ao selecionar o nome do cluster de banco de dados no console ou usar o comando `os-upgrade` na AWS CLI. Esse método preserva a disponibilidade de leitura com atualizações contínuas que aplicam automaticamente as atualizações a algumas instâncias de banco de dados de leitura por vez. Para evitar vários failovers e reduzir o tempo de inatividade desnecessário, o Aurora atualiza a instância de banco de dados de gravador por último.
As atualizações do sistema operacional em nível de cluster ocorrem durante a janela de manutenção especificada para o cluster. Isso garante atualizações coordenadas para todo o cluster.
Para oferecer compatibilidade com versões anteriores, o Aurora também mantém a opção de manutenção em nível de **instância**. No entanto, recomendamos o uso de atualizações em nível de cluster. Se você precisar usar as atualizações em nível de instância, atualize primeiro as instâncias de banco de dados de leitor em um cluster de banco de dados e, depois, a instância de banco de dados de gravador. Se você atualizar as instâncias de leitor e de gravador simultaneamente, aumentará a chance de tempo de inatividade relacionado ao failover. Encontre a opção de realizar atualizações em nível de instância na guia **Manutenção e backups** ao selecionar o nome da instância de banco de dados no console ou usar o comando `system-update` na AWS CLI.
As atualizações do sistema operacional em nível da instância ocorrem durante a janela de manutenção que você especificou para cada instância em questão. Por exemplo, se o cluster e duas instâncias de leitor tiverem horários de janela de manutenção diferentes, a atualização do SO em nível de cluster se alinhará à janela de manutenção do cluster.
É possível usar o Console de gerenciamento da AWS ou a AWS CLI para obter informações sobre o tipo de atualização do sistema operacional.
### Console
**Como obter informações de atualização usando o Console de gerenciamento da AWS**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Databases** (Bancos de dados) e, depois, a instância de banco de dados.
1. Escolha **Maintenance & backups (Manutenção e backups)**.
1. Na seção **Manutenção pendente**, encontre a atualização do sistema operacional e confira o valor **Descrição**.
As imagens a seguir mostram um cluster de banco de dados com uma instância de banco de dados de gravador que tem um patch de sistema operacional disponível.
![\[Patch do sistema operacional no nível do cluster.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/os-upgrade-cluster-minor.png)
![\[Patch do sistema operacional no nível da instância.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/os-upgrade-writer-minor.png)
As imagens a seguir mostram um cluster de banco de dados com uma instância de banco de dados de gravador e uma instância de banco de dados de leitor. A instância do gravador tem uma atualização obrigatória do sistema operacional disponível. A instância do leitor tem um patch do sistema operacional disponível.
![\[Atualização da distribuição do sistema operacional no nível do cluster.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/os-upgrade-cluster-major.png)
![\[Atualização da distribuição do sistema operacional da instância do gravador.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/os-upgrade-writer-major.png)
![\[Patch do sistema operacional da instância do leitor.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/os-upgrade-reader-minor.png)
### AWS CLI
Para obter informações de atualização da AWS CLI, use o comando [describe-pending-maintenance-actions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-pending-maintenance-actions.html).
```
aws rds describe-pending-maintenance-actions
```
A saída a seguir mostra uma atualização da distribuição do sistema operacional para um cluster de banco de dados e uma instância de banco de dados.
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:t3",
"PendingMaintenanceActionDetails": [
{
"Action": "os-upgrade",
"Description": "New Operating System upgrade is available"
}
]
},
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:db:t3-instance1",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"Description": "New Operating System upgrade is available"
}
]
},
]
}
```
A saída a seguir mostra um patch do sistema operacional para uma instância de banco de dados.
```
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:db:mydb2",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"Description": "New Operating System patch is available"
}
]
}
```
### Disponibilidade de atualizações do sistema operacional
As atualizações do sistema operacional são específicas da versão do mecanismo de banco de dados e da classe de instância de banco de dados. Portanto, as instâncias de banco de dados recebem ou exigem atualizações em momentos diferentes. Quando uma atualização do sistema operacional estiver disponível para sua instância de banco de dados com base na versão do mecanismo e na classe de instância de banco de dados, essa atualização aparecerá no console. Ela também pode ser visualizada executando o comando [describe-pending-maintenance-actions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-pending-maintenance-actions.html) AWS CLI ou chamando a operação [DescribePendingMaintenanceActions](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribePendingMaintenanceActions.html) da API do RDS. Se houver uma atualização disponível para sua instância, você poderá atualizar o sistema operacional seguindo as instruções em [Aplicar atualizações para um clusterde banco de dados](#USER_UpgradeDBInstance.OSUpgrades).
# Usar a política de implementação de atualização do AWS Organizations para atualizações automáticas de versões secundárias
O Aurora comporta a política de implementação de atualizações do AWS Organizations para gerenciar atualizações automáticas de versões secundárias em vários recursos de banco de dados e Contas da AWS. Essa política ajuda você a implementar uma estratégia de atualização controlada para seus clusters por meio de:
**Como funciona a política de implementação de atualizações**
Quando uma nova versão secundária do mecanismo se torna elegível para atualização automática, a política controla a sequência de atualização com base em ordens definidas:
+ Os recursos marcados como [primeiros] (normalmente ambientes de desenvolvimento) se tornam elegíveis para atualizações durante suas janelas de manutenção.
+ Depois de um tempo de incorporação designado, os recursos marcados como [segundo] se tornam elegíveis.
+ Depois de outro tempo de incorporação designado, os recursos marcados como [últimos] (normalmente ambientes de produção) se tornam elegíveis.
+ Monitorar o andamento da atualização por meio de notificações de integridade da AWS.
Você pode definir a ordem das atualizações da seguinte forma:
+ Políticas em nível de conta: aplicam-se a todos os recursos elegíveis em contas específicas.
+ Tags de recursos: aplicam-se a recursos específicos com base em tags.
**nota**
Os recursos não configurados com uma política de atualização ou excluídos da política recebem automaticamente uma ordem de atualização de [segundo].
**Pré-requisitos**
+ Sua Conta da AWS deve fazer parte de uma organização em Organizations com a política de implementação de atualizações habilitada.
+ Habilitar atualizações automáticas da versão secundária de clusters
+ As tags não são estritamente necessárias para a política de implementação de atualizações. Se quiser definir ordens de atualização específicas para diferentes ambientes (por exemplo, desenvolvimento, teste, controle de qualidade e produção), você pode usar tags. Se você não incluir configurações de tag em sua política, todos os recursos dela seguirão a ordem de atualização padrão. No caso de recursos do Aurora, somente tags em nível de cluster são usadas para a política de implementação de atualizações, mesmo se você tiver tags definidas em nível de instância.
**Como marcar seus recursos**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Bancos de dados**.
1. Escolha o cluster que você deseja marcar.
1. Escolha **Actions** e, em seguida, escolha **Manage tags**.
1. Escolha **Adicionar Tag**.
1. Insira a chave da tag (por exemplo, “Ambiente”) e o valor (por exemplo, “Desenvolvimento”).
1. Escolha **Adicionar tag** e, depois, **Salvar**.
Você também pode adicionar tags usando a AWS CLI:
```
aws rds add-tags-to-resource \
--resource-name arn:aws:rds:region:account-number:cluster:cluster-name \
--tags Key=Environment,Value=Development
```
## Ordem e fases de atualização
A política de implementação de atualizações aceita três ordens de atualização:
+ [primeiro]: normalmente usado para ambientes de desenvolvimento ou teste.
+ [segundo]: normalmente usado para ambientes de controle de qualidade. Ordem padrão dos recursos se a política não estiver configurada especificamente.
+ [último]: normalmente reservado para ambientes de produção.
Quando uma nova versão secundária do mecanismo se torna elegível para atualização automática:
+ Os recursos com ordem de atualização [primeiro] se tornam elegíveis para atualizações durante as janelas de manutenção configuradas.
+ Após um tempo de incorporação, os recursos com ordem de atualização [primeiro] se tornam elegíveis para atualizações durante as janelas de manutenção.
+ Após outro tempo de incorporação, os recursos com ordem de atualização [último] se tornam elegíveis para atualizações durante as janelas de manutenção.
+ A campanha automática de atualização de versão secundária é encerrada após todos os recursos elegíveis com ordens de atualização [primeiro], [segundo] e [último] terem sido atualizados, ou quando a campanha atinge a data de término programada, o que ocorrer primeiro.
**nota**
Todas as atualizações automáticas de versões secundárias são realizadas durante a janela de manutenção configurada de cada cluster para minimizar o possível impacto em suas aplicações.
## Observabilidade
### Integridade e monitoramento da AWS
Você recebe notificações de integridade da AWS:
+ Antes de iniciar uma campanha de atualização automática de versão secundária.
+ Entre cada transição de fase para ajudar a acompanhar e monitorar o andamento da atualização.
+ Atualizações de andamento mostrando o número de recursos atualizados em sua frota no console de integridade da AWS.
Notificações de eventos do Amazon RDS:
+ Notificações de recursos habilitados para atualizações automáticas de versões secundárias, incluindo:
+ Quando seu recurso se torna elegível para atualização com base em sua ordem de atualização ([primeiro], [segundo] ou [último]).
+ Cronograma de atualizações programadas durante a janela de manutenção
+ Status de conclusão e início de atualização de banco de dados individual
+ Assine esses eventos por meio do Amazon EventBridge0 para monitoramento automatizado.
### Considerações
Algumas questões a serem levadas em consideração:
+ A política se aplica a todas as futuras campanhas automáticas de atualização de versões secundárias, incluindo alterações de política feitas durante campanhas ativas.
+ Se você participar de uma campanha de atualização em andamento, seus recursos seguirão a ordem atual de atualização em execução e não esperarão por uma política configurada.
+ Os recursos não configurados com uma política de atualização ou excluídos da política recebem automaticamente uma ordem de atualização de [segundo].
+ A política fornece períodos de validação entre as fases de atualização antes de prosseguir para a próxima fase.
+ As alterações na política ou nas tags de recursos exigem tempo para serem propagadas antes que a nova ordem de atualização seja aplicada.
+ A política se aplica somente aos recursos do Aurora com atualizações automáticas de versões secundárias habilitadas.
+ Se você detectar um problema em um ambiente, poderá desativar as atualizações automáticas de versões secundárias para ambientes subsequentes ou usar o período de validação para resolver problemas antes que as atualizações prossigam para a próxima ordem de atualização.
Para acessar mais informações sobre como marcar recursos do RDS, consulte [Marcar recursos do Amazon Aurora e do Amazon RDS](USER_Tagging.md). Para acessar instruções detalhadas sobre como configurar e usar a política de implementação de atualizações, consulte [Introdução ao AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started.html) no *Guia do usuário do AWS Organizations*.