Mantenimiento de Amazon DocumentDB

Amazon DocumentDB realiza periódicamente dos tipos de mantenimiento:

Los parches del motor y las actualizaciones del sistema operativo utilizan las mismas tres categorías de ciclo de vida (opcionales, obligatorias y forzadas) con el mismo comportamiento de notificación y aplicación para cada categoría. Las versiones del motor también incluyen una cuarta categoría: las versiones secundarias, a las que se actualiza manualmente. Las categorías son las siguientes:

Los parches del motor se publican en una sola categoría (opcionales, obligatorios o forzados) y permanecen ahí. Las actualizaciones del sistema operativo avanzan: la mayoría comienzan como opcionales y, si no se aplican, pasan a ser obligatorias y, finalmente, obligatorias. La fecha exacta depende del parche y se publica en la notificación de AHD y en los campos de fecha devueltos describe-pending-maintenance-actions (consulteFechas de aplicación). Las notas de la versión de Amazon DocumentDB utilizan estos nombres de categorías al anunciar los cambios de motor.

Al aplicar cualquier parche del motor, el clúster se desconecta brevemente. En el resto de este tema, se explica cómo funcionan las ventanas de mantenimiento, cómo encontrar las tareas pendientes, cómo aplicar los parches del motor y las versiones secundarias, cómo funcionan las actualizaciones del sistema operativo y cómo se maneja de forma especial los clústeres globales.

Numeración de versiones del motor

Amazon DocumentDB utiliza dos identificadores de versión independientes:

Puede determinar la versión del motor a partir del prefijo de la versión del parche del motor, como se muestra en la siguiente tabla.

Para comprobar la versión del parche que está ejecutando su clúster, conéctelo y ejecútelodb.runCommand({getEngineVersion: 1}).

Para ver la lista de las versiones de parches de motor publicadas y el contenido de cada una de ellas, consulteNotas de la versión.

Administración de los periodos de mantenimiento de Amazon DocumentDB

Cada clúster y cada instancia tienen su propio período de mantenimiento semanal de 30 minutos, es decir, el período en el que se ejecutan las modificaciones programadas y los parches de software. La mayoría de los eventos se completan en 30 minutos; los más grandes pueden durar más tiempo.

Si no elige una ventana al crear el recurso, Amazon DocumentDB asigna una al azar dentro de un bloque diario de 8 horas definido para la región, en un día seleccionado al azar. Elija ventanas que minimicen el impacto en su aplicación, por ejemplo, por las tardes o los fines de semana.

Para las actualizaciones del motor de base de datos, Amazon DocumentDB utiliza la ventana del clúster, no las ventanas de instancias individuales.

La siguiente tabla muestra los bloques de tiempo predeterminados por región.

Cambio de los periodos de mantenimiento de Amazon DocumentDB

Elige la ventana de menor tráfico que puedas y ajústala con el tiempo a medida que cambien tus patrones de tráfico. El clúster o la instancia no estarán disponibles durante ese período si un cambio de sistema (por ejemplo, una operación de almacenamiento a gran escala o un cambio de clase de instancia) requiere una interrupción y solo durante el tiempo que ese cambio realmente lo requiera.

Notificaciones de parches del motor de Amazon DocumentDB

Cuando un parche de motor obligatorio esté disponible en una AWS región, todas las AWS cuentas con un clúster de Amazon DocumentDB afectado en esa región reciben una notificación a través del Panel de estado (AHD) y por correo electrónico (enviada a la dirección de usuario raíz de la AWS cuenta). Se envía una notificación por cada versión del motor Amazon DocumentDB afectada. Puede encontrarlos en Cambios programados en el AHD. Cada notificación indica el tiempo de disponibilidad de los parches, el programa de aplicación automática, los clústeres afectados y las notas de la versión.

Las notificaciones se envían aproximadamente dos días antes de que se abra la ventana de aplicación automática. Por ejemplo, un parche obligatorio publicado el lunes a las 00:00 UTC puede aplicarse automáticamente el miércoles a las 00:00 UTC. Si el período de mantenimiento de su clúster es el miércoles a las 12:00 UTC, el parche se aplicará automáticamente ese miércoles, aproximadamente 12 horas después de que se abra el período de aplicación automática. Si el período de mantenimiento es el martes a las 12:00 UTC, el parche esperará una semana completa antes de aplicarse automáticamente.

Después de recibir la notificación, tiene dos opciones: aplicar el parche automáticamente antes de la fecha de aplicación automática o esperar a que se aplique automáticamente durante un próximo período de mantenimiento (la opción predeterminada). Para aplicarlo automáticamente, abre la pestaña Mantenimiento y copias de seguridad del clúster y busca la entrada de tipo. system-update

Los parches opcionales y las nuevas versiones secundarias no generan notificaciones de AHD ni por correo electrónico. Para rastrearlos, consulte las notas de la versión de Amazon DocumentDB.

