Gerenciar um cluster global do Amazon DocumentDB - Amazon DocumentDB
Modificar clusters globaisModificar parâmetrosRemover clusters globaisExcluir clusters globaisClusters sem cabeça

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Gerenciar um cluster global do Amazon DocumentDB

Realize a maVocê realiza a maioria das operações de gerenciamento nos clusters individuais que compõem um cluster global.ioria das operações de gerenciamento nos clusters individuais que constituem um banco de dados global do . Ao selecionar Recursos relacionados ao grupo na página Clusters do console, você verá o cluster primário e os clusters secundários agrupados sob o cluster global associado.

A guia Configuração de um cluster global mostra Regiões da AWS onde os clusters estão sendo executados, a versão e o identificador global do cluster.

Modificar um cluster global do Amazon DocumentDB

A página Clusters na AWS Management Console lista todos os seus clusters globais, mostrando o cluster primário e os clusters secundários de cada um. O cluster global tem suas próprias definições de configuração. Especificamente, ele tem regiões associadas a seus clusters primário e secundário.

Quando você faz alterações no cluster global, você tem a chance de cancelar as alterações.

Quando você escolhe Continue, você confirma as alterações.

Modificando parâmetros de um cluster global do Amazon DocumentDB

Você pode configurar os grupos de parâmetros do cluster independentemente para cada cluster dentro do cluster global. A maioria dos parâmetros funciona da mesma forma que para outros tipos de clusters do Amazon DocumentDB. Recomendamos que você mantenha as configurações consistentes entre todos os clusters em um banco de dados global. Isso ajuda a evitar mudanças inesperadas de comportamento se você promover um cluster secundário para ser o primário.

Por exemplo, use as mesmas configurações para os fusos horários e os conjuntos de caracteres a fim de evitar um comportamento inconsistente caso um cluster diferente assuma como o cluster primário.

Remover um cluster de um cluster global do Amazon DocumentDB

Há várias situações em que você pode querer remover clusters do seu cluster global. Por exemplo, você pode querer remover um cluster de um clster global se o cluster primário se tornar degradado ou isolado. Em seguida, ele se torna um cluster provisionado autônomo que pode ser usado para criar um novo cluster global. Para saber mais, consulte Realizar um failover manual para um cluster global do Amazon DocumentDB.

Você também pode querer remover clusters porque deseja excluir um cluster global que não é mais necessário. Não é possível excluir o cluster global até que você desanexe todos os clusters associados, deixando o primário por último. Para obter mais informações, consulte Exclusão de um cluster global do Amazon DocumentDB.

nota

Quando um cluster é separado do cluster global, ele não é mais sincronizado com o primário. Ele se torna um cluster provisionado autônomo com recursos completos de leitura/escrita. Além disso, ele não está mais visível no console do Amazon DocumentDB. Ela só é visível quando você seleciona a região no console em que o cluster estava localizado.

Você pode remover clusters do seu cluster global usando a AWS Management Console AWS CLI, a ou a API do RDS.

Using the AWS Management Console

  1. Faça login no AWS Management Console e navegue até o console do Amazon DocumentDB.

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

    Imagem: a caixa de navegação Clusters mostrando uma lista dos links de cluster existentes e seus links de instância correspondentes.

  3. Expanda o cluster global para que você possa ver todos os clusters secundários. Selecione os clusters secundários que você deseja remover. Escolha Ações e, no menu suspenso, escolha Remover do global.

    Imagem: a caixa de navegação Clusters mostrando a seleção de um cluster secundário existente e destacando a ação “Remover do global”.

  4. Será exibido um prompt solicitando a confirmação de que você deseja desconectar o secundário do cluster global. Escolha Remover e promover para remover o cluster do cluster global.

    Imagem: o prompt Remover e promover.

Agora esse cluster não está mais servindo como secundário e não está mais sincronizado com o cluster primário. É um cluster autônomo com capacidade total de leitura/escrita.

Depois de remover ou excluir todos os clusters secundários, remova o cluster primário da mesma maneira. Não é possível desanexar ou remover o cluster primário do cluster global até que você tenha removido todos os clusters secundários. O cluster global pode permanecer na lista de clusters, com zero regiões AZs e. Você pode excluir se não quiser mais usar esse cluster global.

Using the AWS CLI

Para remover um cluster de um cluster global, execute o comando CLI remove-from-global-cluster com os seguintes parâmetros:

  • --global-cluster-identifier: o nome (identificador) do seu cluster global.

  • --db-cluster-identifier — O nome de cada cluster a ser removido do cluster global.

Os exemplos a seguir removem primeiro um cluster secundário e depois o cluster primário de um cluster global.

Para Linux, macOS ou Unix:

aws docdb --region secondary_region \
  remove-from-global-cluster \
    --db-cluster-identifier secondary_cluster_ARN \
    --global-cluster-identifier global_cluster_id

aws docdb --region primary_region \
  remove-from-global-cluster \
    --db-cluster-identifier primary_cluster_ARN \
    --global-cluster-identifier global_cluster_id

Repita o comando remove-from-global-cluster --db-cluster-identifier secondary_cluster_ARN para cada região secundária em seu cluster global.

Para Windows:

aws docdb --region secondary_region ^
  remove-from-global-cluster ^
    --db-cluster-identifier secondary_cluster_ARN ^
    --global-cluster-identifier global_cluster_id

aws docdb --region primary_region ^
  remove-from-global-cluster ^
    --db-cluster-identifier primary_cluster_ARN ^
    --global-cluster-identifier global_cluster_id

