View a markdown version of this page

Administración de un clúster global de Amazon DocumentDB - Amazon DocumentDB
Modificación de clústeres globalesModificación de los parámetrosEliminación de clústeres globalesEliminación de clústeres globalesClústeres sin periféricos

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.

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 Consola de administración de AWS lista muestra 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. En concreto, tiene regiones asociadas a sus clústeres principales y secundarios.

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. Mantén la misma configuración en todos los clústeres de una base de datos global para evitar cambios de comportamiento inesperados si promocionas un clúster secundario para que pase a ser 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 Ejecución de una conmutación por error manual para un clúster global de Amazon DocumentDB.

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 todas read/write las capacidades. Además, ya no está visible en la consola de Amazon DocumentDB. Solo está visible cuando se selecciona la región en la consola en la que estaba ubicado el clúster.

Puedes eliminar clústeres de tu clúster global mediante la API Consola de administración de AWS AWS CLI, la API o la API de RDS.

Using the Consola de administración de AWS

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

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

    Imagen: cuadro de navegación de clústeres que muestra una lista de los enlaces de clústeres existentes y sus correspondientes enlaces de instancia.

  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.

    Imagen: cuadro de navegación de clústeres que muestra la selección de un clúster secundario existente y resalta la acción “Eliminar de 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.

    Imagen: mensaje Eliminar y promocionar.

El clúster ya no sirve como secundario y ya no está sincronizado con el clúster principal. Se trata de un clúster independiente con plena read/write capacidad.

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, sin regiones ni zonas de disponibilidad. 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

Repite el remove-from-global-cluster --db-cluster-identifier secondary_cluster_ARN comando para cada región secundaria de tu 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

Repite el remove-from-global-cluster --db-cluster-identifier secondary_cluster_ARN comando para cada región secundaria de tu clúster global.

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

Para completar la eliminación de un clúster global, siga estos pasos:

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

  • 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 Consola de administración de AWS

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

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

    Imagen: cuadro de navegación de clústeres que muestra una lista de los enlaces de clústeres existentes y sus correspondientes enlaces de instancia.

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

    Imagen: cuadro de navegación de clústeres que muestra la selección de un clúster global y resalta la acción “Eliminar”.

Confirme que todos los demás clústeres se han borrado del clúster global. El clúster global debe mostrar cero regiones y zonas de disponibilidad y un tamaño de cero clústeres. Si el clúster global contiene clústeres, no puede eliminarla. Primero tendrá que seguir las instrucciones del paso anterior, Eliminación de un clúster global de Amazon DocumentDB.

Using the AWS CLI

Para eliminar un clúster global, ejecute el comando de la 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 independiente de Amazon DocumentDB en una región secundaria

Si bien un clúster global de Amazon DocumentDB requiere al menos un clúster secundario en un Región de AWS lugar diferente al principal, puede usar una configuración independiente para el clúster secundario. Un clúster secundario de Amazon DocumentDB sin periféricos 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 periféricos 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. Este clúster secundario ahora se considera «independiente» porque ya no tiene una instancia. Sin embargo, el volumen de almacenamiento se mantiene sincronizado con el clúster principal de Amazon DocumentDB.

importante

Usa clústeres independientes solo si puedes tolerar Region-wide errores durante 15 minutos o más. Para recuperarse de un Region-wide error con un clúster secundario independiente, es necesario crear una nueva instancia después de la conmutación por error. Una instancia nueva puede tardar entre 10 y 15 minutos en estar disponible.

Cómo añadir un clúster secundario independiente a tu clúster global

  1. Inicie sesión en la consola de Amazon DocumentDB Consola de administración de AWS 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 Acciones, elija Agregar región.

  5. En la página Agregar una región, elige la región secundaria.

    nota

    No puedes 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. Agrega una región. Cuando termines de agregar la región a tu clúster global, aparecerá en la lista de Clusters Consola de administración de AWS.

  8. Compruebe el estado del clúster secundario y de su instancia lectora antes de continuar. Para ello, utilice el Consola de administración de AWS 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 independiente 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.