Mantenimiento de Amazon DocumentDB - Amazon DocumentDB

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.

Mantenimiento de Amazon DocumentDB

Amazon DocumentDB realiza tareas de mantenimiento periódicas en los recursos de Amazon DocumentDB. En la mayoría de los casos, estas tareas de mantenimiento incluyen actualizaciones del motor de base de datos (mantenimiento de clústeres) o el sistema operativo subyacente de la instancia (mantenimiento de instancias). Las actualizaciones del motor de base de datos son parches necesarios e incluyen correcciones de seguridad, correcciones de errores y mejoras en el motor de base de datos. Si bien la mayoría de los parches del sistema operativo son opcionales, si no los aplica durante un tiempo, es posible que el parche sea necesario y se aplique automáticamente para mantener su postura de seguridad. Por lo tanto, le recomendamos que aplique las actualizaciones del sistema operativo a sus instancias de Amazon DocumentDB tan pronto como estén disponibles.

Los parches del motor de base de datos necesitan que desconecte los clústeres de Amazon DocumentDB durante un breve plazo de tiempo. Una vez disponibles, estos parches se programan automáticamente para que se apliquen durante un próximo periodo de mantenimiento programado del clúster de Amazon DocumentDB.

Los clústeres y las instancias tienen sus propios periodos de mantenimiento. Las modificaciones de la instancia y clúster que haya decidido no aplicar inmediatamente también se aplican durante el periodo de mantenimiento. De forma predeterminada, al crear un clúster, Amazon DocumentDB asigna un periodo de mantenimiento tanto para el clúster como para cada instancia individual. Puede elegir el periodo de mantenimiento en el momento de crear un clúster o una instancia. También puede modificar los periodos de mantenimiento en cualquier momento para ajustarlos a las prácticas o las programaciones de su empresa. Por lo general, se recomienda elegir periodos de mantenimiento que minimicen la repercusión de las tareas de mantenimiento en la aplicación (por ejemplo, por las noches o durante los fines de semana).

Notificaciones de parches del motor de Amazon DocumentDB

Recibirá notificaciones de mantenimiento de los parches del motor de base de datos necesarios mediante eventos de estado en AWS Health Dashboard (AHD) de la AWS consola y mediante correos electrónicos. Cuando un parche de mantenimiento del motor de Amazon DocumentDB esté disponible en una AWS región concreta, todas las cuentas de usuario de Amazon DocumentDB afectadas de la región recibirán AHD una notificación por correo electrónico para cada versión de Amazon DocumentDB afectada por el parche. Puede ver estas notificaciones en la sección de cambios programados de la consolaAHD. AWS La notificación incluirá detalles sobre el tiempo de disponibilidad de los parches, el calendario de aplicación automática, la lista de clústeres afectados y las notas de la versión. Esta notificación también se enviará por correo electrónico a la dirección de correo electrónico del usuario raíz de la AWS cuenta.

Consola de Amazon DocumentDB que muestra la pestaña de cambios programados para las actualizaciones de los parches del motor.

Una vez que reciba esta notificación, podrá optar por aplicar automáticamente estos parches del motor a los clústeres de Amazon DocumentDB antes de la fecha de aplicación automática programada. O bien, puede esperar a que los parches del motor se apliquen automáticamente durante un próximo periodo de mantenimiento (opción predeterminada).

nota

El estado de la notificación en el se AHD establecerá en «En curso» hasta que se publique un nuevo parche del motor Amazon DocumentDB con una nueva versión del parche del motor.

Una vez aplicado el parche del motor al clúster de Amazon DocumentDB, la versión del parche del motor del clúster se actualizará para reflejar la versión en la notificación. Puede ejecutar el comando db.runCommand({getEngineVersion: 1}) para verificar esta actualización.

AWS Health también se integra con Amazon EventBridge , que utiliza eventos para crear aplicaciones escalables basadas en eventos y se integra con más de 20 destinos, incluidos AWS Lambda Amazon Simple Queue Service (SQS) y otros. Puedes usar el código de AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED evento para configurar Amazon EventBridge antes de que los parches del motor estén disponibles. Puede configurarlo EventBridge para responder al evento y realizar automáticamente acciones, como capturar información sobre el evento, iniciar eventos adicionales, enviar notificaciones a través de canales adicionales, como notificaciones push AWS Console Mobile Application, y tomar medidas correctivas o de otro tipo, cuando un parche del motor Amazon DocumentDB esté disponible en su región.

