Aggiornamenti del software di assistenza nel servizio OpenSearch di Amazon - Amazon OpenSearch Service

Aggiornamenti del software di assistenza nel servizio OpenSearch di Amazon

Nota

Consulta le note di rilascio per la descrizione delle modifiche e delle aggiunte apportate in ogni versione principale del software di servizio.

Il servizio OpenSearch di Amazon rilascia periodicamente aggiornamenti del software di sistema che aggiungono funzionalità o migliorano in altra maniera i domini. Il pannello Notifiche nella console è il modo più semplice per controllare se è disponibile un aggiornamento o verificare lo stato di un aggiornamento. Ogni notifica include dettagli sull'aggiornamento del software di servizio. La gravità della notifica è Informational se l'aggiornamento è facoltativo e High se è obbligatorio.

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

Considerazioni sull'aggiornamento del dominio

Per stabilire se aggiornare il dominio, valuta gli elementi seguenti:

  • Se non esegui azioni sugli aggiornamenti disponibili, il servizio OpenSearch aggiorna automaticamente il software di servizio del dominio dopo un determinato periodo di tempo (generalmente due settimane). Il servizio OpenSearch invia notifiche all'avvio e al completamento dell'aggiornamento.

  • Se avvii manualmente un aggiornamento, il servizio OpenSearch non invia una notifica all'avvio dell'aggiornamento, ma solo al completamento.

  • 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.

L'aggiornamento manuale del dominio consente di sfruttare più rapidamente le nuove funzionalità. Quando si sceglie Aggiorna, OpenSearch Service inserisce la richiesta in una coda e inizia l'aggiornamento quando ha tempo. 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 l’opportunità di aggiornare il dominio in un momento di traffico ridotto per evitare tempi lunghi.

Rilascio 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 lievi e correzioni di sicurezza o miglioramenti della posizione. Le versioni di patch non includono nuove funzionalità o modifiche importanti e generalmente non hanno un impatto diretto o evidente sugli utenti.

Richiesta di un aggiornamento del software di servizio (console)

Per chiedere un aggiornamento del software di servizio (console)

  1. Passare all'indirizzo https://aws.amazon.com e scegliere Sign In to the Console (Accedi alla console).

  2. In Analisi, sceglie Servizio OpenSearch di Amazon.

  3. Nel pannello di navigazione, in Domains (Domini), scegli il nome di dominio per aprire le impostazioni.

  4. Scegli Azioni, Aggiorna e conferma l'aggiornamento.

Richiesta di un aggiornamento del software di servizio (AWS CLI)

Invia il comando AWS CLI seguente per chiedere un aggiornamento del software di servizio:

aws opensearch start-service-software-update --domain-name my-domain

Per ulteriori informazioni, consulta start-service-software-update nel riferimento ai comandi AWS CLI e StartServiceSoftwareUpdate nella documentazione di riferimento all'API di configurazione.

Suggerimento

Dopo la richiesta di un aggiornamento, la finestra temporale in cui è possibile annullarlo potrebbe essere limitata. La durata di questo stato PENDING_UPDATE può variare notevolmente e dipende dalla Regione AWS e dal numero di aggiornamenti simultanei che OpenSearch Service sta eseguendo. Per annullarlo, utilizza la console o il comando cancel-service-software-update (CancelServiceSoftwareUpdate).

Richiesta di un aggiornamento del software di servizio (SDK)

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. Occorre 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)

Monitoraggio degli eventi di aggiornamento del software di servizio

OpenSearch Service invia una notifica quando un aggiornamento del software del servizio è disponibile, necessario, avviato, completato o non riuscito. È possibile visualizzare queste notifiche sul pannello Notifications (Notifiche) della console OpenSearch Service. Inoltre invia queste notifiche come eventi ad Amazon EventBridge, dove è possibile configurare regole che inviano un'email o eseguono un'operazione specifica quando viene ricevuto un evento. Per una procedura guidata di esempio, consulta Esercitazione: Invio di avvisi Amazon SNS per gli aggiornamenti software disponibili.

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

Quando i domini non sono idonei per un aggiornamento

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

Stato Descrizione
Dominio in elaborazione

Il dominio sta elaborando 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

Durante il tentativo di elaborazione delle richieste, il cluster OpenSearch restituisce un numero elevato di errori 5xx. Questo problema generalmente è dovuto a un numero eccessivo di richieste di lettura o scrittura simultanee. Valuta l’opportunità di ridurre il traffico verso il cluster o di ridimensionare il dominio.

Split brain

Split brain significa che il cluster OpenSearch contiene più nodi principali ed è stato diviso in due cluster che non verranno mai riuniti in modo autonomo. Puoi evitare lo split brain utilizzando il numero consigliato di nodi principali dedicati. Per facilitare il recupero da uno split brain, contatta AWS Support.

Problema di integrazione di Amazon Cognito

Il dominio utilizza l'autenticazione per OpenSearch Dashboards e OpenSearch Service non è in grado di trovare una o più risorse Amazon Cognito. Questo problema in genere si verifica se manca il bacino d'utenza di Amazon Cognito. Per risolvere il problema, creare nuovamente la risorsa mancante e configurare il dominio OpenSearch Service per il suo utilizzo.

Altro problema del servizio di OpenSearch Service

I problemi con OpenSearch Service possono fare sì che il dominio venga visualizzato come non idoneo per un aggiornamento. Se nessuna delle condizioni precedenti è pertinente al tuo dominio e il problema persiste per oltre un giorno, contatta AWS Support.