Administración de un clúster global de Amazon DocumentDB

Puede realizar la mayor parte de las operaciones de administración en los clústeres individuales que componen un clúster global. Cuando selecciona Recursos relacionados con grupos en la página Clústeres de la consola, verá el clúster primario y los clústeres secundarios agrupados bajo el objeto de clúster global asociado.

La pestaña Configuración de un clúster global muestra Regiones de AWS dónde se ejecutan los clústeres, la versión y el identificador del clúster global.

Modificación de un clúster global de Amazon DocumentDB

La página Clústeres de la AWS Management Console lista incluye todos los clústeres globales y muestra el clúster principal y los clústeres secundarios de cada uno. El clúster global tiene sus propias opciones de configuración. Específicamente, tiene regiones de asociadas con sus clústeres principal y secundario.

Al realizar cambios en el clúster global, tiene la oportunidad de cancelar los cambios.

Al seleccionar Continue (Continuar), confirma los cambios.

Modificación de los parámetros de un clúster global de Amazon DocumentDB

Puede configurar los grupos de parámetros de clúster independientemente para cada clúster dentro del clúster global. La mayoría de parámetros funcionan igual que para otros tipos de clústeres de Amazon DocumentDB. Se recomienda mantener la configuración coherente entre todos los clústeres de un clúster global. Esto ayuda a evitar cambios de comportamiento inesperados si se promueve un clúster secundario para que sea el principal.

Por ejemplo, utilice la misma configuración de zonas horarias y conjuntos de caracteres para evitar un comportamiento incoherente si un clúster diferente asume la función del clúster principal.

Eliminación de un clúster global de Amazon DocumentDB

Hay varias situaciones en las que es posible que desee eliminar clústeres de su clúster global. Por ejemplo, es posible que desee quitar un clúster de un clúster global si el clúster principal se degrada o se aísla. A continuación, se convierte en un clúster provisionado independiente que podría utilizarse para crear un nuevo clúster global. Para obtener más información, consulte Recuperación manual de un clúster global tras una interrupción imprevista.

También puede querer quitar clústeres porque desea eliminar un clúster global que ya no necesite. No puede eliminar el clúster global hasta después de eliminar (desasociar) todos los clústeres asociados y deje el principal para lo último. Para obtener más información, consulte Eliminación de un clúster global de Amazon DocumentDB.

nota

Cuando un clúster se desasocia del clúster global, ya no se sincroniza con el principal. Se convierte en un clúster aprovisionado independiente con capacidades completas de lectura/escritura. Además, ya no está visible en la consola de Amazon DocumentDB. Solo está visible cuando selecciona la región de la consola en la que estaba ubicado el clúster.

Puede eliminar clústeres de su clúster global mediante la API AWS Management Console AWS CLI, la o la API de RDS.

Using the AWS Management Console

1. Inicie sesión en la consola de Amazon DocumentDB AWS Management Console y navegue hasta ella.

2. En el panel de navegación izquierdo, elija Clústeres.

   

3. Amplíe el clúster global para que pueda ver todos los clústeres secundarios. Seleccione los clústeres secundarios que desee eliminar. Selecciona Acciones y, en el menú desplegable, selecciona Eliminar del mapa global.

   

4. Abra un mensaje para confirmar que desea separar el secundario del clúster global. Elija Eliminar y promover para quitar el clúster del clúster global.

   

El clúster ya no sirve como secundario y ya no está sincronizado con el clúster principal. Es un clúster independiente con capacidad completa de lectura/escritura.

Tras eliminar o borrar todos los clústeres secundarios, podrá eliminar el clúster principal del mismo modo. No puede separar o quitar el clúster principal de un clúster global hasta después de quitar todos los clústeres secundarios. El clúster global puede permanecer en la lista de Clústeres, con cero regiones y AZ. Puede eliminar si ya no desea utilizar este clúster global.

Using the AWS CLI

Para eliminar un clúster de un clúster global, ejecute el comando CLI remove-from-global-cluster con los siguientes parámetros:

• --global-cluster-identifier: nombre (identificador) del clúster global.

• --db-cluster-identifier: nombre de cada clúster que se va a quitar del clúster global.

Los siguientes comandos eliminan un clúster secundario y, después, el clúster primario de un clúster global.

Para Linux, macOS o Unix:

aws docdb --region secondary_region \
  remove-from-global-cluster \
    --db-cluster-identifier secondary_cluster_ARN \
    --global-cluster-identifier global_cluster_id

aws docdb --region primary_region \
  remove-from-global-cluster \
    --db-cluster-identifier primary_cluster_ARN \
    --global-cluster-identifier global_cluster_id

Repita el comando remove-from-global-cluster --db-cluster-identifier secondary_cluster_ARNpara cada región secundaria de su clúster global.

Para Windows:

aws docdb --region secondary_region ^
  remove-from-global-cluster ^
    --db-cluster-identifier secondary_cluster_ARN ^
    --global-cluster-identifier global_cluster_id

aws docdb --region primary_region ^
  remove-from-global-cluster ^
    --db-cluster-identifier primary_cluster_ARN ^
    --global-cluster-identifier global_cluster_id

Repita el comando remove-from-global-cluster --db-cluster-identifier secondary_cluster_ARNpara cada región secundaria de su clúster global.

Eliminación de un clúster global de Amazon DocumentDB

Para completar la eliminación de un clúster global, haga lo siguiente:

• Elimine todas las regiones secundarias del clúster global. Cada clúster se convierte en un clúster independiente. Consulte la sección anterior, Eliminación de clústeres globales.

• En cada clúster independiente, elimine todas las réplicas.

• Elimine el clúster secundario del clúster global. Esto se convierte en un clúster independiente.

• Desde el clúster principal, primero elimine todas las réplicas y, a continuación, elimine la instancia primaria. La eliminación de la instancia de escritor del clúster recién independiente también normalmente elimina el clúster y el clúster global.

Using the AWS Management Console

1. Inicie sesión en la consola de Amazon DocumentDB AWS Management Console y navegue hasta ella.

2. Elija Clústeres y busque el clúster global que desea eliminar.

   

3. Con el clúster global seleccionado, selecciona Eliminar en el menú Acciones.

   

Confirme que todos los demás clústeres se han borrado del clúster global. El clúster global debe mostrar 0 regiones y AZ, y tener un tamaño de 0 clústeres. Si el clúster global contiene clústeres, no puede eliminarla. Primero tendrás que seguir las instrucciones del paso anterior, Eliminar los clústeres globales.

Using the AWS CLI

Para eliminar un clúster global, ejecute el comando delete-global-cluster CLI con el nombre Región de AWS y el identificador del clúster global, como se muestra en el siguiente ejemplo.

Para Linux, macOS o Unix:

aws docdb --region primary_region delete-global-cluster \
   --global-cluster-identifier global_cluster_id

Para Windows:

aws docdb --region primary_region delete-global-cluster ^
   --global-cluster-identifier global_cluster_id

Creación de un clúster de Amazon DocumentDB sin pantalla en una región secundaria

Si bien un clúster global de Amazon DocumentDB requiere al menos un clúster secundario Región de AWS distinto del principal, puede usar una configuración headless para el clúster secundario. Un clúster secundario de Amazon DocumentDB sin pantalla es uno sin una instancia. Este tipo de configuración puede reducir los gastos para un clúster global. En un clúster de Amazon DocumentDB, se desacoplan la informática y el almacenamiento. Sin la instancia, no se le cobrará por la informática, solo por almacenamiento. Si está configurado correctamente, el volumen de almacenamiento de un clúster secundario sin pantalla se mantiene sincronizado con el clúster principal.

Agregue el clúster secundario como lo hace normalmente al crear un clúster global de Amazon DocumentDB. Sin embargo, después de que el clúster principal comience la reproducción en el secundario, se elimina la instancia de solo lectura del clúster secundario. Ahora, este clúster secundario se considera “sin pantalla” porque ya no tiene una instancia. Sin embargo, el volumen de almacenamiento se mantiene sincronizado con el clúster principal de Amazon DocumentDB.

importante

Solo recomendamos los clústeres headless a los clientes que puedan tolerar errores en toda la región durante más de 15 minutos. Esto se debe a que, para recuperarse de un error en toda la región con un clúster secundario independiente, el usuario tendrá que crear una nueva instancia tras la conmutación por error. Una nueva instancia puede tardar entre 10 y 15 minutos en estar disponible.

Cómo agregar un clúster secundario sin pantalla a su clúster global

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

2. En el panel de navegación izquierdo, elija Clústeres.

3. Elija el clúster global que necesita un clúster secundario. Asegúrese de que el clúster principal es.Available

4. En Actions (Acciones), elija Add region (Añadir región).

5. En la página Añadir una región, seleccione la región secundaria.

   nota

   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.

6. Complete los campos restantes para el clúster secundario de en la nueva región de. Estas son las mismas opciones de configuración que para cualquier instancia de clúster.

7. Agregar región. Después de terminar de agregar la región al clúster global, puede verla en la lista deClusters de la AWS Management Console.

8. Compruebe el estado del clúster secundario y de su instancia de lectura antes de continuar, utilizando el AWS Management Console o el AWS CLI. A continuación, se muestra un ejemplo de comando si usa la AWS CLI:

   $ aws docdb describe-db-clusters --db-cluster-identifier secondary-cluster-id --query '*[].[Status]' --output text

   El estado de un clúster secundario recién agregado puede tardar varios minutos en cambiar de “creación en curso” a “disponible”. Cuando el clúster se encuentra disponible, puede eliminar la instancia de lector.

9. Seleccione la instancia de lector en el clúster secundario y, a continuación, elija Eliminar.

10. Después de eliminar la instancia de lector, el clúster secundario sigue siendo parte del clúster global. No debe tener ninguna instancia asociada con él.

nota

Puede utilizar este clúster secundario de Amazon DocumentDB sin pantalla para recuperar manualmente su clúster global de Amazon DocumentDB de una interrupción no planificada en la región principal si se produce una interrupción de este tipo.