Repita o comando remove-from-global-cluster --db-cluster-identifier secondary_cluster_ARN para cada região secundária em seu cluster global.

Exclusão de um cluster global do Amazon DocumentDB

Para excluir um cluster global, faça o seguinte:

  • Remova todos os clusters secundários do cluster global. Cada cluster se torna um cluster autônomo. Veja a seção anterior,Remover um cluster de um cluster global do Amazon DocumentDB.

  • Em cada cluster autônomo, exclua todas as réplicas.

  • Remova o cluster primário do cluster global. Isso se torna um cluster autônomo.

  • No cluster primário, primeiro exclua todas as réplicas e, em seguida, exclua a instância primária. A exclusão da instância primária do cluster recém-autônomo também remove, normalmente, o cluster e o cluster global.

Using the AWS Management Console

  1. Faça login no AWS Management Console e navegue até o console do Amazon DocumentDB.

  2. Escolha Clusters e encontre o cluster global que você deseja excluir.

    Imagem: a caixa de navegação Clusters mostrando uma lista dos links de cluster existentes e seus links de instância correspondentes.

  3. Com seu cluster global selecionado, escolha Excluir no menu Ações.

    Imagem: a caixa de navegação Clusters mostrando a seleção de um cluster global e destacando a ação “Excluir”.

Confirme se todos os clusters foram removidos do cluster global. O cluster global deve mostrar zero regiões AZs e um tamanho de zero clusters. Se o cluster global contiver clusters, você ainda não poderá excluí-lo. Primeiro, você precisará seguir as instruções na etapa anterior, Remover um cluster de um cluster global do Amazon DocumentDB.

Using the AWS CLI

Para excluir um cluster global, execute o comando delete-global-cluster CLI com o nome do Região da AWS e o identificador global do cluster, conforme mostrado no exemplo a seguir.

Para Linux, macOS ou Unix:

aws docdb --region primary_region delete-global-cluster \
   --global-cluster-identifier global_cluster_id

Para Windows:

aws docdb --region primary_region delete-global-cluster ^
   --global-cluster-identifier global_cluster_id

Criação de um cluster sem cabeça do Amazon DocumentDB em uma região secundária

Embora um cluster global do Amazon DocumentDB exija pelo menos um cluster secundário em um cluster Região da AWS diferente do primário, você pode usar uma configuração sem cabeçalho para o cluster secundário. Um cluster secundário sem cabeça do Amazon DocumentDB é aquele sem uma instância. Esse tipo de configuração pode reduzir as despesas de um cluster global. Em um cluster do Amazon DocumentDB, a computação e o armazenamento são desacoplados. Sem a instância, você não é cobrado pela computação, apenas pelo armazenamento. Se for configurado corretamente, o volume de armazenamento de um secundário sem cabeça é mantido em sincronia com o cluster primário.

Você adiciona o cluster secundário como normalmente faz ao criar um cluster global do Amazon DocumentDB. No entanto, depois que o cluster primário iniciar a replicação para o secundário, você excluirá a instância somente leitura do cluster secundário. Esse cluster secundário agora é considerado "sem cabeça" porque não tem mais uma instância. No entanto, o volume de armazenamento é mantido em sincronia com o cluster principal do Amazon DocumentDB.

Importante

Recomendamos clusters sem cabeça apenas para clientes que possam tolerar falhas em toda a região por mais de 15 minutos. Isso ocorre porque a recuperação de uma falha em toda a região com um cluster secundário sem cabeça exigirá que o usuário crie uma nova instância após a falha. Uma nova instância pode levar de 10 a 15 minutos para ficar disponível.

Como Adicionar um Cluster Secundário sem Cabeça ao seu Cluster Global

  1. Faça login no AWS Management Console e abra o console do Amazon DocumentDB.

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

  3. Escolha o cluster global que precisa de um cluster secundário. Certifique-se de que o cluster primário seja Available.

  4. Para Ações, selecione Adicionar região.

  5. Na página Adicionar uma região, escolha a região secundária.

    nota

    Não é possível escolher uma região que já tenha um cluster secundário para o mesmo cluster global. Além disso, não pode ser a mesma região que o cluster primário.

  6. Preencha os campos restantes para o cluster secundário na nova região. Essas são as mesmas opções de configuração de qualquer instância de cluster.

  7. Adicionar região. Depois de terminar de adicionar a região ao seu cluster global, você a verá na lista de Clusters no AWS Management Console.

  8. Verifique o status do cluster secundário e de sua instância de leitura antes de continuar, usando o AWS Management Console ou AWS CLI o. Aqui está um exemplo de comando se você usar o AWS CLI: 

    $ aws docdb describe-db-clusters --db-cluster-identifier secondary-cluster-id --query '*[].[Status]' --output text

    Pode levar vários minutos para que o status de um cluster secundário recém-adicionado mude de criado para disponível. Quando o cluster estiver disponível, você poderá excluir a instância do leitor.

  9. Selecione a instância do leitor no cluster secundário e, em seguida, selecione Excluir.

  10. Depois de excluir a instância do leitor, o cluster secundário continua fazendo parte do cluster global. Ele não deve ter nenhuma instância associada a ele.

nota

Você pode usar esse cluster secundário sem cabeça do Amazon DocumentDB para recuperar manualmente o cluster global do Amazon DocumentDB de uma interrupção não planejada na região primária, se essa interrupção ocorrer.