Administración de los clústeres elásticos - 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 los clústeres elásticos

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 Amazon DocumentDBFullAccess proporciona todos los permisos necesarios para administrar un clúster 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 la AWS Management Console o la 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 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. 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.

    Diagrama: modificación del clúster elástico
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 la AWS CLI, utilice la operación update-cluster 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 vCPU asignado a cada partición. 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 la nube privada virtual (VPC) de Amazon 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.

En el siguiente ejemplo, reemplace cada marcador de posición del usuario 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 la AWS Management Console o la AWS CLI siguiendo estas instrucciones.

Using the AWS Management Console

Para monitorear la configuración de un 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. Elija el nombre del clúster que desea monitorear en la columna del Identificador del clúster.

  4. Elija la pestaña Monitorización.

    Diagrama: monitoreo de clústeres elásticos

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

  • Uso de los recursos

  • Rendimiento

  • Latencia

  • Operaciones

  • System (Sistema)

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

Using the AWS CLI

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

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

En el siguiente ejemplo, reemplace cada marcador de posición del usuario 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 la AWS CLI, utilice la operación list-clusters 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

En el siguiente ejemplo, reemplace cada marcador de posición del usuario 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 mediante la AWS Management Console o la 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.

    Diagrama: modificación del clúster elástico

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 la AWS CLI, utilice la operación delete-cluster 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 código de la AWS CLI 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, reemplace cada marcador de posición del usuario 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 \
    --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 código de la AWS CLI 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.

En el siguiente ejemplo, reemplace cada marcador de posición del usuario 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.