Actualización de un parche a la versión del motor de un clúster

En esta sección, explicaremos cómo implementar una actualización de parche utilizando el AWS Management Console o el AWS CLI. Una actualización de parche es una actualización dentro de la misma versión del motor (por ejemplo, la actualización de una versión del motor 3.6 a una versión del motor 3.6 más reciente). Puede actualizarla inmediatamente o durante el próximo periodo de mantenimiento del clúster. Para determinar si el motor necesita una actualización, consulte Determinar el mantenimiento pendiente. Tenga en cuenta que, al aplicar la actualización, su clúster sufrirá algún tiempo de inactividad.

nota

Si está intentando actualizar desde una versión principal del motor a otra, como de la 3.6 a la 5.0, consulte Actualización local de la versión principal Amazon DocumentDB o Actualización del clúster de Amazon DocumentDB mediante AWS Database Migration Service. Una actualización local de la versión principal solo admite docdb 5.0 como versión del motor de destino.

Existen dos requisitos de configuración para obtener las actualizaciones de parches más recientes para la versión del motor de un clúster:

• El estado del clúster debe ser disponible.

• El clúster debe estar ejecutando una versión del motor más antigua.

Using the AWS Management Console

El siguiente procedimiento actualiza los parches de la versión del motor de su clúster a la versión más reciente con la consola. Puede actualizarla inmediatamente o durante el próximo periodo de mantenimiento del 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). En la lista de clústeres, elija el botón situado a la izquierda del clúster que desee actualizar. El estado del clúster debe ser disponible.

   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 de la página.

3. En el menú Actions (Acciones), elija una de las opciones siguientes. Estas opciones de menú solo se pueden seleccionar si en el clúster elegido no se está ejecutando la última versión del motor.

   

   • Actualizar ahora: inicia inmediatamente el proceso de actualización. El clúster se quedará sin conexión durante un tiempo mientras se actualiza a la última versión del motor.

   • Actualizar en el siguiente periodo: inicia el proceso de actualización durante el próximo periodo de mantenimiento del clúster. El clúster se quedará sin conexión durante un tiempo mientras se actualiza a la última versión del motor.

4. Cuando se abra la ventana de confirmación, seleccione una de las siguientes opciones:

   • Actualizar: para actualizar el clúster a la última versión del motor de acuerdo con el plan elegido en el paso anterior.

   • Cancelar: para cancelar la actualización del motor del clúster y continuar con la versión actual del motor del clúster.

Using the AWS CLI

Puede aplicar actualizaciones de parches a su clúster mediante la apply-pending-maintenance-action operación AWS CLI y con los siguientes parámetros.

Parámetros

• --resource-identifier: obligatorio. El ARN del clúster de Amazon DocumentDB que va a actualizar.

• --apply-action: obligatorio. Se permiten los siguientes valores. Para actualizar la versión de su motor de clúster, utilice db-upgrade.

  • db-upgrade

  • system-update

• --opt-in-type: obligatorio. Se permiten los siguientes valores.

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

  • next-maintenance: aplicar la operación de mantenimiento durante el siguiente período de mantenimiento.

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

En el siguiente ejemplo se actualiza la versión del motor de sample-cluster a la versión 4.0.0.

Para Linux, macOS o Unix:

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

Para Windows:

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

El resultado de esta operación será similar a lo que se indica a continuación:

{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "db-upgrade",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}