Aggiornamenti del software di servizio in Amazon OpenSearch Service

Nota

Per una spiegazione delle modifiche e delle aggiunte apportate in ogni aggiornamento del software di servizio principale (senza patch), consultate le note di rilascio.

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 delle OpenSearch versioni. Per informazioni su come eseguire l'aggiornamento a una versione più recente di OpenSearch, vedi Aggiornamento dei domini Amazon OpenSearch Service.

Aggiornamenti opzionali e obbligatori

OpenSearchIl servizio include due ampie categorie di aggiornamenti del software di servizio:

Aggiornamenti opzionali

Gli aggiornamenti opzionali del software di servizio includono generalmente miglioramenti e supporto per nuove caratteristiche o funzionalità. Gli aggiornamenti opzionali non vengono applicati ai tuoi domini e non esiste una scadenza rigida per installarli. La disponibilità dell'aggiornamento viene comunicata tramite e-mail e una notifica sulla console. Puoi scegliere di applicare l'aggiornamento immediatamente o di 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 tu pianifichi o meno un aggiornamento, se apporti una modifica al dominio che causa una distribuzione blu/verde, OpenSearch Service aggiorna automaticamente il tuo dominio 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, quindi pianifica l'aggiornamento dopo 72 ore (tre 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 utilizzandoAWS CLI, imposta su true quando --software-update-options crei o aggiorni il tuo dominio.

Aggiornamenti richiesti

Gli aggiornamenti del software di servizio richiesti in genere includono correzioni di sicurezza critiche o altri aggiornamenti obbligatori per garantire l'integrità e la funzionalità continue del dominio. Esempi di aggiornamenti necessari sono Log4j Common Vulnerabilities and Exposures (CVE) e l'applicazione dell'Instance Metadata Service Version 2 (IMDSv2). Il numero di aggiornamenti obbligatori in un anno è in genere inferiore a tre.

OpenSearchIl servizio pianifica automaticamente questi aggiornamenti e invia una notifica 72 ore (tre giorni) prima dell'aggiornamento pianificato tramite e-mail e una notifica sulla console. Puoi scegliere di applicare l'aggiornamento immediatamente o di 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 causano una distribuzione blu/verde, il OpenSearch servizio 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, OpenSearch Service aggiorna automaticamente il tuo dominio per te.

Aggiornamenti delle patch

Versioni 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 minori e correzioni di sicurezza o miglioramenti della posizione. I rilasci di patch non includono nuove funzionalità o modifiche sostanziali e generalmente 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:

• L'aggiornamento manuale del dominio consente di sfruttare più rapidamente le nuove funzionalità. Quando scegli Aggiorna, OpenSearch Service inserisce la richiesta in una coda e avvia l'aggiornamento quando è tempo.

• Quando si avvia un aggiornamento del software del OpenSearch servizio, il servizio invia una notifica all'avvio e al completamento dell'aggiornamento.

• Gli aggiornamenti software utilizzano implementazioni blu/verde per ridurre al minimo i tempi di inattività. Gli aggiornamenti possono sovraccaricare temporaneamente i nodi principali dedicati di un cluster, quindi assicurarsi di mantenere una capacità sufficiente per gestire il sovraccarico associato.

• Gli aggiornamenti vengono generalmente completati in pochi minuti, ma possono richiedere anche diverse ore o addirittura giorni se il sistema subisce un carico pesante. Valuta la possibilità di aggiornare il tuo dominio durante la finestra configurata non di punta per evitare lunghi periodi di aggiornamento.

Avvio di un aggiornamento del software di servizio

Puoi richiedere un aggiornamento del software di servizio tramite la Console di OpenSearch assistenzaAWS CLI, l'SDK o uno degli SDK.

Console

Per richiedere un aggiornamento del software di servizio

1. Apri la console Amazon OpenSearch Service all'indirizzo https://console.aws.amazon.com/aos/home.

2. Seleziona il nome di dominio per aprirne la configurazione.

3. Scegli Azioni, Aggiorna e seleziona una delle seguenti opzioni:

   • Applica l'aggiornamento ora: pianifica immediatamente l'azione da eseguire nell'ora corrente, se c'è capacità disponibile. Se la capacità non è disponibile, forniamo altre fasce orarie disponibili tra cui scegliere.

   • Pianificalo in una finestra non di punta: disponibile solo se la finestra non di punta è abilitata per il dominio. Pianifica l'aggiornamento in modo che avvenga durante la finestra non di punta configurata del dominio. Non è garantito che l'aggiornamento avvenga durante la prossima finestra immediata. A seconda della capacità, potrebbe verificarsi nei giorni successivi. Per ulteriori informazioni, consulta Pianificazione degli aggiornamenti software durante le finestre non di punta.

   • Pianifica per data e ora specifiche: pianifica l'aggiornamento in modo che avvenga in una data e ora specifiche. Se l'orario specificato non è disponibile per motivi di capacità, puoi selezionare una fascia oraria diversa.

   Se pianifichi l'aggiornamento per una data successiva (all'interno o all'esterno della finestra non di punta del dominio), puoi riprogrammarlo in qualsiasi momento. Per istruzioni, consulta Riprogrammazione delle azioni.

4. Scegli Confirm (Conferma).

AWS CLI

