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
**Topics**
+ [Configuração](#global-clusters.config)
+ [Criar um cluster global](#global-clusters-create)
+ [Adição de uma região a um cluster global](#global-clusters.add-region)
+ [Compartilhar um snapshot](#global-clusters.snapshot)
## 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.
| Description | 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, considerando 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.r5` e `db.r6g`.
+ **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 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.
### Usando o Console de gerenciamento da AWS
1. No Console de gerenciamento da AWS, navegue até **Amazon DocumentDB**.
1. Ao acessar o console do Amazon DocumentDB, escolha **Clusters.**
![\[A página Clusters no console do Amazon DocumentDB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Escolha **Criar**.
![\[O botão Criar, exibido no canto superior direito da tabela Clusters.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-create.png)
1. 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.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/create-config.png)
1. 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.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/create-auth.png)
1. 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.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/show-advanced.png)
1. 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.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-1.png)
+ 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.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-2.png)
+ 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.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/inbound-vfc.png)
1. Para **Opções de cluster** e **E ncryption-at-rest**, deixe nas seleções padrão.
![\[Opções de cluster e Encryption-at-rest formulários com as opções padrão selecionadas.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-1.png)
1. 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.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-2.png)
1. 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.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-3.png)
1. Agora clique no botão que diz **Criar cluster**.
![\[O botão Criar cluster é exibido no final do processo de criação do cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/create-cluster.png)
### Usando o AWS CLI
Para criar um cluster regional do Amazon DocumentDB, chame o. [create-global-cluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html) O AWS CLI comando 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](db-cluster-delete.md).
Além disso, `--engine-version` é um parâmetro opcional padrão para a versão mais recente do mecanismo principal. A versão padrão atual do mecanismo é `5.0.0` (nota: o Amazon DocumentDB 8.0 está disponível, mas deve ser explicitamente especificado como). `8.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. Como resultado, para cargas de trabalho de produção, especialmente aquelas que dependem de scripts, automação ou CloudFormation modelos, 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 *user input placeholder* 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. Você pode 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](monitoring_docdb-cluster_status.md).
**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](db-instance-add.md) e [CreateDBCluster](API_CreateDBCluster.md) 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](#global-clusters.add-region). 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](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.get-started.html#global-clusters.config).
### Usando o Console de gerenciamento da AWS
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon DocumentDB.
1. No painel de navegação, escolha **Clusters**.
![\[A página Clusters no console do Amazon DocumentDB.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. 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.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster-2.png)
1. 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.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region.png)
1. 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 Região da AWS formulário.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region-2.png)
1. 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.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/global-clusters/quick-start/select-add-region.png)
### Usando o AWS CLI
+ 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:
+ Para`--region`, escolha uma Região da AWS diferente da sua região principal.
+ Escolha valores específicos para os parâmetros `--engine` e `--engine-version`.
+ Para um cluster criptografado, especifique seu primário Região da AWS como o `--source-region` de 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 --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.