En el raro caso de que Amazon DocumentDB cancele un parche del motor, recibirá una AHD notificación y un correo electrónico informándole de la cancelación. En consecuencia, puedes usar el código de AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED evento para configurar Amazon EventBridge para que responda a este evento. Consulta la Guía del EventBridge usuario de Amazon para obtener más información sobre el uso de EventBridge las reglas de Amazon.

Visualización de las operaciones de mantenimiento pendientes de Amazon DocumentDB

Puedes ver si hay una actualización de mantenimiento disponible para tu clúster utilizando el AWS Management Console o el AWS CLI.

Si hay disponible una actualización, puede realizar una de las acciones siguientes:

  • Aplace una acción de mantenimiento que esté actualmente programada para el próximo periodo de mantenimiento (solo para los parches del sistema operativo).

  • Aplicar inmediatamente las operaciones de mantenimiento.

  • Programar las operaciones de mantenimiento para que se inicien durante el siguiente periodo de mantenimiento.

nota

Si no lleva a cabo ninguna acción, las acciones de mantenimiento necesarias, como los parches del motor, se aplicarán automáticamente en un próximo periodo de mantenimiento programado.

El periodo de mantenimiento determina el momento en que comienzan las operaciones pendientes, pero no limita su tiempo total de ejecución.

Using the AWS Management Console
  1. Inicie sesión en y abra la AWS Management Console consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.

  2. En el panel de navegación, seleccione Clusters (Clústeres).

  3. Si hay disponible una actualización, se indicará con la palabra Disponible o Obligatorio, o Siguiente periodo en la columna Mantenimiento del clúster en la consola de Amazon DocumentDB, como se muestra a continuación:

    Consola de Amazon DocumentDB que muestra la columna Maintenance (Mantenimiento) de los clústeres.
  4. Para realizar una acción, elija la instancia el clúster para mostrar sus detalles y, a continuación, seleccione Mantenimiento y copias de seguridad. Aparecerán los elementos de mantenimiento pendientes.

    La consola de Amazon DocumentDB muestra la ventana de mantenimiento del clúster.
Using the AWS CLI

Utilice la siguiente AWS CLI operación para determinar qué acciones de mantenimiento están pendientes. Este resultado indica que no hay ninguna operación de mantenimiento pendiente.

aws docdb describe-pending-maintenance-actions

El resultado de esta operación tiene un aspecto parecido al siguiente (JSONformato).

{ "PendingMaintenanceActions": [] }

Actualizaciones del motor de Amazon DocumentDB

Con Amazon DocumentDB puede elegir el momento en que desea aplicar las operaciones de mantenimiento. Puede decidir cuándo Amazon DocumentDB aplica las actualizaciones mediante las AWS Management Console teclas o. AWS CLI

Utilice los procedimientos que se explican en este tema para actualizar inmediatamente o para programar una actualización del clúster.

Using the AWS Management Console

Puede utilizar la consola para administrar las actualizaciones de las instancias y los clústeres de Amazon DocumentDB.

Administración de la actualización de un clúster
  1. Inicie sesión en y abra la AWS Management Console consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.

  2. En el panel de navegación, seleccione Clusters (Clústeres).

  3. En la lista de clústeres, elija el botón situado junto al nombre del clúster al que desea aplicar la operación de mantenimiento.

  4. En el menú Actions (Acciones), elija una de las opciones siguientes:

    • Upgrade now (Actualizar ahora) para realizar inmediatamente las tareas de mantenimiento pendientes.

    • Upgrade at next window (Actualizar en el siguiente periodo) para realizar las tareas de mantenimiento pendientes durante el siguiente periodo de mantenimiento del clúster.

    También puede hacer clic en Aplicar ahora o Aplicar durante la próxima ventana de mantenimiento en la sección Mantenimiento pendiente de la pestaña Mantenimiento y copias de seguridad del clúster (consulte Utilización de la AWS Management Console en la sección anterior).

    nota

    Si no hay tareas de mantenimiento pendientes, las opciones anteriores están inactivas.

Using the AWS CLI

Para aplicar una actualización pendiente a un clúster, utilice la operación. apply-pending-maintenance-action AWS CLI

