Administración de clústeres elásticos de Amazon DocumentDB - Amazon DocumentDB
Modificación de configuraciones de clústeres elásticosMonitoreo de un clúster elásticoEliminación de un clúster elástico

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 clústeres elásticos de Amazon DocumentDB

Para administrar un clúster de Amazon DocumentDB, debe disponer de una política de IAM con los permisos del plano de control de Amazon DocumentDB. Estos permisos le permiten crear, modificar y eliminar clústeres. La política de DBFull acceso a documentos de Amazon proporciona todos los permisos necesarios para administrar un clúster elástico de Amazon DocumentDB.

En los temas siguientes se muestra cómo realizar diversas tareas al trabajar con clústeres elásticos de Amazon DocumentDB.

Temas

Modificación de configuraciones de clústeres elásticos

En esta sección, explicamos cómo modificar el clúster elástico mediante las instrucciones siguientes AWS Management Console o AWS CLI siguiendo estas instrucciones.

Un uso principal de la modificación del clúster es escalar las particiones aumentando o disminuyendo el número de particiones y/o la capacidad de cómputo de las particiones.

Using the AWS Management Console

Para modificar la configuración de un clúster elástico mediante AWS Management Console:

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

  2. 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 del panel de navegación.

  3. Elija el nombre del clúster que desea modificar en la columna Identificador de clúster.

  4. Elija Modificar.

  5. Edite los campos que desee cambiar y, a continuación, seleccione Modificar clúster.

    Formulario que muestra las opciones de configuración, mantenimiento, autenticación y configuración de red que se pueden modificar, con el botón Modificar clúster en la esquina inferior derecha.
nota

Como alternativa, puede acceder al cuadro de diálogo Modificar clúster desde la página Clústeres si marca la casilla situada junto al clúster, selecciona Acciones y, a continuación, Modificar.

Using the AWS CLI

Para modificar la configuración de un clúster elástico mediante el AWS CLI, utilice la update-cluster operación con los siguientes parámetros:

  • --cluster-arn: obligatorio. El identificador del ARN del clúster que desee modificar.

  • --shard-capacity: opcional. El número de v CPUs asignado a cada fragmento. El máximo es 64. Los valores permitidos son 2, 4, 8, 16, 32, 64.

  • --shard-count: opcional. La cantidad de particiones asignadas al clúster. El máximo es 32.

  • Recuento de --shard-instance: opcional. El número de instancias de réplica que se aplican a todos los fragmentos de este clúster. El máximo es 16.

  • --auth-type: opcional. El tipo de autenticación utilizado para determinar dónde buscar la contraseña que se usa para acceder al clúster elástico. Los tipos válidos son PLAIN_TEXT o SECRET_ARN.

  • --admin-user-password: opcional. La contraseña asociada al usuario administrador.

  • --vpc-security-group-ids: opcional. Configure una lista de grupos de seguridad de Amazon EC2 y Amazon Virtual Private Cloud (VPC) para asociarlos a este clúster.

  • --preferred-maintenance-window: opcional. El intervalo de tiempo semanal durante el cual puede llevarse a cabo el mantenimiento del sistema, en tiempo universal coordinado (UTC).

    El formato es: ddd:hh24:mi-ddd:hh24:mi. Días válidos: lunes, martes, miércoles, jueves, viernes, sábado, domingo

    El valor predeterminado es un periodo de 30 minutos seleccionado al azar de un bloque de 8 horas de tiempo para cada región de Amazon Web Services, que tiene lugar un día de la semana de forma aleatoria.

    El plazo mínimo es 30 minutos.

  • --subnet-ids: opcional. Configure los identificadores de subred de la red.

Para utilizar el ejemplo siguiente, sustituya user input placeholder con su propia información.

Para Linux, macOS o Unix:

aws docdb-elastic update-cluster \
    --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
    --shard-capacity 8 \
    --shard-count 4 \
    --shard-instance-count 3 \
    --admin-user-password testPassword \
    --vpc-security-group-ids ec-65f40350 \
    --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

Para Windows:

aws docdb-elastic update-cluster ^
    --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
    --shard-capacity 8 ^
    --shard-count 4 ^
    --shard-instance-count 3 ^
    --admin-user-password testPassword ^
    --vpc-security-group-ids ec-65f40350 ^
    --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

Para supervisar el estado del clúster elástico después de la modificación, consulte Supervisión de un clúster elástico.

Monitoreo de un clúster elástico

En esta sección, explicamos cómo monitorizar el clúster elástico mediante las instrucciones siguientes AWS Management Console o AWS CLI siguiendo estas instrucciones.

Using the AWS Management Console

Para monitorear la configuración de un clúster elástico mediante AWS Management Console:

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

  2. 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 del panel de navegación.

  3. Elija el nombre del clúster que desea monitorear en la columna del Identificador del clúster.

  4. Elija la pestaña Monitorización.

    La información resumida del clúster elástico se muestra en la pestaña Supervisión.

Se muestran varios gráficos de Amazon CloudWatch para las siguientes categorías de seguimiento:

  • Uso de los recursos

  • Rendimiento

  • Operaciones

  • System

También puede acceder a Amazon CloudWatch a través de AWS Management Console para configurar su propio entorno de monitoreo para sus clústeres elásticos.

Using the AWS CLI

Para monitorear una configuración de clúster elástico específica mediante el AWS CLI, utilice la get-cluster operación con los siguientes parámetros:

  • --cluster-arn: obligatorio. Identificador del ARN del clúster para el que desea obtener información detallada.

Para utilizar el ejemplo siguiente, sustituya user input placeholder con su propia información.

Para Linux, macOS o Unix:

aws docdb-elastic get-cluster \
    --cluster-arn arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9

Para Windows:

aws docdb-elastic get-cluster ^
    --cluster-arn arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9

La salida de esta operación será similar a lo que se indica a continuación:

"cluster": {
        ...
        "clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9",
        "clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com",
        "readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com",
        "clusterName": "stretch-11",     
        "shardCapacity": 2,
        "shardCount": 3,
        "shardInstanceCount: 5,
        "status": "ACTIVE",
        ...
 }

Para obtener más información, consulte DescribeClusterSnapshot en la Referencia de la API para administración de recursos de Amazon DocumentDB.

Para ver los detalles de todos los clústeres elásticos que utilizan el AWS CLI, utilice la list-clusters operación con los siguientes parámetros:

  • --next-token: opcional. Si el número de elementos de salida (--max-results) es inferior al número total de elementos devueltos por las llamadas básicas a la API, la salida incluirá un NextToken que podrá pasar a un comando posterior para recuperar el siguiente conjunto de elementos.

  • --max-results: opcional. El número total de elementos que se devuelven en la salida del comando. Si el número de registros es superior al valor max-results especificado, se incluye en la respuesta un token de paginación (next-token) que se conoce como marcador, de modo que se pueda recuperar el resto de resultados.

    • Predeterminado: 100

    • Mínimo = 20, máximo = 100

Para utilizar el ejemplo siguiente, sustituya user input placeholder con su propia información.

Para Linux, macOS o Unix:

aws docdb-elastic list-clusters \
    --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== \
    --max-results 2

Para Windows:

aws docdb-elastic list-clusters ^
    --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== ^
    --max-results 2

La salida de esta operación será similar a lo que se indica a continuación:

{
   "Clusters": [
      {
         "ClusterIdentifier":"mycluster-1",
         "ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster"
         "Status":"available",
         "ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
       }
       {
         "ClusterIdentifier":"mycluster-2",
         "ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster"
         "Status":"available",
         "ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
       }
   ] 
}

Eliminación de un clúster elástico

En esta sección, explicamos cómo eliminar un clúster elástico, utilizando las instrucciones siguientes AWS Management Console o AWS CLI siguiendo estas instrucciones.

Using the AWS Management Console

Para eliminar una configuración de clúster elástico mediante la AWS Management Console:

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

  2. 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 del panel de navegación.

  3. En la tabla de lista de clúster, active la casilla de verificación situada a la izquierda del nombre del clúster que desea eliminar y, a continuación, elija Acciones. En el menú desplegable, seleccione Eliminar.

  4. ¿En el clúster elástico Eliminar “cluster-name”? cuadro de diálogo, elija Eliminar.

    Cuadro de diálogo Eliminar, con el botón Eliminar en la esquina inferior derecha.

La eliminación del clúster puede tardar varios minutos. Para supervisar el estado del clúster, consulte Supervisión del estado de un clúster de Amazon DocumentDB.

Using the AWS CLI

Para eliminar un clúster elástico mediante el AWS CLI, utilice la delete-cluster operación con los siguientes parámetros:

  • --cluster-arn: obligatorio. El identificador del ARN del clúster que desee eliminar.

  • --no-skip-final-backup: opcional. Si desea una instantánea final, debe incluir este parámetro con un nombre para la instantánea final. Debe incluir --final-backup-identifier o --skip-final-backup.

  • --skip-final-backup: opcional. Use este parámetro solo si no desea realizar un respaldo final antes de eliminar el clúster. El comportamiento predeterminado es realizar una instantánea final.

Los siguientes ejemplos de AWS CLI código eliminan un clúster con un ARN de arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster con una copia de seguridad final.

En el siguiente ejemplo, sustituya cada uno por su propia información. user input placeholder

Para Linux, macOS o Unix:

aws docdb-elastic delete-cluster \
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
    --no-skip-final-backup \
    --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

Para Windows:

aws docdb-elastic delete-cluster ^
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
    --no-skip-final-backup ^
    --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

Los siguientes ejemplos de AWS CLI código eliminan un clúster con un ARN de arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster sin realizar una copia de seguridad final.

Para utilizar el ejemplo siguiente, sustituya user input placeholder con su propia información.

Para Linux, macOS o Unix:

aws docdb-elastic delete-cluster \
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
    --skip-final-backup \

Para Windows:

aws docdb-elastic delete-cluster ^
    --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
    --skip-final-backup ^

El resultado de la operación delete-cluster es el clúster que se va a eliminar.

La eliminación del clúster puede tardar varios minutos. Para supervisar el estado del clúster, consulte Supervisión del estado de un clúster de Amazon DocumentDB.