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 OpenSearch versiones. Para obtener información sobre la actualización a una versión posterior de OpenSearch, consulteActualización de los dominios OpenSearch de Amazon Service.

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 72 horas (tres 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 te lo notifica 72 horas (tres 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 implementación azul o verde, 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/verde, OpenSearch Service actualizará tu dominio automáticamente.

Actualizaciones de revisión

Versiones de software de mantenimiento que terminan en «-P» y en un número, como R20211203-P4, son versiones de parches. 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 lasSDKs.

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 tutorial de ejemplo, consulte Tutorial: 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: