Actualizaciones de software de servicio en Amazon OpenSearch Service

Amazon OpenSearch Service publica periódicamente actualizaciones de software de servicio que añaden funciones o mejoran tus dominios. El panel Notificaciones en la consola es la forma más sencilla para ver si hay disponible una actualización o para verificar el estado de una actualización. Cada notificación incluye detalles sobre la actualización del software del servicio. Todas las actualizaciones de software utilizan implementaciones azul/verde para minimizar el tiempo de inactividad.

Las actualizaciones del software del servicio son diferentes de las actualizaciones de las versiones del OpenSearch servicio. Para obtener información sobre la actualización a una versión posterior del OpenSearch Servicio, consulteActualización de los dominios OpenSearch de Amazon Service.

OpenSearch El servicio requiere que aplique las actualizaciones de software de servicio requeridas en un plazo de 30 días a partir de su disponibilidad. Estas actualizaciones son fundamentales para mantener el cumplimiento de las normas de seguridad.

Si no aplicas las actualizaciones obligatorias dentro del período de 30 días, recibirás notificaciones recordatorias cada 15 días durante 30 días. Tras este periodo sin conformidad, tu dominio quedará aislado con los siguientes efectos:

Durante el aislamiento, seguirás recibiendo notificaciones recordatorias cada 15 días durante 60 días. Si no aplicas las actualizaciones necesarias dentro de este período, tu dominio de OpenSearch servicio y todos los datos asociados se eliminarán permanentemente. Para obtener más información, consulta Solución de errores de validación.

Actualizaciones opcionales frente a actualizaciones obligatorias

OpenSearch El servicio tiene dos categorías amplias de actualizaciones de software de servicio:

Actualizaciones opcionales

Las actualizaciones del software de servicio opcionales generalmente incluyen mejoras y soporte para nuevas características o funcionalidades. Las actualizaciones opcionales no se aplican a sus dominios y no hay un plazo fijo para instalarlas. La disponibilidad de la actualización se comunica por correo electrónico y una notificación en la consola. Puede optar por aplicar la actualización inmediatamente o reprogramarla para una fecha y hora más adecuadas. También puede programarla durante la ventana de menor actividad del dominio. La mayoría de las actualizaciones de software son opcionales.

Independientemente de si programa o no una actualización, si realiza un cambio en el dominio que provoque una implementación azul/verde, OpenSearch Service actualizará automáticamente el software del servicio por usted.

Puede configurar su dominio para que aplique automáticamente las actualizaciones opcionales durante la ventana de menor actividad. Cuando esta opción está activada, el OpenSearch Servicio espera al menos 13 días desde que esté disponible una actualización opcional y, a continuación, programa la actualización después de siete días. Recibirá una notificación en la consola cuando la actualización esté programada y podrá elegir reprogramarla para una fecha posterior.

Para activar las actualizaciones de software automáticas, seleccione Habilitar la actualización automática de software al crear o actualizar su dominio. Para configurar el mismo ajuste mediante el AWS CLI, --software-update-options true establézcalo al crear o actualizar el dominio.

Actualizaciones requeridas

Las actualizaciones de software de servicio requeridas suelen incluir correcciones de seguridad críticas u otras actualizaciones obligatorias para garantizar la integridad y la funcionalidad continuas de su dominio. Algunos ejemplos de actualizaciones obligatorias son las vulnerabilidades y exposiciones comunes de Log4j () y la aplicación de la versión 2 (CVEs) del Servicio de Metadatos de Instancia. IMDSv2 El número de actualizaciones obligatorias en un año suele ser inferior a tres.

