Executar uma atualização de patch para a versão do mecanismo de um cluster

Nesta seção, explicaremos como implantar uma atualização de patch usando AWS Management Console o. ou AWS CLI o. Uma atualização de patch é uma atualização dentro da mesma versão do mecanismo (por exemplo, uma versão do mecanismo 3.6 para uma versão mais recente). Você pode atualizá-la imediatamente ou durante a próxima janela de manutenção do cluster. Para determinar se seu mecanismo precisa de uma atualização, consulte Determinando a manutenção pendente. Observe que, ao aplicar a atualização, seu cluster passará por um tempo de inatividade.

nota

Se você estiver tentando atualizar a partir de uma versão principal do mecanismo para outra, como 3.6 para 5.0, consulte Atualização da versão principal implementada do Amazon DocumentDB no local ou Atualizando seu cluster Amazon DocumentDB usando AWS Database Migration Service. Uma atualização local da versão principal oferece suporte apenas ao docdb 5.0 como versão do mecanismo de destino.

Há dois requisitos de configuração para obter as atualizações de patch mais recentes para a versão do mecanismo de um cluster:

• O status do cluster precisa ser disponível.

• O cluster deve estar executando uma versão de mecanismo mais antiga.

Using the AWS Management Console

O procedimento a seguir atualiza a versão de mecanismo do seu cluster para uma versão mais recente usando o console. Você tem a opção de atualizar imediatamente ou durante a próxima janela de manutenção do cluster.

1. Faça login no e abra AWS Management Console o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.

2. No painel de navegação, escolha Clusters. Na lista de clusters, escolha o botão à esquerda do cluster que você deseja atualizar. O status do cluster precisa ser disponível.

   dica

   Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu () no canto superior esquerdo da página.

3. No menu Ações, escolha uma das opções a seguir. Essas opções de menu são selecionáveis somente se o cluster que você escolheu não está executando a versão mais recente do mecanismo.

   

   • Atualizar agora— inicia imediatamente o processo de atualização. Seu cluster ficará offline por um momento, enquanto é atualizado para a versão mais recente do mecanismo.

   • Atualizar na próxima janela— inicia o processo de atualização durante a próxima janela de manutenção do cluster. O cluster ficará offline por um momento, enquanto é atualizado para a versão mais recente do mecanismo.

4. Quando a janela de confirmação for aberta, escolha uma das seguintes opções:

   • Atualizar— para atualizar seu cluster para a versão mais recente do mecanismo, de acordo com a programação escolhida na etapa anterior.

   • Cancelar— para cancelar a atualização do mecanismo do cluster e continuar com a versão atual.

Using the AWS CLI

Você pode aplicar atualizações de patch ao seu cluster usando a apply-pending-maintenance-action operação AWS CLI e a com os parâmetros a seguir.

Parâmetros

• --resource-identifier—Obrigatório. O ARN do cluster Amazon DocumentDB que você vai atualizar.

• --apply-action—Obrigatório. Os valores a seguir são permitidos. Para atualizar a versão de mecanismo do cluster, use db-upgrade.

  • db-upgrade

  • system-update

• --opt-in-type—Obrigatório. Os valores a seguir são permitidos.

  • immediate— aplique a ação de manutenção imediatamente.

  • next-maintenance— aplique a ação de manutenção durante a próxima janela de manutenção.

  • undo-opt-in— cancele quaisquer solicitações de inclusão next-maintenance existentes.

O exemplo a seguir atualiza a versão do mecanismo sample-cluster para a versão 4.0.0.

Para Linux, macOS ou Unix:

aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
   --apply-action db-upgrade \
   --opt-in-type immediate

Para Windows:

aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
   --apply-action db-upgrade ^
   --opt-in-type immediate

A saída dessa operação é semelhante à seguinte.

{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "db-upgrade",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}