Aggiornamenti del software di servizio in Amazon OpenSearch Service

Amazon OpenSearch Service rilascia regolarmente aggiornamenti del software di servizio che aggiungono funzionalità o migliorano in altro modo i tuoi domini. Il pannello Notifications (Notifiche) nella console è il modo più semplice per verificare se è disponibile un aggiornamento o controllare lo stato di un aggiornamento. Ogni notifica include dettagli sull'aggiornamento del software del servizio. Tutti gli aggiornamenti del software di servizio utilizzano implementazioni blu/verdi per ridurre al minimo i tempi di inattività.

Gli aggiornamenti del software di servizio differiscono dagli aggiornamenti della versione del servizio. OpenSearch Per informazioni sull'aggiornamento a una versione successiva del OpenSearch Servizio, consulta. Aggiornamento dei domini Amazon Service OpenSearch

OpenSearch Il servizio richiede l'applicazione degli aggiornamenti software di servizio richiesti entro 30 giorni dalla loro disponibilità. Questi aggiornamenti sono fondamentali per mantenere la conformità alla sicurezza.

Se non applichi gli aggiornamenti richiesti entro il periodo di 30 giorni, riceverai notifiche di promemoria ogni 15 giorni per 30 giorni. Dopo questo periodo di inadempienza, il tuo dominio verrà isolato con i seguenti effetti:

Durante l'isolamento, continuerai a ricevere notifiche di promemoria ogni 15 giorni per 60 giorni. Se non applichi gli aggiornamenti richiesti entro questo periodo, il dominio del OpenSearch Servizio e tutti i dati associati verranno eliminati definitivamente. Per ulteriori informazioni, consulta Risoluzione degli errori di convalida.

Aggiornamenti facoltativi e aggiornamenti obbligatori

OpenSearch Il servizio prevede due ampie categorie di aggiornamenti software di servizio:

Aggiornamenti opzionali

Gli aggiornamenti opzionali del software di servizio generalmente includono miglioramenti e supporto per nuove caratteristiche o funzionalità. Gli aggiornamenti opzionali non vengono applicati ai tuoi domini e non è prevista una scadenza fissa per installarli. La disponibilità dell'aggiornamento viene comunicata tramite e-mail e una notifica della console. Puoi scegliere di applicare l'aggiornamento immediatamente o riprogrammarlo per una data e un'ora più appropriate. Puoi anche programmarlo durante la finestra non di punta del dominio. La maggior parte degli aggiornamenti software è facoltativa.

Indipendentemente dal fatto che pianifichi o meno un aggiornamento, se apporti una modifica al dominio che causa una distribuzione blu/verde, OpenSearch Service aggiorna automaticamente il software di servizio per te.

Puoi configurare il tuo dominio per applicare automaticamente gli aggiornamenti opzionali durante le ore non di punta. Quando questa opzione è attivata, il OpenSearch Servizio attende almeno 13 giorni dalla data in cui è disponibile un aggiornamento opzionale e quindi pianifica l'aggiornamento dopo sette giorni. Riceverai una notifica sulla console quando l'aggiornamento è pianificato e puoi scegliere di riprogrammarlo per una data successiva.

Per attivare gli aggiornamenti software automatici, seleziona Abilita l'aggiornamento automatico del software quando crei o aggiorni il tuo dominio. Per configurare la stessa impostazione utilizzando AWS CLI, imposta su --software-update-options true quando crei o aggiorni il dominio.

Aggiornamenti richiesti

Gli aggiornamenti software di servizio richiesti generalmente includono correzioni di sicurezza critiche o altri aggiornamenti obbligatori per garantire l'integrità e la funzionalità continue del dominio. Esempi di aggiornamenti richiesti sono le vulnerabilità e le esposizioni comuni di Log4j (CVEs) e l'applicazione della versione 2 di Instance Metadata Service (). IMDSv2 Il numero di aggiornamenti obbligatori in un anno è in genere inferiore a tre.

OpenSearch Il servizio pianifica automaticamente questi aggiornamenti e avvisa l'utente sette giorni prima dell'aggiornamento pianificato tramite e-mail e una notifica della console. Puoi scegliere di applicare l'aggiornamento immediatamente o riprogrammarlo per una data e un'ora più appropriate entro il periodo di tempo consentito. Puoi anche programmarlo durante la prossima finestra non di punta del dominio. Se non intraprendi alcuna azione su un aggiornamento richiesto e non apporti modifiche al dominio che causino una blue/green distribuzione, OpenSearch Service può avviare l'aggiornamento in qualsiasi momento oltre la scadenza specificata (in genere 14 giorni dalla disponibilità), entro la finestra non di punta del dominio.

Indipendentemente da quando è pianificato l'aggiornamento, se apporti una modifica al dominio che causa una distribuzione blu/verde, il OpenSearch Servizio aggiorna automaticamente il dominio per te.

Aggiornamenti delle patch

Le versioni del software di servizio che terminano con «-P» e un numero, come R20211203-P4, sono versioni di patch. È probabile che le patch includano miglioramenti delle prestazioni, correzioni di bug lievi e correzioni di sicurezza o miglioramenti della posizione. I rilasci di patch non includono nuove funzionalità o modifiche sostanziali e in genere non hanno un impatto diretto o evidente sugli utenti. La notifica del software di servizio indica se il rilascio di una patch è facoltativo o obbligatorio.

Considerazioni

Per stabilire se aggiornare il dominio, considerare quando segue:

Avvio di un aggiornamento del software di servizio

È possibile richiedere un aggiornamento del software di OpenSearch servizio tramite la console di servizio AWS CLI, il, o uno dei 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)

Pianificazione degli aggiornamenti software durante le finestre non di punta

Ogni dominio OpenSearch di servizio creato dopo il 16 febbraio 2023 ha una finestra giornaliera di 10 ore tra le 22:00 e le 8:00 ora locale, periodo considerato non di punta. OpenSearch Il servizio utilizza questa finestra per pianificare gli aggiornamenti del software di servizio per il dominio. Gli aggiornamenti non di punta aiutano a ridurre al minimo il carico sui nodi master dedicati di un cluster durante i periodi di traffico più intenso. OpenSearch Il servizio non può avviare aggiornamenti al di fuori di questa finestra di 10 ore senza il tuo consenso.

Per ogni dominio, puoi scegliere di sostituire l'ora di inizio predefinita delle 22:00 con un'ora personalizzata. Per istruzioni, consulta Configurazione di una finestra personalizzata non di punta.

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

Aggiornamenti del software del servizio di monitoraggio

OpenSearch Il servizio invia una notifica quando un aggiornamento del software di servizio è disponibile, richiesto, avviato, completato o non riuscito. È possibile visualizzare queste notifiche nel pannello Notifiche della console di OpenSearch servizio. La gravità della notifica è Informational se l'aggiornamento è facoltativo e High se invece è obbligatorio.

OpenSearch Il servizio invia anche eventi software di servizio ad Amazon EventBridge. Puoi usarlo EventBridge per configurare regole che inviano un'e-mail o eseguono un'azione specifica quando viene ricevuto un evento. Per un esempio, consulta la guidaEsercitazione: Invio di avvisi Amazon SNS per gli aggiornamenti software disponibili.

Per vedere il formato di ogni evento software di servizio inviato ad Amazon EventBridge, consultaEventi di aggiornamento del software di servizio.

Quando i domini non sono idonei per un aggiornamento

Il dominio potrebbe non essere idoneo all'aggiornamento del software del servizio se si trova in uno degli stati riportati di seguito:

Ripristino di un aggiornamento del software di servizio

Amazon OpenSearch Service supporta il rollback degli aggiornamenti software del servizio. Puoi avviare un rollback utilizzando la console di OpenSearch servizio, il AWS CLI, o uno dei. AWS SDKs Gli aggiornamenti software vengono ripristinati utilizzando una blue/green distribuzione.

Idoneità e considerazioni relative al rollback

Affinché un rollback sia disponibile, il dominio deve soddisfare tutte le seguenti condizioni:

Finestre temporali di rollback

La finestra di rollback dipende dal tipo di aggiornamento software applicato.

Dopo la scadenza della finestra di rollback, il rollback self-service non è più disponibile. Contatta Supportose riscontri un problema critico dopo la chiusura della finestra.

Come richiedere un rollback

Puoi richiedere un rollback utilizzando l'RollbackServiceSoftwareUpdateAPI.

Richiesta

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

Corpo della richiesta:

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

Risposta

L'API restituisce una risposta HTTP 200 in tutti i casi non di errore. Il RollbackAvailable campo nel corpo della risposta indica se il rollback è stato avviato.

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

Campi di risposta:

Risposte agli errori

Messaggi di risposta

La tabella seguente descrive i possibili messaggi di risposta restituiti dall'RollbackServiceSoftwareUpdateAPI.

Esempio di risposta:

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

Quando il rollback non è disponibile, viene RollbackAvailable restituito false e il Description campo contiene il motivo della tabella precedente.