OpenSearch El servicio programa automáticamente estas actualizaciones y le notifica siete días antes de la actualización programada por correo electrónico y una notificación de consola. Puede optar por aplicar la actualización inmediatamente o reprogramarla para una fecha y hora más adecuadas dentro del plazo permitido. También puede programarla durante la próxima ventana de menor actividad del dominio. Si no realizas ninguna acción en relación con una actualización obligatoria y no realizas ningún cambio en el dominio que provoque una blue/green implementación, el OpenSearch Servicio puede iniciar la actualización en cualquier momento después de la fecha límite especificada (normalmente 14 días a partir de la disponibilidad), dentro del período de menor actividad del dominio.

Independientemente de cuándo esté programada la actualización, si realizas un cambio en el dominio que provoque un despliegue azul o verde, OpenSearch Service actualizará tu dominio automáticamente.

Actualizaciones de revisión

Las versiones del software de servicio que terminan en «-P» y en un número, como R20211203-, son versiones de parches. P4 Es probable que las revisiones incluyan mejoras de rendimiento, correcciones de errores menores y correcciones de seguridad o mejoras de posición. Las versiones de revisión no incluyen nuevas características ni cambios extraordinarios y, por lo general, no tienen un impacto directo o notable en los usuarios. La notificación del software de servicio le indica si el lanzamiento de una revisión es opcional u obligatoria.

Consideraciones

Tenga en cuenta lo siguiente cuando tenga que tomar una decisión sobre la actualización del dominio:

Iniciar una actualización del software de servicio

Puede solicitar una actualización del software del servicio a través de la consola de OpenSearch servicio AWS CLI, la o una de las SDKs.

aws opensearch start-service-software-update \
  --domain-name my-domain \
  --schedule-at "NOW"

{
    "ServiceSoftwareOptions": {
        "CurrentVersion": "R20220928-P1",
        "NewVersion": "R20220928-P2",
        "UpdateAvailable": true,
        "Cancellable": true,
        "UpdateStatus": "PENDING_UPDATE",
        "Description": "",
        "AutomatedUpdateDate": "1969-12-31T16:00:00-08:00",
        "OptionalDeployment": true
    }
}

import boto3
from botocore.config import Config
import time

# Build the client using the default credential configuration.
# You can use the CLI and run 'aws configure' to set access key, secret
# key, and default region.

my_config = Config(
    # Optionally lets you specify a Region other than your default.
    region_name='us-east-1'
)

domain_name = ''  # The name of the domain to check and update

client = boto3.client('opensearch', config=my_config)


def getUpdateStatus(client):
    """Determines whether the domain is eligible for an update"""
    response = client.describe_domain(
        DomainName=domain_name
    )
    sso = response['DomainStatus']['ServiceSoftwareOptions']
    if sso['UpdateStatus'] == 'ELIGIBLE':
        print('Domain [' + domain_name + '] is eligible for a service software update from version ' +
              sso['CurrentVersion'] + ' to version ' + sso['NewVersion'])
        updateDomain(client)
    else:
        print('Domain is not eligible for an update at this time.')


def updateDomain(client):
    """Starts a service software update for the eligible domain"""
    response = client.start_service_software_update(
        DomainName=domain_name
    )
    print('Updating domain [' + domain_name + '] to version ' +
          response['ServiceSoftwareOptions']['NewVersion'] + '...')
    waitForUpdate(client)


def waitForUpdate(client):
    """Waits for the domain to finish updating"""
    response = client.describe_domain(
        DomainName=domain_name
    )
    status = response['DomainStatus']['ServiceSoftwareOptions']['UpdateStatus']
    if status == 'PENDING_UPDATE' or status == 'IN_PROGRESS':
        time.sleep(30)
        waitForUpdate(client)
    elif status == 'COMPLETED':
        print('Domain [' + domain_name +
              '] successfully updated to the latest software version')
    else:
        print('Domain is not currently being updated.')

def main():
    getUpdateStatus(client)

Programación de actualizaciones del software durante las ventanas de menor actividad

