Aggiornamenti del software del servizio di assistenza nel servizio di assistenza OpenSearch del servizio

Amazon OpenSearch Service rilascia periodicamente gli aggiornamenti del software di sistema che aggiungono funzionalità o comunque migliorano i 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 del servizio utilizzano implementazioni blu/verde per ridurre al minimo i tempi di inattività.

Gli aggiornamenti del software del servizio differiscono dagli aggiornamenti di OpenSearch versione. Per informazioni su come eseguire l'aggiornamento a una versione più recente di OpenSearch, consultare. Aggiornamento dei domini del servizio Amazon di Amazon OpenSearch

Aggiornamenti facoltativi e aggiornamenti obbligatori

OpenSearch Il servizio contiene due grandi categorie di aggiornamenti software del 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 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 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 72 ore (tre 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 distribuzione blu/verde, 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

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. I rilasci di patch non includono nuove caratteristiche o modifiche importanti 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:

Avvio di un aggiornamento del software del 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 ore non di picco

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, consultare Configurazione di una finestra personalizzata non di punta.

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

Monitoraggio degli aggiornamenti del software del servizio

OpenSearch Il servizio 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 del 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. È possibile utilizzare EventBridge per configurare regole che inviano un'email o eseguono un'operazione specifica quando viene ricevuto un evento. Per un esempio di procedura guidata, consulta Esercitazione: Invio di avvisi Amazon SNS per gli aggiornamenti software disponibili.

Per visualizzare il formato di ogni evento software del servizio inviato ad Amazon EventBridge, consulta la sezioneEventi 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: