Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Agregación de una instancia de Amazon DocumentDB a un clúster
- Using the AWS Management Console
-
El siguiente procedimiento permite crear una instancia de su clúster mediante la consola de Amazon DocumentDB.
-
Inicie sesión en la AWS Management Console y abra la consola de Amazon DocumentDB en https://console.aws.amazon.com/docdb
. -
En el panel de navegación, seleccione Clusters (Clústeres).
sugerencia
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú (
) en la esquina superior izquierda de la página. -
Para elegir el clúster al que desea añadir una instancia, seleccione el botón situado a la izquierda del nombre del clúster.
-
Elija Actions (Acciones) y después Add instances (Añadir instancias).
-
En la página Add instance to (Añadir instancia a)<cluster-name>, repita los pasos que se describen a continuación para cada instancia que desee añadir al clúster. Puede tener un máximo de 15.
-
Instance identifier: puede escribir un identificador único para esta instancia o permitir que Amazon DocumentDB proporcione el identificador de la instancia basándose en el identificador del clúster.
Restricciones en cuanto a la nomenclatura de las instancias:
-
Debe tener [1-63] letras, números o guiones.
-
El primer carácter debe ser una letra.
-
No puede terminar por un guion ni contener dos guiones consecutivos.
-
Debe ser único para todas las instancias de Amazon RDS, Neptune y Amazon DocumentDB por Cuenta de AWS y por región.
-
-
Clase de instancia: en la lista desplegable, elija el tipo de instancia que desea para esta instancia.
-
Capa de promoción: en la lista, elija la capa de promoción de la instancia, o bien elija Sin preferencia para permitir que Amazon DocumentDB establezca la capa de promoción de la instancia. Un número menor indica una mayor prioridad. Para obtener más información, consulte Control del destino de la conmutación por error.
-
Para añadir más instancias, elija Add additional instances (Agregar instancias adicionales) y repita los pasos a, b y c.
-
-
Finalizar la operación.
-
Para añadir las instancias a su clúster, seleccione Create (Crear).
-
Para cancelar la operación, elija Cancel (Cancelar).
-
La creación de una instancia puede tardar varios minutos. Puede usar la consola o la AWS CLI para ver el estado de la instancia. Para obtener más información, consulte Monitorización del estado de una instancia.
-
- Using the AWS CLI
-
Utilice la operación
create-db-instancede la AWS CLI con los siguientes parámetros para crear la instancia principal para el clúster.-
--db-instance-class: obligatorio. La capacidad de memoria e informática de la instancia (por ejemplo,db.m4.large). No todas las clases de instancia están disponibles en todas las Regiones de AWS. -
--db-instance-identifier: obligatorio. Una cadena que identifica la instancia.Restricciones en cuanto a la nomenclatura de las instancias:
-
Debe tener [1-63] letras, números o guiones.
-
El primer carácter debe ser una letra.
-
No puede terminar por un guion ni contener dos guiones consecutivos.
-
Debe ser único para todas las instancias de Amazon RDS, Neptune y Amazon DocumentDB por Cuenta de AWS y por región.
-
-
--engine: obligatorio. Debe serdocdb. -
--availability-zone: opcional. La zona de disponibilidad en la que desea crear esta instancia. Use este parámetro para colocar sus instancias en diferentes zonas de disponibilidad con el fin de aumentar la tolerancia a errores. Para obtener más información, consulte Alta disponibilidad y replicación de Amazon DocumentDB. -
--promotion-tier: opcional. El nivel de prioridad de conmutación por error de esta instancia. Debe ser un número comprendido entre 0 y 15; un número menor indica una mayor prioridad. Para obtener más información, consulte Control del destino de la conmutación por error.
-
En primer lugar, determine en qué zonas de disponibilidad puede crear la instancia.
Si desea especificar la zona de disponibilidad, antes de crear la instancia, ejecute el siguiente comando para determinar en qué zonas de disponibilidad están disponibles para el clúster de Amazon DocumentDB.
Para Linux, macOS o Unix:
aws docdb describe-db-clusters \ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'Para Windows:
aws docdb describe-db-clusters ^ --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'La salida de esta operación será similar a lo que se indica a continuación.
[ [ "sample-cluster", [ "us-east-1c", "us-east-1b", "us-east-1a" ] ] ] -
En segundo lugar, determine qué clases de instancias puede crear en su región.
Para determinar qué clases de instancias tiene a su disposición en su región, ejecute el siguiente comando. En el resultado, elija una clase de instancia para la instancia que desea agregar al clúster de Amazon DocumentDB.
Para Linux, macOS o 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'La salida de esta operación será similar a lo que se indica a continuación.
[ "db.r5.16xlarge", "db.r5.2xlarge", "db.r5.4xlarge", "db.r5.8xlarge", "db.r5.large", "db.r5.xlarge" ] -
Agregar una instancia a su clúster de Amazon DocumentDB.
Para agregar una instancia al clúster de Amazon DocumentDB, ejecute el siguiente comando.
Para Linux, macOS o 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 docdbLa salida de esta operación será similar a lo que se indica a continuación.
{ "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" } }
La creación de la instancia puede tardar varios minutos. Puede usar la consola o la AWS CLI para ver el estado de la instancia. Para obtener más información, consulte Supervisión del estado de un clúster de Amazon DocumentDB.
-
