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.
# Guía de inicio rápido: clústeres globales
**Topics**
+ [Configuración](#global-clusters.config)
+ [Creación de un clúster global](#global-clusters-create)
+ [Añadido de una región a un clúster global](#global-clusters.add-region)
+ [Uso de una instantánea](#global-clusters.snapshot)
## Configuración
El clúster global de Amazon DocumentDB abarca al menos dos. Regiones de AWS La región principal admite un clúster que tiene una instancia principal (de escritura) y hasta 15 instancias de réplica, mientras que la región secundaria ejecuta un clúster de solo lectura compuesto en su totalidad por un máximo de 16 instancias de réplica. Un clúster global puede tener hasta cinco regiones secundarias. La tabla muestra el máximo de clústeres, instancias y réplicas permitidos en clúster global.
| Description (Descripción) | Primario Región de AWS | Secundario Región de AWS |
| --- | --- | --- |
| Clústeres | 1 | 5 (máximo) |
| Instancias de escritor | 1 | 0 |
| Instancias de solo lectura (réplicas de Amazon DocumentDB), por clúster | 15 (máx.) | 16 (total) |
| Instancias de solo lectura (máximo permitido, dado el número real de Regiones secundarias) | 15 - s | s = número total de secundarios Regiones de AWS |
Los clústeres tienen los siguientes requisitos específicos:
+ **Requisitos de clase de instancia de base de datos**: solo puede usar las clases de instancia `db.r5` y `db.r6g`.
+ **Región de AWS requisitos**: el clúster principal debe estar en una región y al menos un clúster secundario debe estar en una región diferente de la misma cuenta. Puede crear hasta cinco clústeres secundarios (de solo lectura) y cada uno debe estar en una región diferente. En otras palabras, no puede haber dos clústeres en la misma región.
+ **Requisitos de nomenclatura**: los nombres que elija para cada uno de los clústeres deben ser únicos, en todas las regiones. No puede usar el mismo nombre para diferentes clústeres aunque estén en diferentes regiones.
## Creación de un clúster global de Amazon DocumentDB
¿Está preparado para compilar su primer clúster global? En esta sección, explicaremos cómo crear un clúster global completamente nuevo con nuevos clústeres e instancias de bases de datos, utilizando las instrucciones siguientes Consola de administración de AWS o AWS CLI siguiendo estas instrucciones.
### Usando el Consola de administración de AWS
1. En Consola de administración de AWS, vaya a **Amazon DocumentDB**.
1. Cuando llegue a la consola de Amazon DocumentDB, elija **Clústeres**.
![\[La página Clústeres de la consola de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Seleccione **Crear**.
![\[El botón Crear se muestra en la esquina superior derecha de la tabla Clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-create.png)
1. Rellene la sección **Configuración** del formulario **Crear un clúster de Amazon DocumentDB** según corresponda:
+ **Identificador de clúster** 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.
+ Elija la versión del motor **4.0.0**
+ Clase de instancia: elija **db.r5.large**
+ Número de instancias: elija **3**.
![\[Formulario de opciones de configuración para crear un clúster de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/create-config.png)
1. En la sección **Autenticación**, introduzca un nombre de usuario maestro y una contraseña maestra.
![\[Formulario de autenticación para especificar un nombre de usuario y una contraseña maestros para un nuevo clúster de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/create-auth.png)
1. Seleccione **Mostrar configuración avanzada**.
![\[Muestre el botón de configuración avanzada junto a los botones Cancelar y Crear clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/show-advanced.png)
1. En la sección **Configuración de red**:
+ Mantenga las opciones predeterminadas para la **Nube privada virtual (VPC)** y el **Grupo de subredes**.
![\[Formulario de configuración de red en el que se muestran las opciones de VPC, grupo de subredes y grupos de seguridad de VPC. Los campos VPC y grupo de subredes tienen seleccionadas las opciones predeterminadas.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-1.png)
+ Para los **grupos de seguridad de VPC**, la **(VPC) predeterminada** ya debería estar añadida.
![\[Formulario de configuración de red que en el que se muestra la VPC predeterminada ya añadida.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-2.png)
+ Escriba `DocDB` en el campo **Grupos de seguridad de VPC** y seleccione **DocDB-Inbound (VFC)**.
![\[El VFC entrante de DocDB se selecciona en el menú desplegable de Grupos de seguridad de VPC.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/inbound-vfc.png)
1. Para **las opciones de clúster** y **E ncryption-at-rest**, deje las selecciones predeterminadas.
![\[Agrupe las opciones y los Encryption-at-rest formularios con las opciones predeterminadas seleccionadas.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-1.png)
1. Para **Copia de seguridad** y **Exportaciones de registros**, deje las selecciones predeterminadas.
![\[Copia de seguridad y formularios de exportación de registros con las opciones predeterminadas seleccionadas.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-2.png)
1. Para **Mantenimiento**, **Etiquetas** y **Protección contra eliminación**, deje las selecciones predeterminadas.
![\[Formularios de mantenimiento, etiquetas y protección contra eliminación con las opciones predeterminadas seleccionadas.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-3.png)
1. Ahora haga clic en el botón que dice **Crear clúster**.
![\[El botón Crear clúster se muestra al final del proceso de creación del clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/create-cluster.png)
### Uso del AWS CLI
Para crear un clúster regional de Amazon DocumentDB, llame a. [create-global-cluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html) El siguiente AWS CLI comando crea un clúster de Amazon DocumentDB denominado. `global-cluster-id` Para obtener más información sobre la protección contra eliminación, consulte [Eliminación de un clúster de Amazon DocumentDB](db-cluster-delete.md).
Además, `--engine-version` es un parámetro opcional que utiliza de forma predeterminada la última versión principal del motor. La versión predeterminada actual del motor es `5.0.0` (nota: Amazon DocumentDB 8.0 está disponible, pero debe especificarse explícitamente como`8.0.0`). Cuando se publiquen nuevas versiones principales del motor, la versión del motor predeterminada para `--engine-version` se actualizará para reflejar la última versión principal del motor. En consecuencia, para las cargas de trabajo de producción, y especialmente las que dependen de la creación de scripts, la automatización o CloudFormation las plantillas, le recomendamos que especifique de forma explícita la `--engine-version` versión principal prevista.
Si no se especifica un `db-subnet-group-name` o un `vpc-security-group-id`, Amazon DocumentDB utilizará el grupo de subredes y el grupo de seguridad de Amazon VPC predeterminados para la región determinada.
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
Para Linux, macOS o 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
```
La salida de esta operación será similar a lo que se indica a continuación (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"
}
}
```
La creación del clúster puede tardar varios minutos. Puede utilizar la Consola de administración de AWS o AWS CLI para supervisar el estado de su clúster. Para obtener más información, consulte [Supervisión del estado de un clúster de Amazon DocumentDB](monitoring_docdb-cluster_status.md).
**importante**
Al utilizar el AWS CLI para crear un clúster regional de Amazon DocumentDB, no se crea ninguna instancia. Por lo tanto, tendrá que crear de forma explícita una instancia principal y las instancias de réplica que necesite. Puede usar la consola o AWS CLI para crear las instancias. Para obtener más información, consulte [Agregación de una instancia de Amazon DocumentDB a un clúster](db-instance-add.md) y [CreateDBCluster](API_CreateDBCluster.md) en la Referencia de la API de Amazon DocumentDB.
Una vez que su clúster regional esté disponible, puede añadir un clúster secundario en otra región con las siguientes instrucciones: [Añadir un Región de AWS a un clúster global de Amazon DocumentDB](#global-clusters.add-region). Cuando añada una región, su clúster regional se convierte en su clúster principal y tiene un nuevo clúster secundario en la región que ha elegido.
## Añadir un Región de AWS a un clúster global de Amazon DocumentDB
Un clúster global necesita al menos un clúster secundario en una región diferente a la del clúster principal, y puede añadir hasta cinco clústeres secundarios. Para cada clúster secundario que agregue, deberá reducir el número de réplicas permitidas al clúster principal en una. Por ejemplo, si su clúster global tiene cinco regiones secundarias, el clúster principal puede tener solamente 10 (en lugar de 15) réplicas. Para obtener más información, consulte [Requisitos de configuración de un clúster global de Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.get-started.html#global-clusters.config).
### Uso del Consola de administración de AWS
1. Inicie sesión en la consola de Amazon DocumentDB Consola de administración de AWS y ábrala.
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
![\[La página Clústeres de la consola de Amazon DocumentDB.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Elija el clúster al que desearía agregar un clúster secundario. Asegúrese de que el clúster es `Available`.
![\[Lista de clústeres regionales y globales en la que se muestra el estado de disponibilidad, con mydocdbglobalcluster resaltado.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster-2.png)
1. Seleccione el menú desplegable **Acciones** y, a continuación, seleccione **Añadir región**.
![\[El menú desplegable Acciones de la interfaz Clústeres muestra la opción Añadir región.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region.png)
1. En la página **Añadir una Región de AWS**, seleccione la región secundaria. No puede elegir una región que ya tenga un clúster secundario para el mismo clúster global. Además, no puede ser la misma región que el clúster principal. Si es la primera región que va a añadir, también tendrá que especificar un identificador de clúster global de su elección.
![\[Elija una región secundaria mediante el menú desplegable del formulario Añadir un Región de AWS formulario.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region-2.png)
1. Complete los campos restantes para el clúster secundario en la nueva región, luego seleccione **Crear clúster**. Después de terminar de añadir la región, puede verla en la lista de **Clústeres** en la Consola de administración de AWS.
![\[Los pasos finales para añadir una región a un clúster, en los que se incluyen el formulario de configuración, la estimación del costo por hora y el botón Crear clúster.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/global-clusters/quick-start/select-add-region.png)
### Usando el AWS CLI
+ Utilice el comando `create-db-cluster` CLI con el nombre `(--global-cluster-identifier)` del clúster global. Para otros parámetros, haga lo siguiente:
+ Para `--region` ello, elija una región Región de AWS diferente a la de su región principal.
+ Elija valores específicos para los parámetros `--engine` y `--engine-version`.
+ En el caso de un clúster cifrado, especifique el principal Región de AWS como el `--source-region` de cifrado.
En el ejemplo siguiente se crea un nuevo clúster de Amazon DocumentDB y se adjunta al clúster global como clúster secundario de solo lectura. En el último paso, se agrega una instancia al nuevo clúster.
Para utilizar el ejemplo siguiente, sustituya *user input placeholder* con su propia información.
Para Linux, macOS o 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
```
## Uso de una instantánea para el clúster global de Amazon DocumentDB
Puede restaurar una instantánea de un clúster de Amazon DocumentDB para utilizarla como punto de partida del clúster global. Para ello, debe restaurar la instantánea y crear un nuevo clúster. Servirá como el clúster principal de su clúster global. A continuación, añada otra región al clúster restaurado, convirtiéndolo así en clúster global.