Parámetros
  • --resource-identifier—El nombre del recurso de Amazon de Amazon DocumentDB (ARN) del recurso al que se aplica la acción de mantenimiento pendiente.

  • --apply-action: la acción de mantenimiento pendiente que se aplica a este recurso.

    Valores válidos: system-update y db-upgrade.

  • --opt-in-type: un valor que indica el tipo de solicitud de alta o deshace una solicitud de alta. Una solicitud de alta de tipo immediate no se puede deshacer.

    Valores válidos:

    • immediate: aplicar inmediatamente la acción de mantenimiento.

    • next-maintenance: aplicar la acción de mantenimiento durante la siguiente ventana de mantenimiento del recurso.

    • undo-opt-in: cancelar todas las solicitudes de alta next-maintenance existentes.

Para Linux, macOS o Unix:

aws docdb apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb \ --apply-action system-update \ --opt-in-type immediate

Para Windows:

aws docdb apply-pending-maintenance-action ^ --resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb ^ --apply-action system-update ^ --opt-in-type immediate

Para obtener una lista de los recursos que tienen al menos una actualización pendiente, utilice la describe-pending-maintenance-actions AWS CLI operación.

Para Linux, macOS o Unix:

aws docdb describe-pending-maintenance-actions \ --resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb

Para Windows:

aws docdb describe-pending-maintenance-actions ^ --resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb

El resultado de esta operación tiene un aspecto similar al siguiente (JSONformato).

{ "PendingMaintenanceActions": [ { "ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:sample-cluster", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "CurrentApplyDate": "2019-01-11T03:01:00Z", "Description": "db-version-upgrade", "ForcedApplyDate": "2019-01-18T03:01:00Z", "AutoAppliedAfterDate": "2019-01-11T03:01:00Z" } ] } ] }

También puede devolver una lista de recursos de un clúster especificando el --filters parámetro de la describe-pending-maintenance-actions AWS CLI operación. El formato de la operación --filters es Name=filter-name,Values=resource-id,....

db-cluster-id son los valores aceptados para el parámetro Name del filtro. Este valor acepta una lista de identificadores de clúster oARNs. La lista devuelta solo incluye las acciones de mantenimiento pendientes para los clústeres identificados por estos identificadores o. ARNs

En el ejemplo siguiente se obtienen las operaciones de mantenimiento pendientes para los clústeres sample-cluster1 y sample-cluster2.

Para Linux, macOS o Unix:

aws docdb describe-pending-maintenance-actions \ --filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2

Para Windows:

aws docdb describe-pending-maintenance-actions ^ --filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2

Fechas de aplicación

Cada operación de mantenimiento tiene una fecha de aplicación que encontrará al describir las operaciones de mantenimiento pendientes. Al leer el resultado de las acciones de mantenimiento pendientes del AWS CLI, aparecen tres fechas. Estos valores de fecha son null cuando el mantenimiento es opcional. Los valores se rellenan una vez que se programa o aplica la acción de mantenimiento correspondiente.

  • CurrentApplyDate: fecha en la que se aplicará la acción de mantenimiento inmediatamente o en la siguiente ventana de mantenimiento.

  • ForcedApplyDate: fecha en la que el mantenimiento se aplicará automáticamente, independientemente del período de mantenimiento.

  • AutoAppliedAfterDate: fecha a partir de la cual se aplicará el mantenimiento durante el período de mantenimiento del clúster.

Actualizaciones iniciadas por el usuario

Como usuario de Amazon DocumentDB, puede iniciar las actualizaciones de los clústeres o las instancias. Por ejemplo, puede cambiar la clase de una instancia por otra con más o menos memoria o modificar el grupo de parámetros de un clúster. Amazon DocumentDB ve estos cambios de forma diferente a las actualizaciones iniciadas por Amazon DocumentDB. Para obtener más información sobre cómo modificar un clúster o una instancia, consulte lo siguiente:

Para ver una lista de modificaciones pendientes iniciadas por el usuario, ejecute el siguiente comando.

Para ver los cambios pendientes iniciados por el usuario para las instancias

Para Linux, macOS o Unix:

aws docdb describe-db-instances \ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'

Para Windows:

aws docdb describe-db-instances ^ --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'

El resultado de esta operación tiene un aspecto parecido al siguiente (JSONformato).

En este caso, sample-cluster-instance tiene un cambio pendiente en una clase de instancia db.r5.xlarge, mientras que sample-cluster-instance-2 no tiene ningún cambio pendiente.

[ [ "sample-cluster", "sample-cluster-instance", { "DBInstanceClass": "db.r5.xlarge" } ], [ "sample-cluster", "sample-cluster-instance-2", {} ] ]

Administración de los periodos de mantenimiento de Amazon DocumentDB

