Guia de início rápido: clusters globais - Amazon DocumentDB
ConfiguraçãoCriar um cluster globalAdição de uma região a um cluster globalCompartilhar um snapshot

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á.

Guia de início rápido: clusters globais

Configuração

O cluster global do Amazon DocumentDB abrange pelo menos dois Regiões da AWS. A região primária oferece suporte a um cluster que tem uma instância primária (gravadora) e até 15 instâncias de réplica, enquanto uma região secundária executa um cluster somente de leitura composto inteiramente por até 16 instâncias de réplica. Um cluster global pode ter até cinco regiões secundárias. A tabela lista o máximo de clusters, instâncias e réplicas permitidos em um cluster global.

Descrição principal Região da AWS Região da AWS secundário
Clusters 1 5 (máximo)
Instâncias do gravador 1 0
Instâncias somente leitura (réplicas do Amazon DocumentDB), por cluster 15 (máximo) 16 (total)
Instâncias somente leitura (máximo permitido, considerando o número real de regiões secundárias) 15 - s s = número total de secundárias Regiões da AWS

Os clusters têm os seguintes requisitos específicos:

  • Requisitos de classe de instância de banco de dados — Você só pode usar as classes de instância db.r5 e db.r6g.

  • Requisitos do Região da AWS: o cluster primário deve estar em uma região e pelo menos um cluster secundário deve estar em uma região diferente da mesma conta. É possível criar até cinco clusters secundários (somente de leitura), e cada um deve estar em uma região diferente. Em outras palavras, não pode haver dois clusters na mesma região.

  • Requisitos de nome: os nomes escolhidos para cada um de seus clusters devem ser exclusivos em todas as regiões. Não é possível usar o mesmo nome para clusters diferentes, mesmo que eles estejam em regiões diferentes.

Criação de um cluster global do Amazon DocumentDB

Você está pronto para criar seu primeiro cluster global? Nesta seção, explicaremos como criar um novo cluster global com novos clusters e instâncias de banco de dados, usando Console de gerenciamento da AWS ou AWS CLI com as instruções a seguir.

  1. No Console de gerenciamento da AWS, navegue até Amazon DocumentDB.

  2. Ao acessar o console do Amazon DocumentDB, escolha Clusters.

    A página Clusters no console do Amazon DocumentDB.

  3. Escolha Criar.

    O botão Criar, exibido no canto superior direito da tabela Clusters.

  4. Preencha a seção Configuração do formulário Criar cluster do Amazon DocumentDB:

    • Identificador de cluster: você pode inserir um identificador exclusivo para essa instância ou permitir que o Amazon DocumentDB forneça o identificador da instância com base no identificador do cluster.

    • Versão do mecanismo: escolha 4.0.0

    • Classe de instância: escolha db.r5.large

    • Número de instâncias: escolha 3.

    Formulário Opções de configuração para criação de um cluster do Amazon DocumentDB.

  5. Na seção Autenticação, preencha um nome de usuário principal e uma senha mestra.

    Formulário de autenticação para especificação de um nome de usuário principal e senha para um novo cluster do Amazon DocumentDB.

  6. Escolha Exibir configurações avançadas.

    Botão de alternância Exibir configurações avançadas ao lado dos botões Cancelar e Criar cluster.

  7. Na seção Configurações de rede:

    • Mantenha as opções padrão para nuvem privada virtual (VPC) e Grupo de sub-redes.

      Formulário Configurações de rede mostrando as opções de VPC, grupo de sub-redes e grupos de segurança de VPC. Os campos VPC e Grupo de sub-redes têm as opções padrão selecionadas.

    • Em Grupos de segurança de VPC, um padrão (VPC) já deve ter sido adicionado.

      Formulário Configurações de rede mostrando a VPC padrão já adicionada.

    • Insira DocDB no campo Grupos de segurança de VPC e selecione DocDB-Inbound (VFC).

      VFC DocDB-Inbound selecionada no menu suspenso Grupos de segurança de VPC.

  8. Em Opções do cluster e Criptografia em repouso, mantenha as seleções padrão.

    Formulários Opções de cluster e Criptografia em repouso com as opções padrão selecionadas.

  9. Em Backup e Exportações de logs, mantenha as seleções padrão.

    Formulários Backup e Exportação de logs com as opções padrão selecionadas.

  10. Em Manutenção, Tags e Proteção contra exclusão, mantenha as seleções padrão.

    Formulários Manutenção, Tags e Proteção contra exclusão com as opções padrão selecionadas.

  11. Agora clique no botão que diz Criar cluster.

    O botão Criar cluster é exibido no final do processo de criação do cluster.

