Reinicializar uma instância do Amazon DocumentDB - Amazon DocumentDB

Reinicializar uma instância do Amazon DocumentDB

Ocasionalmente, você pode precisar reinicializar sua instância do Amazon DocumentDB, geralmente por motivos de manutenção. Se você fizer determinadas alterações, como alterar o grupo de parâmetros de cluster associado a um cluster, será necessário reinicializar as instâncias no cluster para que as alterações sejam implantadas. Você pode reinicializar uma instância específica usando o AWS Management Console ou a AWS CLI.

Reinicializar uma instância reinicia o serviço de mecanismo de banco de dados. A reinicialização resulta em uma interrupção momentânea, durante a qual o status da instância é definido como rebooting. Um evento do Amazon DocumentDB é criado quando a reinicialização é concluída.

A reinicialização de uma instância não resulta em um failover. Para executar o failover de um cluster do Amazon DocumentDB, use o AWS Management Console ou a operação AWS CLI da failover-db-cluster. Para ter mais informações, consulte Failover do Amazon DocumentDB.

Você não poderá reinicializar sua instância se ela não estiver no estado disponível. Seu banco de dados pode se tornar indisponível por vários motivos, como uma modificação solicitada anteriormente ou uma ação no intervalo de manutenção. Para obter mais informações sobre os estados da instância, consulte Monitoramento do status de uma instância do Amazon DocumentDB.

Using the AWS Management Console

O procedimento a seguir reinicializa uma instância especificada usando o console.

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

  2. No painel de navegação, escolha Clusters.

    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. Na caixa de navegação Clusters, você verá a coluna Identificador do Cluster. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo.

    DocumentDB clusters list showing two clusters with their identifiers and roles.

  4. Marque a caixa à esquerda da instância que você deseja reinicializar.

  5. Escolha Actions (Ações), escolha Reboot (Reinicializar) e depois Reboot (Reinicializar) para confirmar a reinicialização.

Demora alguns minutos para sua instância reinicializar. É possível usar a instância somente quando seu status for disponível. Você pode monitorar o status da instância usando o console ou a AWS CLI. Para ter mais informações, consulte Monitoramento do status de uma instância do Amazon DocumentDB.

Using the AWS CLI

Para reinicializar uma instância do Amazon DocumentDB, use a operação reboot-db-instance com o parâmetro --db-instance-identifier. Esse parâmetro especifica o identificador da instância a ser reinicializada.

O código a seguir reinicializa a instância sample-instance.

Para Linux, macOS ou Unix:

aws docdb reboot-db-instance \
       --db-instance-identifier sample-instance

Para Windows:

aws docdb reboot-db-instance ^
       --db-instance-identifier sample-instance

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

{
    "DBInstance": {
        "DBInstanceIdentifier": "sample-instance",
        "DBInstanceClass": "db.r5.large",
        "Engine": "docdb",
        "DBInstanceStatus": "rebooting",
        "Endpoint": {
            "Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
            "Port": 27017,   
            "HostedZoneId": "ABCDEFGHIJKLM"
        },
        "InstanceCreateTime": "2020-03-27T08:05:56.314Z",
        "PreferredBackupWindow": "02:00-02:30",
        "BackupRetentionPeriod": 1,
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-abcd0123",
                "Status": "active"
            }
        ],
        "AvailabilityZone": "us-east-1c",
        "DBSubnetGroup": {
            "DBSubnetGroupName": "default",
            "DBSubnetGroupDescription": "default",
            "VpcId": "vpc-abcd0123",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-abcd0123",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-wxyz0123",
                    "SubnetAvailabilityZone": {
                        "Name": "us-east-1b"
                    },
                    "SubnetStatus": "Active"
                }
            ]
        },
        "PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
        "PendingModifiedValues": {},
        "EngineVersion": "3.6.0",
        "AutoMinorVersionUpgrade": true,
        "PubliclyAccessible": false,
        "DBClusterIdentifier": "sample-cluster",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:<accountID>:key/sample-key",
        "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "CACertificateIdentifier": "rds-ca-2019",
        "PromotionTier": 1,
        "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance",
        "EnabledCloudwatchLogsExports": [
            "profiler"
        ]
    }
}

Demora alguns minutos para sua instância reinicializar. É possível usar a instância somente quando seu status for disponível. É possível monitorar o status da instância usando o console ou a AWS CLI. Para ter mais informações, consulte Monitoramento do status de uma instância do Amazon DocumentDB.