Cada dominio OpenSearch de servicio creado después del 16 de febrero de 2023 tiene un período diario de 10 horas entre las 22:00 y las 8:00 a. m., hora local, que consideramos el período de menor actividad. OpenSearch El servicio usa esta ventana para programar las actualizaciones del software del servicio para el dominio. Las actualizaciones fuera de las horas pico ayudan a minimizar la carga de los nodos maestros dedicados de un clúster durante los períodos de mayor tráfico. OpenSearch El servicio no puede iniciar las actualizaciones fuera de este período de 10 horas sin su consentimiento.

Para cada dominio, puede optar por anular la hora de inicio predeterminada a las 22:00 por una hora personalizada. Para obtener instrucciones, consulte Configuración de un intervalo de menor demanda personalizado.

aws opensearch start-service-software-update \
  --domain-name my-domain \
  --schedule-at "OFF_PEAK_WINDOW"

Supervisar actualizaciones de software de servicio

OpenSearch El servicio envía una notificación cuando una actualización del software del servicio está disponible, es necesaria, se ha iniciado, se ha completado o se ha producido un error. Puede ver estas notificaciones en el panel de notificaciones de la consola de OpenSearch servicio. La gravedad de la notificación es Informational si la actualización es opcional y High si es necesaria.

OpenSearch El servicio también envía eventos de software de servicio a Amazon EventBridge. Puede utilizarlas EventBridge para configurar reglas que envíen un correo electrónico o realicen una acción específica cuando se recibe un evento. Para ver un ejemplo de recorrido, consulteTutorial: Sending Amazon SNS alerts for available software updates.

Para ver el formato de cada evento de software de servicio enviado a Amazon EventBridge, consultaEventos de actualización del software de servicio.

Cuando los dominios no son aptos para una actualización

El dominio no es apto para una actualización del software de servicio si está en cualquiera de los estados que se muestran a continuación:

Revertir una actualización de software de servicio

Amazon OpenSearch Service admite la reversión de las actualizaciones de software del servicio. Puede iniciar una reversión mediante la consola OpenSearch de servicio AWS CLI, la o una de las AWS SDKs. Las actualizaciones de software se revierten mediante una blue/green implementación.

Requisitos y consideraciones para la reversión

Para que la reversión esté disponible, tu dominio debe cumplir todas las condiciones siguientes:

Períodos de tiempo de reversión

La ventana de reversión depende del tipo de actualización de software que se haya aplicado.

Cuando caduque el período de reversión, la reversión de autoservicio ya no estará disponible. Póngase en contacto con nosotros Soportesi tiene un problema grave después de que se haya cerrado la ventana.

¿Cómo solicitar una reversión

Puedes solicitar una reversión mediante la RollbackServiceSoftwareUpdate API.

Solicitud

POST /2021-01-01/opensearch/serviceSoftwareUpdate/rollback

Cuerpo de la solicitud:

{
    "DomainName": "your-domain-name"
}

Respuesta

La API devuelve una respuesta HTTP 200 en todos los casos en los que no se produzca un error. El RollbackAvailable campo del cuerpo de la respuesta indica si se inició la reversión.

{
    "RollbackServiceSoftwareOptions": {
        "CurrentVersion": "string",
        "NewVersion": "string",
        "RollbackAvailable": boolean,
        "Description": "string"
    }
}

Campos de la respuesta

Respuestas de error

Mensajes de respuesta

En la siguiente tabla se describen los posibles mensajes de respuesta devueltos por la RollbackServiceSoftwareUpdate API.

Ejemplo de respuesta:

{
    "RollbackServiceSoftwareOptions": {
        "CurrentVersion": "OpenSearch_2_11_R20240115",
        "NewVersion": "OpenSearch_2_11_R20231023",
        "RollbackAvailable": true,
        "Description": "Rollback initiated successfully. The domain will be rolled back from OpenSearch_2_11_R20240115 to OpenSearch_2_11_R20231023."
    }
}

Cuando la reversión no está disponible, RollbackAvailable regresa false y el Description campo contiene el motivo de la tabla anterior.