Para criar um cluster regional do Amazon DocumentDB, chame AWS CLI create-global-cluster. O comando AWS CLI a seguir cria um cluster Amazon DocumentDB chamado global-cluster-id. Para obter mais informações sobre a proteção contra exclusão, consulte Excluir um cluster do Amazon DocumentDB.

Além disso, --engine-version é um parâmetro opcional padrão para a versão mais recente do mecanismo principal. A versão atual do motor principal é 5.0.0. Quando novas versões principais do mecanismo forem lançadas, a versão padrão --engine-version será atualizada para refletir a última versão principal do mecanismo. Dessa forma, para workloads de produção, especialmente aquelas que dependem de scripts, automação ou modelos CloudFormation, recomendamos que você especifique explicitamente a --engine-version para a versão principal pretendida.

Se um db-subnet-group-name ou vpc-security-group-id não for especificado, o Amazon DocumentDB usará o grupo de sub-redes padrão e o grupo de segurança da Amazon VPC para a região em questão.

No exemplo a seguir, substitua cada espaço reservado para entrada do usuário por suas próprias informações.

Para Linux, macOS ou Unix:

aws docdb create-db-cluster \
      --global-cluster-identifier global-cluster-id \
      --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id

Para Windows:

aws docdb create-db-cluster ^
      --global-cluster-identifier global-cluster-id ^
      --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id

A saída dessa operação é semelhante ao seguinte (formato JSON).

{
    "DBCluster": {
        "StorageEncrypted": false,
        "DBClusterMembers": [],
        "Engine": "docdb",
        "DeletionProtection" : "enabled",
        "ClusterCreateTime": "2018-11-26T17:15:19.885Z",
        "DBSubnetGroup": "default",
        "EngineVersion": "4.0.0",
        "MasterUsername": "masteruser",
        "BackupRetentionPeriod": 1,
        "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id",
        "DBClusterIdentifier": "cluster-id",
        "MultiAZ": false,
        "DBClusterParameterGroup": "default.docdb4.0",
        "PreferredBackupWindow": "09:12-09:42",
        "DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
        "PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
        "Port": 27017,
        "Status": "creating",
        "ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
        "AssociatedRoles": [],
        "HostedZoneId": "ZNKXTT8WH85VW",
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-77186e0d",
                "Status": "active"
            }
        ],
        "AvailabilityZones": [
            "us-east-1a",
            "us-east-1c",
            "us-east-1e"
        ],
        "Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
    }
}

Leva alguns minutos para criar o cluster. É possível usar o Console de gerenciamento da AWS ou AWS CLI para monitorar o status do seu cluster. Para obter mais informações, consulte Monitoramento do status de um cluster do Amazon DocumentDB.

Importante

Ao usar o AWS CLI para criar um cluster regional do Amazon DocumentDB, nenhuma instância é criada. Consequentemente, é necessário criar explicitamente uma instância principal e qualquer instância de réplica de que precise. É possível usar o console ou a AWS CLI para criar as instâncias. Para obter mais informações, consulte Adicionar uma instância do Amazon DocumentDB a um cluster e CreateDBCluster na Referência da API do Amazon DocumentDB.

Quando seu cluster regional estiver disponível, será possível adicionar um cluster secundário em outra região com as instruções a seguir: Adicionar um Região da AWS a um cluster global do Amazon DocumentDB. Quando você adicionar uma região, seu cluster regional se tornará seu cluster primário, e você terá um novo cluster secundário na região escolhida.

