Interromper e iniciar um cluster do Amazon DocumentDB

Interromper e iniciar os clusters do Amazon DocumentDB pode ajudar a gerenciar os custos dos ambientes de teste e desenvolvimento. Em vez de criar e excluir clusters e instâncias toda vez que você usar o Amazon DocumentDB, você pode interromper temporariamente todas as instâncias em seu cluster quando elas não forem necessárias. Depois, é possível iniciá-las novamente, ao retomar os testes.

Visão geral de como interromper e iniciar um cluster

Durante os períodos nos quais não precisar de um cluster do Amazon DocumentDB, você pode interromper todas as instâncias nesse cluster de uma só vez. Depois, você pode iniciar o cluster novamente a qualquer momento, sempre que precisar usá-lo. Iniciar e interromper simplifica os processos de configuração e destruição dos clusters usados em desenvolvimento, teste ou atividades afins que não exijam disponibilidade contínua. É possível interromper e iniciar um cluster usando o Console de gerenciamento da AWS ou a AWS CLI com uma única ação, independentemente de quantas instâncias estão no cluster.

Enquanto o cluster estiver interrompido, o volume de armazenamento do cluster permanece inalterado. Serão cobrados somente o armazenamento, as captura de telas manuais e o armazenamento do backup automatizado dentro da janela de retenção especificada. Não haverá cobrança por horas de instância. O Amazon DocumentDB iniciará automaticamente seu cluster depois de sete dias para garantir que ele não perca nenhuma atualização de manutenção necessária. Quando o cluster reiniciar após sete dias, você será cobrado pelas instâncias novamente. Enquanto o cluster é interrompido, não é possível consultar o volume de armazenamento porque a consulta requer que as instâncias estejam no estado disponível.

Quando um cluster do Amazon DocumentDB é interrompido, nem o cluster nem suas instâncias podem ser modificados, de maneira alguma. Isso inclui adicionar ou remover instâncias, ou excluir o cluster.

Using the Console de gerenciamento da AWS

O procedimento a seguir mostra como interromper um cluster com uma ou mais instâncias no estado disponível ou iniciar um cluster interrompido.

Para interromper ou iniciar um cluster do Amazon DocumentDB

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.

   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. Na lista de clusters, escolha o botão à esquerda do nome do cluster que você deseja interromper ou iniciar.

4. Escolha Ações e selecione a ação que deseja executar no cluster.

   • Se você quiser interromper o cluster e ele estiver disponível:

     1. Escolha Parar.

        

        Para evitar a ativação do mecanismo de failover, a operação de interrupção interrompe primeiro as instâncias de réplica e, depois, a instância primária.

     2. Na caixa de diálogo de confirmação, confirme se deseja interromper o cluster, escolhendo Interromper cluster ou, para manter o cluster em execução, escolha Cancelar.

        

   • Se quiser iniciar o cluster e o cluster estiver interrompido, escolha Iniciar.

     

5. Monitore o status do cluster e suas instâncias. Se você iniciou o cluster, poderá retomar o uso do cluster quando ele e suas instâncias estiverem disponíveis. Para obter mais informações, consulte Determinar o status de um cluster.

   

Using the AWS CLI

Os exemplos de código a seguir mostram como interromper um cluster com uma ou mais instâncias no estado disponível ou iniciar um cluster interrompido.

Para interromper um cluster com uma ou mais instâncias disponíveis usando a AWS CLI, use a operação stop-db-cluster. Para iniciar um cluster interrompido, use a operação start-db-cluster. Ambas as operações usam o parâmetro --db-cluster-identifier.

Parâmetro

• --db-cluster-identifier—Obrigatório. O nome do cluster a ser interrompido ou iniciado.

exemplo — para interromper um cluster usando AWS CLI

O código a seguir interrompe o cluster sample-cluster. O cluster deve ter uma ou mais instâncias no estado disponível.

Para Linux, macOS ou Unix:

aws docdb stop-db-cluster \
   --db-cluster-identifier sample-cluster

Para Windows:

aws docdb stop-db-cluster ^
   --db-cluster-identifier sample-cluster

exemplo — para iniciar um cluster usando AWS CLI

O código a seguir inicia o cluster sample-cluster. O cluster deve estar interrompido no momento.

Para Linux, macOS ou Unix:

aws docdb start-db-cluster \
   --db-cluster-identifier sample-cluster

Para Windows:

aws docdb start-db-cluster ^
   --db-cluster-identifier sample-cluster

Operações que você pode realizar em um cluster interrompido

Com um cluster de banco de dados do Amazon DocumentDB interrompido, você pode executar uma restauração pontual em qualquer ponto dentro da janela de retenção especificada para o backup automático. Para obter detalhes sobre como realizar uma restauração pontual, consulte Restauração para um ponto no tempo.

Não é possível modificar a configuração de um cluster do Amazon DocumentDB, ou de qualquer uma de suas instâncias, enquanto o cluster estiver interrompido. Também não é possível adicionar ou remover instâncias do cluster ou excluir o cluster, caso ainda tenha alguma instância associada. Será necessário iniciar o cluster antes de realizar uma dessas ações administrativas.

O Amazon DocumentDB aplicará as manutenções programadas em seu cluster interrompido somente depois que for reiniciado. Após sete dias, o Amazon DocumentDB inicia automaticamente um cluster interrompido, para que não fique muito atrasado em seu status de manutenção. Quando o cluster for reiniciado, você começará a ser cobrado pelas instâncias no cluster novamente.

Enquanto um cluster estiver interrompido, o Amazon DocumentDB não executa quaisquer backups automatizados, nem estende o período de retenção de backup.