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á.
Adicionar uma instância do Amazon DocumentDB a um cluster
- Using the AWS Management Console
-
Use o procedimento a seguir para criar uma instância para o cluster usando o console do Amazon DocumentDB.
-
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. -
Para escolher o cluster ao qual você deseja adicionar uma instância, selecione o botão à esquerda do nome do cluster.
-
Escolha Ações e escolha Adicionar instâncias.
-
Na página Adicionar instância a: <nome-do-cluster>, repita as etapas a seguir para cada instância a ser adicionada ao cluster. Você pode ter até 15.
-
Identificador da instância: 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.
Restrições de nomenclatura da instância:
-
O comprimento é de [1 a 63] letras, números ou hífens.
-
O primeiro caractere deve ser uma letra.
-
Não podem terminar com um hífen ou conter dois hífens consecutivos.
-
Deve ser exclusivo para todas as instâncias do AmazonRDS, Neptune e Amazon DocumentDB por região. Conta da AWS
-
-
Classe da instância: na lista suspensa, escolha o tipo de instância desejado para essa instância.
-
Nível de promoção: na lista suspensa, escolha o nível de promoção da instância ou selecione Nenhuma preferência para permitir que o Amazon DocumentDB defina o nível de promoção para a instância. Números mais baixos significam maior prioridade. Para obter mais informações, consulte Controlar o destino de failover.
-
Para adicionar mais instâncias, escolha Adicionar outras instâncias e repita as etapas a, b e c.
-
-
Conclua a operação.
-
Para adicionar instâncias ao seu cluster, escolha Criar.
-
Para cancelar a operação, escolha Cancelar.
-
Leva alguns minutos para criar uma instância. Você pode usar o console ou AWS CLI visualizar o status da instância. Para obter mais informações, consulte Monitorar o status de uma instância.
- Using the AWS CLI
-
Use a
create-db-instanceAWS CLI operação com os parâmetros a seguir para criar a instância primária para seu cluster.-
--db-instance-class— Obrigatório. A capacidade de computação e memória da instância, por exemplo,db.m4.large. Nem todas as classes de instâncias estão disponíveis em todas as Regiões da AWS. -
--db-instance-identifier— Obrigatório. Uma string que identifica a instância.Restrições de nomenclatura da instância:
-
O comprimento é de [1 a 63] letras, números ou hífens.
-
O primeiro caractere deve ser uma letra.
-
Não podem terminar com um hífen ou conter dois hífens consecutivos.
-
Deve ser exclusivo para todas as instâncias do AmazonRDS, Neptune e Amazon DocumentDB por região. Conta da AWS
-
-
--engine— Obrigatório. Deve serdocdb. -
--availability-zone— Opcional. A zona de disponibilidade na qual você deseja que essa instância seja criada. Use esse parâmetro para localizar suas instâncias em diferentes zonas de disponibilidade para aumentar a tolerância a falhas. Para obter mais informações, consulte Alta disponibilidade e replicação do Amazon DocumentDB. -
--promotion-tier— Opcional. O nível de prioridade de failover dessa instância. Deve estar entre 0 e 15, com números mais baixos sendo prioridade mais alta. Para obter mais informações, consulte Controlar o destino de failover.
-
Primeiro, determine em quais zonas de disponibilidade você pode criar a instância.
Se quiser especificar a zona de disponibilidade antes de criar a instância, execute o seguinte comando para determinar quais zonas de disponibilidade estão disponíveis para o cluster do Amazon DocumentDB.
Para Linux, macOS ou Unix:
aws docdb describe-db-clusters \ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'Para Windows:
aws docdb describe-db-clusters ^ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'A saída dessa operação é semelhante à seguinte.
[ [ "sample-cluster", [ "us-east-1c", "us-east-1b", "us-east-1a" ] ] ] -
Segundo, determine quais classes de instância você pode criar na região.
Para determinar quais classes de instância estão disponíveis na sua região, execute o seguinte comando. Na saída, escolha uma classe de instância para a instância que deseja adicionar ao cluster do Amazon DocumentDB.
Para Linux, macOS ou Unix:
aws docdb describe-orderable-db-instance-options \ --engine docdb \ --query 'OrderableDBInstanceOptions[*].DBInstanceClass'Para Windows:
aws docdb describe-orderable-db-instance-options ^ --engine docdb ^ --query 'OrderableDBInstanceOptions[*].DBInstanceClass'A saída dessa operação é semelhante à seguinte.
[ "db.r5.16xlarge", "db.r5.2xlarge", "db.r5.4xlarge", "db.r5.8xlarge", "db.r5.large", "db.r5.xlarge" ] -
Por último, adicione uma instância ao cluster do Amazon DocumentDB.
Para adicionar uma instância ao cluster do Amazon DocumentDB, execute o seguinte comando.
Para Linux, macOS ou Unix:
aws docdb create-db-instance \ --db-cluster-identifier sample-cluster \ --db-instance-identifier sample-instance-2 \ --availability-zone us-east-1b \ --promotion-tier 2 \ --db-instance-class db.r5.xlarge \ --engine docdbPara Windows:
aws docdb create-db-instance ^ --db-cluster-identifier sample-cluster ^ --db-instance-identifier sample-instance-2 ^ --availability-zone us-east-1b ^ --promotion-tier 2 ^ --db-instance-class db.r5.xlarge ^ --engine docdbA saída dessa operação é semelhante à seguinte.
{ "DBInstance": { "DBInstanceIdentifier": "sample-instance-2", "DBInstanceClass": "db.r5.xlarge", "Engine": "docdb", "DBInstanceStatus": "creating", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcd0123", "Status": "active" } ], "AvailabilityZone": "us-east-1b", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-6242c31a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcd0123", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active" }, { "SubnetIdentifier": "subnet-wxyz0123", "SubnetAvailabilityZone": { "Name": "us-west-2b" }, "SubnetStatus": "Active" } ] }, "PreferredMaintenanceWindow": "sun:11:35-sun:12:05", "PendingModifiedValues": {}, "EngineVersion": "3.6.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:<accountID>:key/sample-key", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 2, "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance-2" } }
Leva alguns minutos para criar a instância. Você pode usar o console ou AWS CLI visualizar o status da instância. Para obter mais informações, consulte Monitoramento do status de uma instância do Amazon DocumentDB.
-