Adicionar um Região da AWS a um cluster global do Amazon DocumentDB

Um cluster global precisa de pelo menos um cluster secundário em uma região diferente do cluster primário, e é possível adicionar até cinco clusters secundários. Observe que, para cada cluster secundário que você adicionar, deverá reduzir em um o número de réplicas permitidas no cluster primário. Por exemplo, se o seu cluster global tiver cinco regiões secundárias, o cluster primário poderá ter apenas 10 (em vez de 15) réplicas. Para obter mais informações, consulte Requisitos de configuração de um cluster global Amazon DocumentDB.

  1. Faça login usando o Console de gerenciamento da AWS e abra o console do Amazon DocumentDB.

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

    A página Clusters no console do Amazon DocumentDB.

  3. Escolha o cluster ao qual você deseja adicionar ao cluster secundário. Certifique-se de que o cluster seja Available.

    Lista de clusters regionais e globais mostrando o status disponível, com mydocdbglobalcluster destacado.

  4. Selecione a lista suspensa de Ações e escolha Adicionar região.

    A lista suspensa Ações na interface Clusters mostra a opção Adicionar região.

  5. Na página Adicionar uma Região da AWS, escolha a região secundária. Observe que você não pode escolher uma região que já tenha um cluster secundário para o mesmo cluster global. Além disso, não ela pode ser a mesma região que o cluster primário. Se essa for a primeira região que estiver adicionando, também será necessário especificar um identificador de cluster global de sua escolha.

    Escolha uma região secundária usando o menu suspenso em Adicionar um formulário de Região da AWS.

  6. Preencha os campos restantes para o cluster secundário na nova região e selecione Criar cluster. Depois de terminar de adicionar a região, será possível vê-la na lista de Clusters no Console de gerenciamento da AWS.

    Etapas finais da adição de uma região a um cluster, mostrando o formulário de configuração, a estimativa de custo por hora e o botão Criar cluster.

  • Use o comando da CLI create-db-cluster com o nome (--global-cluster-identifier) de seu cluster global. Para outros parâmetros, faça o seguinte:

    • Em --region, escolha uma Região da AWS diferente daquela de sua região principal.

    • Escolha valores específicos para os parâmetros --engine e --engine-version.

    • Para um cluster criptografado, especifique sua Região da AWS principal como a --source-region para criptografia.

O exemplo a seguir cria um novo cluster do Amazon DocumentDB e o anexa ao cluster global como um cluster secundário somente leitura. Na última etapa, a instância é adicionada ao novo cluster.

No exemplo a seguir, substitua cada espaço reservado para entrada do usuário por suas próprias informações.

Para Linux, macOS ou Unix:

aws docdb --region secondary-region-id \
  create-db-cluster \
    --db-cluster-identifier cluster-id \
    --global-cluster-identifier global-cluster-id \
    --engine-version version \
    --engine docdb

aws docdb --region secondary-region-id \
  create-db-instance \
    --db-cluster-identifier cluster-id \
    --global-cluster-identifier global-cluster-id \
    --engine-version version \
    --engine docdb

Para Windows:

aws docdb --region secondary-region-id ^
  create-db-cluster ^
    --db-cluster-identifier cluster-id ^
    --global-cluster-identifier global-cluster-id ^
    --engine-version version ^
    --engine docdb

aws docdb --region secondary-region-id ^
  create-db-instance ^
    --db-cluster-identifier cluster-id ^
    --global-cluster-identifier global-cluster-id ^
    --engine-version version ^
    --engine docdb

Usando um snapshot para seu cluster Amazon DocumentDB global

É possível restaurar um snapshot de um cluster do Amazon DocumentDB para usar como ponto de partida para seu cluster global. Para fazer isso, você deve restaurar o snapshot e criar um novo cluster. Isso servirá como o cluster principal do seu cluster global. Em seguida, adicione uma outra região ao cluster restaurado, transformando-o em um cluster global.