Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Rinominazione OpenSearch del servizio Amazon - Riepilogo delle modifiche

L'8 settembre 2021 la nostra suite di ricerca e analisi è stata rinominata OpenSearch servizio Amazon. OpenSearch Supporti del servizio così OpenSearch come Elasticsearch OSS legacy. Nelle sezioni seguenti vengono descritte le diverse parti del servizio modificate con la rinomina del servizio e le operazioni da eseguire per garantire che i domini continuino a funzionare correttamente.

Alcune di queste modifiche si applicano solo quando si aggiornano i domini da Elasticsearch a. OpenSearch In altri casi, ad esempio nella console di gestione fatturazione e costi, l'esperienza cambia immediatamente.

Questo elenco non è completo. Mentre anche altre parti del prodotto sono cambiate, questi aggiornamenti sono i più rilevanti.

Nuova versione dell'API

La nuova versione dell'API di configurazione del OpenSearch servizio (2021-01-01) funziona con Elasticsearch OpenSearch OSS legacy. 21 operazioni API sono state sostituite con nomi più concisi e indipendenti dal motore (ad esempio CreateElasticsearchDomain modificati inCreateDomain), ma OpenSearch Service continua a supportare entrambe le versioni delle API.

Per creare e gestire domini da questo punto in poi, consigliamo di utilizzare le nuove operazioni API. Notare che quando si utilizzano le nuove operazioni API per creare un dominio, è necessario specificare il parametro EngineVersion nel formato Elasticsearch_X.Y o OpenSearch_X.Y, piuttosto che solo il numero di versione. Se non su specifica una versione, il valore predefinito sarà l'ultima versione di. OpenSearch

Aggiornamento AWS CLI alla versione 1.40 o successiva per aws opensearch ... utilizzarlo per creare e gestire i domini. Per il nuovo formato della CLI, consultare Documentazione di riferimento della CLIOpenSearch .

Tipi di istanza rinominati

I tipi di istanza in Amazon OpenSearch Service ora sono nel formato, ad <type>.<size>.search esempio, m6g.large.search anzichém6g.large.elasticsearch. Non è necessario eseguire nessuna operazione. I domini esistenti inizieranno automaticamente con riferimento ai nuovi tipi di istanza all'interno dell'API e nella console di gestione fatturazione e costi.

Se sono disponibili istanze riservate (RIs), il contratto non sarà influenzato dalla modifica. La versione precedente dell'API di configurazione è ancora compatibile con il vecchio formato di denominazione, ma se si desidera utilizzare la nuova versione dell'API, sarà necessario utilizzare il nuovo formato.

Modifiche delle policy di accesso

Nelle sezioni seguenti vengono descritte le azioni da intraprendere per aggiornare le policy di accesso.

Policy IAM

Consigliamo di aggiornare le policy IAM in modo da utilizzare le operazioni API rinominate. Tuttavia, OpenSearch Service continuerà a rispettare le policy esistenti replicando internamente le vecchie autorizzazioni API. Ad esempio, se al momento si dispone dell'autorizzazione per eseguire l'operazione CreateElasticsearchDomain, è ora possibile effettuare sia chiamate a CreateElasticsearchDomain (vecchia operazione API) che a CreateDomain (nuova operazione API). Lo stesso vale per i rifiuti espliciti. Per un elenco delle operazioni API aggiornate, consultare il riferimento all'elemento policy.

Policy SCP

Le policy di controllo dei servizi (SCPs) introducono un ulteriore livello di complessità rispetto allo standard IAM. Per evitare che le policy SCP non vengano rispettate, è necessario aggiungere sia le vecchie operazioni che le nuove per ogni policy SCP. Ad esempio, se un utente dispone attualmente delle autorizzazioni per CreateElasticsearchDomain, è necessario concedere loro anche le autorizzazioni per CreateDomain in modo che possano mantenere la possibilità di creare domini. Lo stesso vale per i rifiuti espliciti.

Ad esempio:

"Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "es:CreateElasticsearchDomain",
        "es:CreateDomain"
         ...
      ],
    },
      "Effect": "Deny",
      "Action:" [
        "es:DeleteElasticsearchDomain",
        "es:DeleteDomain"
         ...

Nuovi tipi di risorsa

OpenSearch Service introduce i seguenti nuovi tipi di risorse:

Kibana rinominato in Dashboards OpenSearch

OpenSearch Dashboards, l' AWS alternativa a Kibana, è uno strumento di visualizzazione open source progettato per funzionare. OpenSearch Dopo aver aggiornato un dominio da Elasticsearch a, l'endpoint cambia in. OpenSearch /_plugin/kibana /_dashboards OpenSearch Il servizio reindirizzerà tutte le richieste al nuovo endpoint, ma se si utilizza l'endpoint Kibana in una qualsiasi delle policy IAM, aggiornare tali policy per includere anche il nuovo endpoint. /_dashboards

Se si utilizzaAutenticazione SAML per OpenSearch Dashboards, prima di aggiornare il dominio a OpenSearch, è necessario modificare tutti Kibana URLs configurati nel provider di identità (IdP) da a. /_plugin/kibana /_dashboards I più comuni URLs sono Assertion consumer service (ACS) URLs e destinatario. URLs

Il kibana_read_only ruolo predefinito per OpenSearch Dashboards è stato rinominato in e il kibana_user ruolo è stato rinominato in. opensearch_dashboards_read_only opensearch_dashboards_user La modifica si applica a tutti i 1 appena creati. OpenSearch domini x con software di servizio R20211203 o versioni successive. Se si aggiorna un dominio esistente al software del servizio R20211203, i nomi dei ruoli rimangono invariati.

Parametri rinominati CloudWatch

Per i domini in esecuzione diversi CloudWatch parametri cambiano. OpenSearch Quando si aggiorna un dominio a OpenSearch, i parametri cambiano automaticamente e gli CloudWatch avvisi si interromperanno. Prima di aggiornare il cluster da una versione di Elasticsearch a una OpenSearch versione, assicurarsi di aggiornare gli CloudWatch allarmi in modo che utilizzino i nuovi parametri.

Sono stati modificati i seguenti parametri:

Per un elenco completo delle metriche inviate dal OpenSearch Servizio ad Amazon CloudWatch, consultaMonitoraggio dei parametri dei OpenSearch cluster con Amazon CloudWatch.

Modifiche della console Gestione fatturazione e costi

I dati della cronologia nella console Gestione fatturazione e costi e in Report di costi e costi continueranno a utilizzare il vecchio nome del servizio, quindi è necessario iniziare a utilizzare i filtri sia per OpenSearch Amazon Service sia per Elasticsearch precedente durante la ricerca di dati. Se sono presenti report salvati esistenti, aggiornare i filtri per assicurarsi che includano anche OpenSearch Service. Inizialmente è possibile che venga ricevuto un avviso quando l'utilizzo diminuisce per Elasticsearch e aumenta OpenSearch, ma scompare in pochi giorni.

Oltre al nome del servizio, i campi seguenti verranno modificati per tutti i report, le fatture e le operazioni API del listino prezzi:

Nuovo formato evento

Il formato degli eventi che il OpenSearch Servizio invia ad Amazon EventBridge e Amazon CloudWatch è cambiato, in particolare il detail-type campo. Il campo di origine (aws.es) rimane lo stesso. Per il formato completo per ogni tipo di evento, consultare Monitoraggio degli eventi del OpenSearch servizio con Amazon EventBridge. Se si dispone di regole di evento esistenti che dipendono dal formato precedente, assicurarsi di aggiornarle in modo che siano conformi al nuovo formato.

Cosa rimane lo stesso?

Le seguenti caratteristiche e funzionalità, tra le altre non elencate, rimarranno invariate:

Guida introduttiva: Aggiornamento dei domini alla OpenSearch versione 1.x

OpenSearch 1. x supporta gli aggiornamenti dalle versioni 6.8 e 7 di Elasticsearch. x. Per istruzioni su come aggiornare il dominio, consultare Aggiornamento di un dominio (console). Se si utilizza la AWS CLI o l'API di configurazione per aggiornare il dominio, è necessario specificare l'TargetVersionasOpenSearch_1.x.

OpenSearch 1. x introduce un'impostazione di dominio aggiuntiva denominata Abilita la modalità di compatibilità. Poiché alcuni client e plug-in di Elasticsearch OSS controllano la versione del cluster prima della connessione, la modalità di compatibilità imposta OpenSearch per segnalare la versione 7.10 in modo che questi client continuino a funzionare.

È possibile attivare la modalità di compatibilità quando si creano OpenSearch domini per la prima volta o quando si esegue l'aggiornamento OpenSearch da una versione di Elasticsearch. Se non è impostato, viene ripristinato il parametro predefinito, false, quando crei un dominio e true quando esegui l'aggiornamento di un dominio.

Per abilitare la modalità di compatibilità utilizzando l'API di configurazione, impostare override_main_response_version su true:

POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/upgradeDomain
{
  "DomainName": "domain-name",
  "TargetVersion": "OpenSearch_1.0",
  "AdvancedOptions": {
    "override_main_response_version": "true"
   }
}

Per abilitare o disabilitare la modalità di compatibilità su OpenSearch domini esistenti, è necessario utilizzare l'operazione API OpenSearch _cluster/settings:

PUT /_cluster/settings
{
  "persistent" : {
    "compatibility.override_main_response_version" : true
  }
}