View a markdown version of this page

Administración de los 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 los 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 DocumentDBFullAccess política 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 un clúster elástico mediante las instrucciones siguientes Consola de administración de AWS o siguiendo AWS CLI las instrucciones siguientes.

Uno de los usos principales de la modificación del clúster es escalar los fragmentos aumentando o disminuyendo la capacidad de cálculo de los fragmentos por recuento de and/or fragmentos.

Using the Consola de administración de AWS

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

  1. Inicie sesión en la Consola de administración de AWS 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 en el que se muestran las opciones de configuración, mantenimiento, autenticación y 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 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 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.

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 supervisar su clúster elástico mediante las instrucciones siguientes Consola de administración de AWS o siguiendo AWS CLI las instrucciones siguientes.

Using the Consola de administración de AWS

Para supervisar la configuración de un clúster elástico, utilice Consola de administración de AWS:

  1. Inicie sesión en la Consola de administración de AWS 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 monitorización:

  • Uso de los recursos

  • Rendimiento

  • Operaciones

  • Sistema

También puedes acceder a Amazon a CloudWatch través del Consola de administración de AWS para configurar tu propio entorno de monitorización para tus clústeres elásticos.

Using the AWS CLI

Para supervisar una configuración específica de un clúster elástico 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 mediante el comando Consola de administración de AWS o AWS CLI con las instrucciones siguientes.

Using the Consola de administración de AWS

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

  1. Inicie sesión en la Consola de administración de AWS 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 monitorizar 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.

En los siguientes ejemplos de AWS CLI código, se elimina 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 una de ellas 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

En los siguientes ejemplos de AWS CLI código, se elimina 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 monitorizar el estado del clúster, consulte Supervisión del estado de un clúster de Amazon DocumentDB.