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

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 o Console de gerenciamento da AWS ou o AWS CLI. 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). É possível 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 Determinar 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 Console de gerenciamento da AWS

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 Console de gerenciamento da AWS e abra 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 (Hamburger menu icon with three horizontal lines.) 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.

    Imagem: ações de atualização do Amazon DocumentDB

    • 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

É possível atualizar patches para seu cluster usando a AWS CLI e a operação apply-pending-maintenance-action com os seguintes parâmetros.

Parâmetros

  • --resource-identifier—Obrigatório. O ARN do cluster do 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"
            }
        ]
    }
}