Guía de inicio rápido: clústeres globales

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 quince 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 dieciséis 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.

Descripción	Principal 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.r6.

• 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 pueden estar 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 AWS Management Console o AWS CLI siguiendo estas instrucciones.

Usando el AWS Management Console

1. En AWS Management Console, vaya a Amazon DocumentDB.

2. Cuando llegue a la consola de Amazon DocumentDB, elija Clústeres.

   

3. Seleccione Crear.

   

4. 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.

   

5. En la sección Autenticación, introduzca un nombre de usuario maestro y una contraseña maestra.

   

6. Seleccione Mostrar configuración avanzada.

   

7. En la sección Configuración de red:

   • Mantenga las opciones predeterminadas para la Nube virtual privada y el Grupo de subredes.

     

   • En el caso VPCde los grupos de seguridad, el valor predeterminado ya VPC debería estar agregado.

     

   • Escriba DocDB en el campo Grupos VPC de seguridad y seleccione DocDB-Inbound (). VPC

     

8. Para las opciones de clúster y E ncryption-at-rest, deje las selecciones predeterminadas.

   

9. Para Copia de seguridad y Exportaciones de registros, deje las selecciones predeterminadas.

   

10. Para Mantenimiento, Etiquetas y Protección contra eliminación, deje las selecciones predeterminadas.

    

11. Ahora haga clic en el botón Crear.

    

Usando el AWS CLI

Para crear un clúster regional de Amazon DocumentDB, llame a. create-db-cluster AWS CLI 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 Eliminar un clúster de Amazon DocumentDB.

Además, --engine-version es un parámetro opcional que utiliza de forma predeterminada la última versión principal del motor. La versión principal del motor es 4.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. Por lo tanto, para las cargas de trabajo de producción, y especialmente las que dependen de la creación de scripts, la automatización o las AWS CloudFormation plantillas, le recomendamos que las especifique de forma explícita en la --engine-version versión principal deseada.

Si vpc-security-group-id se especifica una db-subnet-group-name o no, Amazon DocumentDB utilizará el grupo de subredes y el grupo de VPC seguridad de Amazon predeterminados para la región determinada.

En el siguiente ejemplo, sustituya cada 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
         

El resultado de esta operación tiene un aspecto similar al siguiente (JSONformato).

{
    "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 el AWS Management Console o AWS CLI para supervisar el estado del clúster. Para obtener más información, consulte Supervisión del estado de un clúster de Amazon DocumentDB.

importante

Cuando se utiliza 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 y CreateDBCluster en la referencia de Amazon DocumentDB. API

Una vez que su clúster regional esté disponible, puede agregar 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. Cuando agregue 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 5 regiones secundarias, el clúster principal sólo puede tener 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.

Uso del AWS Management Console

1. Inicie sesión en la consola de Amazon DocumentDB AWS Management Console y ábrala.

2. En el panel de navegación, seleccione Clusters (Clústeres).

   

3. Elija el clúster al que desearía agregar un clúster secundario. Asegúrese de que el clúster es Available.

   

4. Selecciona el menú desplegable de Acciones y, a continuación, seleccione Agregar región.

   

5. En la página Añadir una región, 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.

   

6. Complete los campos restantes para el clúster secundario en la nueva región, luego seleccione Crear clúster. Después de terminar de agregar la región, puede verla en la lista de Clústeres en la AWS Management Console.

   

Usando la AWS CLI

• Use el create-db-cluster CLI comando con el nombre (--global-cluster-identifier) de su 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.

En el siguiente ejemplo, sustituya cada 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, agregue otra región al clúster restaurado, convirtiéndolo así en clúster global.