Los parches forzados (la categoría más rara, reservada a las correcciones de seguridad más críticas) también se anuncian a través de AHD y por correo electrónico. A diferencia de los parches obligatorios, se aplican fuera del período de mantenimiento, por lo que el ejemplo anterior de tiempo de aplicación automática no se aplica.

Reaccionar a las notificaciones de parches mediante programación

AWS Health se integra con Amazon EventBridge, lo que le permite crear aplicaciones basadas en eventos en más de 20 destinos, incluido AWS Lambda Amazon Simple Queue Service (SQS). Para reaccionar ante la disponibilidad de los parches del motor mediante programación, configúrelo en función del evento. EventBridge AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED Desde allí, puede capturar los datos del evento, generar eventos adicionales, enviar notificaciones automáticas a través de él o realizar cualquier otra acción que necesite. AWS Console Mobile Application

Si Amazon DocumentDB cancela un parche (raro), recibirá una notificación de AHD y un correo electrónico sobre la cancelación. Usa el código de AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED evento de Amazon EventBridge para gestionar este caso. Para obtener más información sobre la redacción de reglas, consulta la Guía del EventBridge usuario de Amazon.

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

Usa las Consola de administración de AWS o las AWS CLI para comprobar qué tareas de mantenimiento están pendientes para un clúster o una instancia.

Las actualizaciones pendientes aparecen con el tipo de acciónsystem-update, que incluye tanto los parches del motor como las actualizaciones del sistema operativo.

Cuando hay una actualización pendiente, puede:

El período de mantenimiento controla cuándo comienzan las operaciones pendientes, no cuánto tardan en completarse.

Fechas de aplicación

Cada acción de mantenimiento pendiente conlleva hasta tres fechas de aplicación. Aparecen en el AWS CLI resultado de la acción describe-pending-maintenance-actions e indican cuándo se ejecutará. Los campos son null de mantenimiento opcional.

Para aplazar una acción pendiente, traslade el período de mantenimiento a un período posterior el día anteriorAutoAppliedAfterDate. Una vez AutoAppliedAfterDate aprobada, la acción se aplicará automáticamente durante el siguiente período de mantenimiento. Una vez ForcedApplyDate aprobado, no es posible ningún otro aplazamiento. El período de aplazamiento exacto varía según el parche; las fechas se publican en la notificación de AHD y en el AWS CLI resultado.

Actualizaciones del motor de Amazon DocumentDB

Cuando haya identificado un parche de motor pendiente, utilice uno de los siguientes procedimientos para aplicarlo o programarlo. Puede ejecutar estos procedimientos desde Consola de administración de AWS o desde AWS CLI.

Lea la disponibilidad durante la aplicación de parches

Los motores Amazon DocumentDB 5.0 y 8.0 conservan la disponibilidad de lectura durante la aplicación de parches cuando el clúster tiene varias instancias. Amazon DocumentDB parchea las instancias de los lectores de forma continua, en tres grupos, para que los lectores restantes continúen atendiendo el tráfico. El escritor no estará disponible durante un breve periodo de tiempo mientras realiza los parches. Para evitar el tiempo de inactividad de la lectura, establece tus preferencias de lectura para que las lecturas recaigan en el escritor o en el primaryPreferred trabajo, secondaryPreferred primary o secondary por sí solas, se produzca un tiempo de inactividad de lectura.

Mientras los lectores están aplicando los parches, el rendimiento de lectura general del clúster disminuye temporalmente. Para mantener un rendimiento estable, aprovisione lectores adicionales antes de la actualización y quítelos una vez finalizada la actualización.

En los motores 3.6 y 4.0, estas funciones de disponibilidad de lectura no se aplican: un parche del motor provoca un tiempo de inactividad más prolongado que afecta tanto a las lecturas como a las escrituras. Para actualizar a una versión principal que sí lo haga, consulte. Actualización local de la versión principal Amazon DocumentDB

Duración del tiempo de inactividad del parche

Engine-patch el tiempo de inactividad varía. Los factores más importantes son el uso de la CPU y la presión de memoria de la instancia en el momento del parche, por lo que es importante ajustar el tamaño de las instancias. Para minimizar el tiempo de inactividad, ejecute la última versión del motor principal de Amazon DocumentDB y distribuya las instancias en varias zonas de disponibilidad.

Actualizaciones y reemplazos de parches

Amazon DocumentDB supervisa los parches tras su publicación. En el raro caso de que se identifique un problema, Amazon DocumentDB detiene la implementación mientras prepara una versión actualizada. Cuando esto ocurre, los clústeres que aún no han recibido el parche dejan de considerarlo una acción de mantenimiento disponible y se retira la correspondiente notificación de cambio programado que figura en él. Panel de estado Los clústeres que ya ejecutan la versión afectada siguen funcionando con normalidad y no requieren que realices ninguna acción por tu parte.

