Mises à jour du logiciel de service dans Amazon OpenSearch Service

Amazon OpenSearch Service publie régulièrement des mises à jour du logiciel de service qui ajoutent des fonctionnalités ou améliorent vos domaines. Le panneau Notifications de la console constitue le moyen le plus simple de savoir si une mise à jour est disponible ou de vérifier le statut d'une mise à jour. Chaque notification inclut des détails sur la mise à jour du logiciel de service. Toutes les mises à jour du logiciel de service utilisent des déploiements bleu/vert afin de minimiser les temps d'arrêt.

Les mises à jour du logiciel de OpenSearch service diffèrent des mises à niveau des versions du service. Pour plus d'informations sur la mise à niveau vers une version ultérieure de OpenSearch Service, consultezMise à niveau des domaines Amazon OpenSearch Service.

OpenSearch Le service exige que vous appliquiez les mises à jour logicielles de service requises dans les 30 jours suivant leur disponibilité. Ces mises à jour sont essentielles au maintien de la conformité en matière de sécurité.

Si vous n'appliquez pas les mises à jour requises dans le délai de 30 jours, vous recevrez des notifications de rappel tous les 15 jours pendant 30 jours. Après cette période de non-conformité, votre domaine sera isolé avec les effets suivants :

Pendant l'isolement, vous continuerez de recevoir des notifications de rappel tous les 15 jours pendant 60 jours. Si vous n'appliquez pas les mises à jour requises pendant cette période, votre domaine de OpenSearch service et toutes les données associées seront définitivement supprimés. Pour plus d'informations, consultez la section Résolution des erreurs de validation.

Mises à jour facultatives ou obligatoires

OpenSearch Le service comprend deux grandes catégories de mises à jour logicielles :

mises à jour facultatives

Les mises à jour facultatives du logiciel de service incluent généralement des améliorations et la prise en charge de nouvelles fonctionnalités. Les mises à jour facultatives ne sont pas appliquées à vos domaines, et il n'y a pas de date limite stricte pour les installer. La disponibilité de la mise à jour est communiquée par e-mail et par notification sur la console. Vous pouvez choisir d'appliquer la mise à jour immédiatement ou de la reprogrammer à une date et à une heure plus appropriées. Vous pouvez également le planifier pendant les heures creuses du domaine. La plupart des mises à jour logicielles sont facultatives.

Que vous planifiez ou non une mise à jour, si vous apportez une modification au domaine qui entraîne un déploiement bleu/vert, le OpenSearch Service met automatiquement à jour votre logiciel de service pour vous.

Vous pouvez configurer votre domaine pour appliquer automatiquement les mises à jour facultatives en dehors des heures de pointe. Lorsque cette option est activée, le OpenSearch service attend au moins 13 jours à compter de la date à laquelle une mise à jour facultative est disponible, puis planifie la mise à jour au bout de sept jours. Vous recevez une notification de console lorsque la mise à jour est planifiée et vous pouvez choisir de la reprogrammer à une date ultérieure.

Pour activer les mises à jour logicielles automatiques, sélectionnez Activer les mises à jour logicielles automatiques lorsque vous créez ou mettez à jour votre domaine. Pour configurer le même paramètre à l'aide du AWS CLI, définissez --software-update-options sur true lorsque vous créez ou mettez à jour votre domaine.

Mises à jour requises

Les mises à jour du logiciel de service requises incluent généralement des correctifs de sécurité critiques ou d'autres mises à jour obligatoires pour garantir l'intégrité et les fonctionnalités continues de votre domaine. Parmi les mises à jour requises figurent Log4j Common Vulnerabilities and Exposures (CVEs) et l'application de la version 2 du service de métadonnées d'instance (). IMDSv2 Le nombre de mises à jour obligatoires par an est généralement inférieur à trois.

OpenSearch Le service planifie automatiquement ces mises à jour et vous avertit sept jours avant la mise à jour planifiée par e-mail et par une notification sur la console. Vous pouvez choisir d'appliquer la mise à jour immédiatement ou de la replanifier à une date et à une heure plus appropriées dans le délai imparti. Vous pouvez également le planifier lors de la prochaine période creuse du domaine. Si vous ne prenez aucune mesure concernant une mise à jour requise et que vous n'apportez aucune modification de domaine entraînant un blue/green déploiement, le OpenSearch Service peut lancer la mise à jour à tout moment au-delà de la date limite spécifiée (généralement 14 jours à compter de la date de disponibilité), pendant la période creuse du domaine.

Quelle que soit la date prévue de la mise à jour, si vous apportez une modification au domaine qui entraîne un déploiement bleu/vert, le OpenSearch Service met automatiquement à jour votre domaine pour vous.

mises à jour des correctifs

Les versions du logiciel de service qui se terminent par « -P » et un chiffre, tel que R20211203-P4, sont des versions de correctif. Les correctifs sont susceptibles d'inclure des améliorations de performance, des corrections de bogues mineurs et des corrections de sécurité ou des améliorations de posture. Les mises à jour n'incluent pas de nouvelles fonctionnalités ni de modifications majeures, et elles n'ont généralement pas d'impact direct ou perceptible sur les utilisateurs. La notification du logiciel de service vous indique si la publication d'un correctif est facultative ou obligatoire.

Considérations

Si vous envisagez de mettre à jour votre domaine, prenez en compte les éléments suivants :

Démarrage d'une mise à jour logicielle de service

Vous pouvez demander une mise à jour du logiciel de OpenSearch service via la console de service AWS CLI, le ou l'un des 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)

Planification des mises à jour logicielles pendant les périodes creuses

Chaque domaine OpenSearch de service créé après le 16 février 2023 dispose d'une fenêtre quotidienne de 10 heures entre 22 h 00 et 8 h 00, heure locale, que nous considérons comme une fenêtre creuse. OpenSearch Le service utilise cette fenêtre pour planifier les mises à jour du logiciel de service pour le domaine. Les mises à jour hors pointe permettent de minimiser la pression sur les nœuds principaux dédiés d'un cluster pendant les périodes de trafic élevé. OpenSearch Le service ne peut pas lancer de mises à jour en dehors de cette fenêtre de 10 heures sans votre consentement.

Pour chaque domaine, vous pouvez choisir de remplacer l'heure de début par défaut de 22 h 00 par une heure personnalisée. Pour obtenir des instructions, veuillez consulter Configuration d'une fenêtre personnalisée en dehors des heures de pointe.

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

Mises à jour logicielles du service de surveillance

OpenSearch Le service envoie une notification lorsqu'une mise à jour logicielle de service est disponible, requise, démarrée, terminée ou a échoué. Vous pouvez consulter ces notifications dans le panneau Notifications de la console de OpenSearch service. La sévérité de la notification est Informational si la mise à jour est facultative et High si elle est nécessaire.

OpenSearch Le service envoie également des événements liés au logiciel de service à Amazon EventBridge. Vous pouvez l'utiliser EventBridge pour configurer des règles qui envoient un e-mail ou exécutent une action spécifique lorsqu'un événement est reçu. Pour un exemple de procédure, voirTutoriel : Envoi d'alertes Amazon SNS pour les mises à jour logicielles disponibles.

Pour connaître le format de chaque événement lié au logiciel de service envoyé à Amazon EventBridge, consultezÉvénements de mise à jour du logiciel de service.

Lorsque les domaines ne sont pas éligibles à une mise à jour

Votre domaine n'est pas éligible à une mise à jour du logiciel de service si son état correspond à l'un des états suivants :

Annulation d'une mise à jour logicielle de service

Amazon OpenSearch Service prend en charge l'annulation des mises à jour logicielles du service. Vous pouvez lancer une annulation à l'aide de la console de OpenSearch service AWS CLI, du ou de l'un des AWS SDKs. Les mises à jour logicielles sont annulées à l'aide d'un blue/green déploiement.

Éligibilité et considérations relatives à la rétrogradation

Votre domaine doit remplir toutes les conditions suivantes pour qu'une annulation soit disponible :

Fenêtres temporelles d'annulation

La fenêtre de restauration dépend du type de mise à jour logicielle appliquée.

Une fois la fenêtre de restauration expirée, la restauration en libre-service n'est plus disponible. Contactez-nous Supportsi vous rencontrez un problème critique après la fermeture de la fenêtre.

Comment demander une annulation

Vous pouvez demander une annulation à l'aide de l'RollbackServiceSoftwareUpdateAPI.

Demande

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

Corps de la demande :

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

Réponse

L'API renvoie une réponse HTTP 200 dans tous les cas où il n'y a pas d'erreur. Le RollbackAvailable champ dans le corps de la réponse indique si l'annulation a été initiée.

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

Champs de réponse :

Réponses d'erreur

Messages de réponse

Le tableau suivant décrit les messages de réponse possibles renvoyés par l'RollbackServiceSoftwareUpdateAPI.

Exemple de réponse :

{
    "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."
    }
}

Lorsque l'annulation n'est pas disponible, elle RollbackAvailable revient false et le Description champ contient la raison indiquée dans le tableau ci-dessus.