Invia una start-service-software-updateAWS CLIrichiesta per avviare un aggiornamento del software di servizio. Questo esempio aggiunge immediatamente l'aggiornamento alla coda:

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

Risposta:

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

Suggerimento

Dopo aver richiesto un aggiornamento, hai a disposizione un breve lasso di tempo per annullarlo. La durata di questo PENDING_UPDATE stato può variare notevolmente e dipende dall'utente Regione AWS e dal numero di aggiornamenti simultanei che il OpenSearch Servizio sta eseguendo. Per annullare un aggiornamento, usa la console o il cancel-service-software-update AWS CLI comando.

Se la richiesta fallisce con unBaseException, significa che l'ora specificata non è disponibile per motivi di capacità e devi specificare un orario diverso. OpenSearchIl servizio fornisce suggerimenti alternativi sugli slot disponibili nella risposta.

SDK AWS

Questo script Python di esempio utilizza i metodi describe_domain e start_service_software_update di AWS SDK for Python (Boto3) per verificare se un dominio è idoneo per un aggiornamento software di servizio e, in tal caso, avviare l'aggiornamento. È necessario fornire un valore per domain_name:

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 del OpenSearch servizio creato dopo il 16 febbraio 2023 ha una finestra giornaliera di 10 ore tra le 22:00 e le 8:00 ora locale che consideriamo la finestra non di punta. OpenSearchIl 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 l'affaticamento dei nodi master dedicati di un cluster durante i periodi di traffico più elevati. OpenSearchIl servizio non può avviare aggiornamenti al di fuori di questa finestra di 10 ore senza il tuo consenso.

• Per gli aggiornamenti opzionali, il OpenSearch Servizio informa l'utente della disponibilità dell'aggiornamento e richiede di programmare l'aggiornamento durante una prossima finestra non di punta.

• Per gli aggiornamenti richiesti, il OpenSearch Servizio pianifica automaticamente l'aggiornamento durante una prossima finestra non di punta e avvisa l'utente con tre giorni di anticipo. È possibile riprogrammare l'aggiornamento (all'interno o all'esterno della finestra non di punta), ma solo entro il periodo di tempo richiesto per il completamento dell'aggiornamento.

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.

Console

Per pianificare un aggiornamento durante una prossima finestra non di punta

1. Apri la console Amazon OpenSearch Service all'indirizzo https://console.aws.amazon.com/aos/home.

2. Seleziona il nome di dominio per aprirne la configurazione.

3. Scegli Azioni, Aggiorna.

4. Seleziona Pianifica in una finestra non di punta.

5. Scegli Confirm (Conferma).

Puoi visualizzare l'azione pianificata nella scheda della finestra Off-peak e riprogrammarla in qualsiasi momento. Consultare Visualizzazione delle azioni pianificate.

CLI

Per pianificare un aggiornamento durante una prossima finestra non di puntaAWS CLI, invia una StartServiceSoftwareUpdaterichiesta e specifica OFF_PEAK_WINDOW il --schedule-at parametro:

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

Monitoraggio degli aggiornamenti del software del servizio

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

OpenSearchIl servizio invia anche eventi relativi al software di servizio ad AmazonEventBridge. È possibile utilizzarlo EventBridge per configurare regole che inviano un'e-mail o eseguono un'azione specifica quando viene ricevuto un evento. Per un esempio di procedura guidata, consult Esercitazione: Invio di avvisi Amazon SNS per gli aggiornamenti software disponibili .

Per vedere il formato di ogni evento relativo al software di servizio inviato ad AmazonEventBridge, 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:

Stato	Descrizione
Dominio in elaborazione	Il dominio è nel mezzo di una modifica di configurazione. Controlla l'idoneità dell'aggiornamento al termine dell'operazione.
Cluster in stato rosso	Uno o più indici nel cluster sono in stato rosso. Per la risoluzione dei problemi, consulta Cluster in stato rosso.
Elevata percentuale di errori	Il cluster OpenSearch restituisce un numero elevato di errori 5xx durante il tentativo di elaborazione delle richieste. Questo problema è in genere il risultato di un numero eccessivo di richieste di lettura o scrittura simultanee. Valuta la possibilità di ridurre il traffico verso il cluster o di eseguire il dimensionamento del dominio.
Split brain	Un cervello diviso significa che il tuo OpenSearch cluster ha più di un nodo master e si è diviso in due cluster che non si ricongiungeranno mai da soli. Puoi evitare lo split brain utilizzando il numero consigliato di nodi master dedicati. Per risolvere un problema di split brain, contatta AWS Support.
Problema di integrazione di Amazon Cognito	Il tuo dominio utilizza l'autenticazione per OpenSearch le dashboard e OpenSearch Service non riesce a trovare una o più risorse Amazon Cognito. Questo problema in genere si verifica se manca il bacino d'utenza di Amazon Cognito. Per correggere il problema, ricreate la risorsa mancante e configurate il dominio del OpenSearch servizio per utilizzarla.
Altro problema del servizio	I problemi con il OpenSearch Servizio stesso potrebbero far sì che il tuo dominio venga visualizzato come non idoneo per un aggiornamento. Se nessuna delle condizioni precedenti si applica al dominio e il problema persiste per più di un giorno, contatta AWS Support.