En breve se publicará un parche actualizado. Cuando esté disponible en su región, recibirá una nueva notificación por correo electrónico, tal Panel de estado y como se describe enNotificaciones de parches del motor de Amazon DocumentDB.

Actualizaciones de la versión secundaria

Amazon DocumentDB publica versiones secundarias además de la versión principal 5.0 y versiones posteriores (por ejemplo,5.0.1). Las versiones secundarias no se publican para las versiones principales anteriores a la 5.0. Las versiones secundarias se comportan de forma diferente a los parches de motor obligatorios y opcionales:

Lee mas:Actualización de la versión secundaria de Amazon DocumentDB.

Actualizaciones del sistema operativo de Amazon DocumentDB

Las instancias ocasionalmente necesitan actualizaciones del sistema operativo. Amazon DocumentDB actualiza el sistema operativo para mejorar el rendimiento y reforzar la seguridad. Las actualizaciones del sistema operativo dejan sin cambios la versión del motor de clústeres y la clase de instancia. Al igual que los parches del motor, las actualizaciones del sistema operativo utilizan el ciclo de vida opcional, obligatorio o forzado que se describe al principio de este tema; a diferencia de los parches del motor, una actualización del sistema operativo puede pasar por estas categorías con el tiempo si se aplaza. Aplique las actualizaciones del sistema operativo tan pronto como estén disponibles y establezca el período de mantenimiento de la instancia en el momento que mejor se adapte a su empresa.

Para recibir un evento cuando llegue una nueva actualización opcional, suscríbase a RDS-EVENT-0230 la categoría de eventos de parches de seguridad. Para obtener más información, consulte Suscripción a suscripciones a eventos de Amazon DocumentDB. Tras recibir una notificación, puede aplicar automáticamente el parche del sistema operativo a cada instancia.

Al parchear un clúster, actualice primero las instancias del lector y, en último lugar, las del escritor. Evite aplicar parches a los lectores y al grabador simultáneamente: una conmutación por error durante el parche puede prolongar el tiempo de inactividad. El mantenimiento de la instancia principal desencadena una conmutación por error, por lo que debe ejecutar más de una instancia por clúster para mantener la disponibilidad. Para obtener más información, consulte Conmutación por error a Amazon DocumentDB.

Las actualizaciones del sistema operativo están vinculadas a versiones de motor y clases de instancias específicas, por lo que las distintas instancias son aptas en diferentes momentos. Cuando una instancia cumple los requisitos, la actualización aparece en la consola; también puedes verla mediante el AWS CLI describe-pending-maintenance-actions comando o la DescribePendingMaintenanceActions API.

Utilice el Consola de administración de AWS o AWS CLI para comprobar si hay alguna actualización disponible.

User-initiated actualizaciones

Algunos cambios los puedes iniciar tú mismo, por ejemplo, cambiar una clase de instancia por una con más o menos memoria o cambiar el grupo de parámetros del clúster. Amazon DocumentDB las trata de forma diferente a las actualizaciones que inicia. Para obtener más información, consulte:

Para enumerar los cambios iniciados por el usuario que aún están pendientes:

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

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

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

Parcheo de clústeres globales

En un clúster global, cada clúster miembro (principal y secundario) se actualiza durante su propio período de mantenimiento. Cuando haya un parche de motor obligatorio disponible en cada región, recibirá un AHD y una notificación por correo electrónico. Los parches opcionales y las nuevas versiones secundarias no generan notificaciones; consulte las notas de la versión de Amazon DocumentDB para consultarlas.

Si los aplica usted mismo, aplique siempre los parches secundarios primero y los principales al final. Este orden permite que la conmutación por error y la conmutación estén disponibles durante todo el lanzamiento.

Si no realizas ninguna acción, el parche se aplica automáticamente durante el siguiente período de mantenimiento de cada clúster: primero los secundarios y, después, el principal en su ventana una vez finalizados los secundarios.

Mantenga los clústeres de bases de datos principal y secundario en la misma versión. La conmutación por error gestionada entre regiones solo funciona en una base de datos global cuando todos los clústeres comparten la misma versión de motor y el mismo nivel de parche. Lo mismo ocurre si agrega una nueva versión secundaria que utilice una versión del motor más reciente que la principal: cree nuevas secundarias en la versión principal antes de unirlas a la base de datos global.

Tras recibir una notificación de parche, actualice la versión principal y secundaria a la versión más reciente lo antes posible para que la conmutación por error y la conmutación sigan funcionando. Si se rechaza una solicitud de conmutación por error o cambio, compare las versiones de los parches del motor entre los clústeres; si no coinciden, aplique el parche disponible en los clústeres más retrasados.