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á.
Tópicos
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é quinze instâncias de réplica, enquanto uma região secundária executa um cluster somente de leitura composto inteiramente por até dezesseis 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 | Primária Região da AWS | Secundário Região da AWS |
|---|---|---|
| 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, dado o número real de regiões secundárias) | 15 - s | s = número total de secundários 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.r5edb.r6. -
Região da AWS requisitos — 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 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 AWS Management Console ou AWS CLI com as instruções a seguir.
-
No AWS Management Console, navegue até Amazon DocumentDB.
-
Ao acessar o console do Amazon DocumentDB, escolha Clusters.
-
Escolha Criar.
-
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.
-
-
Na seção Autenticação, preencha um nome de usuário mestre e uma senha mestra.
-
Escolha Mostrar configurações avançadas.
-
Na seção Configurações de rede:
-
Mantenha as opções padrão para Nuvem privada virtual e Grupo de subrede.
-
Para Grupos de segurança VPC, um VPC padrão deve ter sido adicionado.
-
Digite
DocDBno campo Grupos de segurança VPC e selecione DocDB-Inbound (VPC).
-
-
Para Opções de cluster e E ncryption-at-rest, deixe nas seleções padrão.
-
Para Backup e Exportações de logs, deixe as seleções padrão.
-
Para Manutenção, Tags e Proteção contra exclusão, deixe as seleções padrão.
-
Agora clique no botão que diz Criar.
-
No AWS Management Console, navegue até Amazon DocumentDB.
-
Ao acessar o console do Amazon DocumentDB, escolha Clusters.
-
Escolha Criar.
-
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.
-
-
Na seção Autenticação, preencha um nome de usuário mestre e uma senha mestra.
-
Escolha Mostrar configurações avançadas.
-
Na seção Configurações de rede:
-
Mantenha as opções padrão para Nuvem privada virtual e Grupo de subrede.
-
Para Grupos de segurança VPC, um VPC padrão deve ter sido adicionado.
-
Digite
DocDBno campo Grupos de segurança VPC e selecione DocDB-Inbound (VPC).
-
-
Para Opções de cluster e E ncryption-at-rest, deixe nas seleções padrão.
-
Para Backup e Exportações de logs, deixe as seleções padrão.
-
Para Manutenção, Tags e Proteção contra exclusão, deixe as seleções padrão.
-
Agora clique no botão que diz Criar.
Para criar um cluster regional do Amazon DocumentDB, chame o. create-global-cluster AWS CLIglobal-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 do mecanismo --engine-version será atualizada para refletir a última versão do mecanismo principal. Como resultado, para cargas de trabalho de produção, especialmente aquelas que dependem de scripts, automação ou AWS CloudFormation modelos, recomendamos que você especifique explicitamente a --engine-version para a versão principal pretendida.
Se um db-subnet-group-name ou não vpc-security-group-id for especificado, o Amazon DocumentDB usará o grupo de sub-rede padrão e o grupo de segurança da Amazon VPC para a região em questão.
No exemplo a seguir, substitua cada user input placeholder por suas próprias informações.
Para Linux, macOS ou Unix:
aws docdb create-db-cluster \ --global-cluster-identifierglobal-cluster-id\ --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
Para Windows:
aws docdb create-db-cluster ^ --global-cluster-identifierglobal-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. Você pode usar o AWS Management Console 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
Quando você usa 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. Você pode usar o console ou AWS CLI 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, você pode adicionar um cluster secundário em outra região com as seguintes instruções: Adicionar um Região da AWS a um cluster global do Amazon DocumentDB. Quando você adiciona uma região, seu cluster regional se torna seu cluster primário e você tem 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 você pode 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 dez (em vez de quinze) réplicas. Para obter mais informações, consulte Requisitos de configuração de um cluster global Amazon DocumentDB.
-
Faça login no AWS Management Console e abra o console do Amazon DocumentDB.
-
No painel de navegação, escolha Clusters.
-
Escolha o cluster ao qual você deseja adicionar ao cluster secundário. Certifique-se de que o cluster seja
Available.
-
Selecione o menu suspenso para Ações e escolha Adicionar região.
-
Na página Adicionar uma região, 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 pode ser a mesma região que o cluster primário. Se esta for a primeira região que estiver adicionando, também será necessário especificar um identificador de cluster global de sua escolha.
-
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, você poderá vê-la na lista de Clusters no AWS Management Console.
-
Faça login no AWS Management Console e abra o console do Amazon DocumentDB.
-
No painel de navegação, escolha Clusters.
-
Escolha o cluster ao qual você deseja adicionar ao cluster secundário. Certifique-se de que o cluster seja
Available.
-
Selecione o menu suspenso para Ações e escolha Adicionar região.
-
Na página Adicionar uma região, 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 pode ser a mesma região que o cluster primário. Se esta for a primeira região que estiver adicionando, também será necessário especificar um identificador de cluster global de sua escolha.
-
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, você poderá vê-la na lista de Clusters no AWS Management Console.
-
Use o comando da CLI
create-db-clustercom o nome(--global-cluster-identifier)de seu cluster global. Para outros parâmetros, faça o seguinte:-
Para
--region, escolha uma região Região da AWS diferente da sua região principal. -
Escolha valores específicos para os parâmetros
--enginee--engine-version. -
Para um cluster criptografado, especifique seu primário Região da AWS como o
--source-regionde 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 user input placeholder por suas próprias informações.
Para Linux, macOS ou Unix:
aws docdb --regionsecondary-region-id\ create-db-cluster \ --db-cluster-identifiercluster-id\ --global-cluster-identifierglobal-cluster-id\ --engine-versionversion\ --engine docdb aws docdb --regionsecondary-region-id\ create-db-instance \ --db-cluster-identifiercluster-id\ --global-cluster-identifierglobal-cluster-id\ --engine-versionversion\ --engine docdb
Para Windows:
aws docdb --regionsecondary-region-id^ create-db-cluster ^ --db-cluster-identifiercluster-id^ --global-cluster-identifierglobal-cluster-id^ --engine-versionversion^ --engine docdb aws docdb --regionsecondary-region-id^ create-db-instance ^ --db-cluster-identifiercluster-id^ --global-cluster-identifierglobal-cluster-id^ --engine-versionversion^ --engine docdb
Usando um snapshot para seu cluster Amazon DocumentDB global
Você pode 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 outra região ao cluster restaurado, transformando-o em um cluster global.