Cada instancia y clúster incluye un periodo de mantenimiento semanal durante el que se aplican los cambios pendientes. Este periodo de mantenimiento es una oportunidad de controlar cuándo se producen modificaciones y se aplican parches de software, en caso de que se solicite o sea necesario. Si hay un evento de mantenimiento programado para una semana determinada, se iniciará durante el periodo de mantenimiento de 30 minutos que identifique. La mayoría de los eventos de mantenimiento también se completan durante el periodo de mantenimiento de 30 minutos, aunque otros eventos de mantenimiento pueden tardar más de 30 minutos en completarse.

El periodo de mantenimiento de 30 minutos se selecciona al azar dentro de un bloque de 8 horas por región. Si no especifica un periodo de mantenimiento preferido al crear una instancia o un clúster, Amazon DocumentDB asigna un periodo de mantenimiento de 30 minutos un día de la semana seleccionado al azar.

En la siguiente tabla, se muestran los bloques de tiempo de cada región desde los que se asignan los periodos de mantenimiento predeterminados.

Nombre de la región Región UTCBloque de tiempo
Este de EE. UU. (Ohio) us-east-2 03:00-11:00
Este de EE. UU. (Norte de Virginia) us-east-1 03:00-11:00
Oeste de EE. UU. (Oregón) us-west-2 06:00-14:00
África (Ciudad del Cabo) af-south-1 03:00-11:00
Asia-Pacífico (Hong Kong) ap-east-1 06:00-14:00
Asia-Pacífico (Hyderabad) ap-south-2 06:30–14:30
Asia Pacífico (Bombay) ap-south-1 06:00-14:00
Asia Pacífico (Seúl) ap-northeast-2 13:00-21:00
Asia-Pacífico (Singapur) ap-southeast-1 14:00–22:00
Asia Pacífico (Sídney) ap-southeast-2 12:00–20:00
Asia-Pacífico (Tokio) ap-northeast-1 13:00-21:00
Canadá (centro) ca-central-1 03:00-11:00
China (Pekín) cn-north-1 06:00-14:00
China (Ningxia) cn-northwest-1 06:00-14:00
Europa (Fráncfort) eu-central-1 21:00-05:00
Europa (Irlanda) eu-west-1 22:00-06:00
Europa (Londres) eu-west-2 22:00-06:00
Europa (Milán) eu-south-1 02:00-10:00
Europa (París) eu-west-3 23:59-07:29
Europa (España) eu-south-2 02:00-10:00
Medio Oriente (UAE) me-central-1 05:00-13:00
América del Sur (São Paulo) sa-east-1 00:00-08:00
AWS GovCloud (EEUU-Este) us-gov-east-1 17:00-01:00
AWS GovCloud (Estados Unidos-Oeste) us-gov-west-1 06:00-14:00

Cambio de los periodos de mantenimiento de Amazon DocumentDB

El periodo de mantenimiento debe corresponder al momento de mínimo uso y, por tanto, podría ser preciso modificarlo cada cierto tiempo. El clúster o la instancia solo dejan de estar disponibles durante este periodo si se están aplicando cambios en el sistema (por ejemplo, se está realizando una operación de escalado del almacenamiento o un cambio de clase de instancia) y se requiere una interrupción. En ese caso, solo dejará de estar disponible durante el tiempo mínimo requerido para realizar los cambios necesarios.

En el caso de las actualizaciones del motor de base de datos, Amazon DocumentDB utiliza el periodo de mantenimiento preferido del clúster y no el periodo de mantenimiento de las instancias individuales.

Para cambiar el periodo de mantenimiento

Actualizaciones del sistema operativo de Amazon DocumentDB

En ocasiones, las instancias de los clústeres de Amazon DocumentDB requieren actualizaciones del sistema operativo. Amazon DocumentDB actualiza el sistema operativo a una versión más reciente para mejorar el rendimiento de la base de datos y la posición de seguridad general de los clientes. Las actualizaciones del sistema operativo no cambian la versión del motor del clúster ni la clase de instancia de una instancia de Amazon DocumentDB.

Le recomendamos que actualice primero las instancias del lector en un clúster y, a continuación, la instancia del escritor para maximizar la disponibilidad de su clúster. No recomendamos actualizar las instancias de lector y escritor al mismo tiempo, ya que podría producirse un tiempo de inactividad en caso de una conmutación por error.

La mayoría de las actualizaciones del sistema operativo para Amazon DocumentDB son opcionales y no tienen una fecha fija para aplicarlas. Sin embargo, si no aplica estas actualizaciones durante un tiempo, es posible que acaben siendo necesarias y se apliquen automáticamente durante el periodo de mantenimiento de la instancia. Esto ayuda a mantener la posición de seguridad de la base de datos. Para evitar cualquier tiempo de inactividad inesperado, le recomendamos que aplique las actualizaciones del sistema operativo a las instancias de Amazon DocumentDB tan pronto como estén disponibles y que establezca el periodo de mantenimiento de las instancias en el momento que le resulte más conveniente según las necesidades de la empresa.

Para recibir una notificación cuando haya una nueva actualización opcional disponible, puedes suscribirte al RDS - EVENT -0230 en la categoría de eventos de parches de seguridad. Para obtener información sobre la suscripción a eventos de Amazon DocumentDB, consulte Suscripción a eventos de Amazon DocumentDB.

Debe esperar que, mientras se lleva a cabo el mantenimiento en el clúster o la instancia, si se trata de una instancia principal, se producirá una conmutación por error. Para mejorar su disponibilidad, le recomendamos que utilice más de una instancia para sus clústeres de Amazon DocumentDB. Para obtener más información, consulte Conmutación por error a Amazon DocumentDB.

nota

Para determinadas funciones de administración, Amazon DocumentDB utiliza una tecnología operativa que se comparte con Amazon Relational Database Service (Amazon). RDS

importante

La instancia de Amazon DocumentDB se desconectará durante la actualización del sistema operativo. Puede minimizar el tiempo de inactividad del clúster si dispone de un clúster de varias instancias. Si no tiene un clúster de varias instancias, puede optar por crear uno temporalmente mediante la adición de instancias secundarias para llevar a cabo este mantenimiento y, a continuación, eliminar las instancias de lectura adicionales una vez finalizado el mantenimiento (se aplicarán los cargos habituales por la instancia secundaria).

nota

Mantenerse al día en todas las actualizaciones opcionales y obligatorias podría ser necesario para cumplir varias obligaciones de conformidad. Le recomendamos que aplique todas las actualizaciones que Amazon DocumentDB pone a disposición de forma rutinaria durante los periodos de mantenimiento.

Puede utilizar la AWS Management Console o la AWS CLI para determinar si hay una actualización disponible.

Using the AWS Management Console

Para determinar si una actualización está disponible mediante la AWS Management Console:

  1. Inicie sesión en y abra la AWS Management Console consola de Amazon DocumentDB en https://console.aws.amazon.com /docdb.

  2. En el panel de navegación, elija Clústeres y, a continuación, seleccione la instancia.

  3. Elija Mantenimiento.

  4. En la sección Mantenimiento pendiente, busque la actualización del sistema operativo.

Consola de Amazon DocumentDB que muestra la columna Maintenance (Mantenimiento) de los clústeres.

Puede seleccionar la actualización del sistema operativo y hacer clic en Aplicar ahora o en Aplicar durante la próxima ventana de mantenimiento en la sección Mantenimiento pendiente. Si el valor de mantenimiento es siguiente periodo, aplace los elementos de mantenimiento seleccionando aplazar actualización. No puede aplazar una acción de mantenimiento si ya se ha iniciado.

Como alternativa, puede elegir la instancia de una lista de clústeres haciendo clic en Clústeres en el panel de navegación y seleccionando Aplicar ahora o Aplicar durante la próxima ventana de mantenimiento en el menú Acciones.

Using the AWS CLI

Para determinar si hay una actualización disponible mediante el AWS CLI, ejecute el comando: describe-pending-maintenance-actions

aws docdb describe-pending-maintenance-actions
{ "ResourceIdentifier": "arn:aws:docdb:us-east-1:123456789012:db:mydb2", "PendingMaintenanceActionDetails": [ { "Action": "system-update", "Description": "New Operating System update is available" } ] }

Las actualizaciones del sistema operativo son específicas para la versión del motor de Amazon DocumentDB y la clase de instancia. Por lo tanto, las instancias de Amazon DocumentDB reciben o requieren actualizaciones en diferentes momentos. Cuando una actualización del sistema operativo está disponible para su instancia en función de su versión del motor y de la clase de instancia, la actualización aparece en la consola. También se puede ver ejecutando el AWS CLI describe-pending-maintenance-actions comando o llamando a la DescribePendingMaintenanceActions API operación.

Si no está ejecutando la última versión del parche de clúster del motor de Amazon DocumentDB, es posible que la actualización del sistema operativo no aparezca en la lista de mantenimiento disponible. Para ver y administrar la actualización del sistema operativo, primero debe actualizar a la versión más reciente de parche del motor.