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 del servizio OpenSearch di Amazon - Riepilogo delle modifiche
L'8 settembre 2021 la nostra suite di Amazon è stata rinominata servizio OpenSearch di Amazon. OpenSearch Service supporta OpenSearch così 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.
Argomenti
- Nuova versione dell'API
- Tipi di istanza rinominati
- Modifiche delle policy di accesso
- Nuovi tipi di risorsa
- Kibana rinominato in OpenSearch Dashboards
- Parametri CloudWatch rinominati
- Modifiche della console Gestione fatturazione e costi
- Nuovo formato evento
- Cosa rimane lo stesso?
- Guida introduttiva: Aggiornamento dei domini a OpenSearch 1.x
Nuova versione dell'API
La nuova versione dell'API di configurazione del servizio OpenSearch (2021-01-01) funziona con OpenSearch e con Elasticsearch OSS legacy. 21 operazioni API sono state sostituite con nomi più concisi e indipendenti dal motore (ad esempio CreateElasticsearchDomain
modificato in CreateDomain
), 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.
Aggiornare la AWS CLI alla versione 1.20.40 o successiva per poter usare aws opensearch
...
per creare e gestire i domini. Per il nuovo formato della CLI, consultare Documentazione di riferimento della CLI di OpenSearch
Tipi di istanza rinominati
I tipi di istanza nel servizio OpenSearch di Amazon sono ora nel formato <type>.<size>.search
, ad esempio m6g.large.search
piuttosto che 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 (IR), 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 (SCP) 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:
Risorsa | Descrizione |
---|---|
|
Rappresenta un dominio del servizio OpenSearch di Amazon. Questa risorsa esiste a livello di servizio e non è specifica del software in esecuzione nel dominio. Si applica a servizi come AWS CloudFormation Per istruzioni su come aggiornare i domini definiti in CloudFormation da Elasticsearch a OpenSearch, vedere Osservazioni nella guida per l'utente di CloudFormation. |
|
Rappresenta il software OpenSearch/Elasticsearch in esecuzione su un dominio. Questa risorsa si applica a servizi come AWS CloudTrailAWS::Elasticsearch::Domain ) rispetto ai domini che eseguono OpenSearch (AWS::OpenSearch::Domain ). |
Nota
In AWS ConfigAWS::Elasticsearch::Domain
per diverse settimane, anche se uno o più domini vengono aggiornati a OpenSearch.
Kibana rinominato in OpenSearch Dashboards
OpenSearch Dashboards, l'alternativa AWS a Kibana, è uno strumento di visualizzazione open source progettato per funzionare con OpenSearch. Dopo l'aggiornamento di un dominio da Elasticsearch a OpenSearch, l'endpoint /_plugin/kibana
cambia in /_dashboards
. Il servizio OpenSearch 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 utilizza SAMLautenticazione per i OpenSearch pannelli di controllo, prima di aggiornare il dominio a OpenSearch, è necessario modificare tutti gli URL Kibana configurati nel provider di identità (IdP) da /_plugin/kibana
a /_dashboards
. Gli URL più comuni sono gli URL del servizio consumer assertion (ACS) e gli URL dei destinatari.
Il ruolo kibana_read_only
predefinito per OpenSearch Dashboards è stato rinominato come opensearch_dashboards_read_only
, e il ruolo kibana_user
è stato rinominato come opensearch_dashboards_user
. La modifica si applica a tutti i domini OpenSearch 1.x appena creato che eseguono il software del servizio R20211203 o versioni successive. Se si aggiorna un dominio esistente al software del servizio R20211203, i nomi dei ruoli rimangono invariati.
Parametri CloudWatch rinominati
Per i domini che eseguono OpenSearch diversi parametri CloudWatch cambiano. Quando si aggiorna un dominio a OpenSearch, i parametri cambiano automaticamente e gli avvisi CloudWatch si interromperanno. Prima di aggiornare il cluster da una versione di Elasticsearch a una versione di OpenSearch, assicurarsi di aggiornare gli allarmi CloudWatch in modo che utilizzino i nuovi parametri.
Sono stati modificati i seguenti parametri:
Nome parametro originale | Nuovo nome |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Per un elenco completo dei parametri inviati da OpenSearch Service ad Amazon CloudWatch, consultare Monitoraggio delle metriche dei OpenSearch cluster con Amazon CloudWatch.
Modifiche della console Gestione fatturazione e costi
I dati della cronologia nella console Gestione fatturazione e costi
Oltre al nome del servizio, i campi seguenti verranno modificati per tutti i report, le fatture e le operazioni API del listino prezzi:
Campo | Vecchio formato | Nuovo formato |
---|---|---|
Tipo di istanza |
|
|
Famiglia di prodotti |
Istanza Elasticsearch Volume Elasticsearch |
Istanza del servizio OpenSearch di Amazon Volume del servizio OpenSearch di Amazon |
Descrizione dei prezzi |
5.098 USD per ora di istanza c5.18xlarge.elasticsearch (o ora parziale) - EU |
5.098 USD per ora di istanza c5.18xlarge.search (o ora parziale) - EU |
Famiglia di istanze |
|
|
Nuovo formato evento
Il formato degli eventi che OpenSearch Service invia ad Amazon EventBridge e Amazon CloudWatch è cambiato, in particolare il campo detail-type
. 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:
-
Principale del servizio (
es.amazonaws.com
) -
Codice fornitore
-
ARN di dominio
-
Endpoint di dominio
Guida introduttiva: Aggiornamento dei domini a OpenSearch 1.x
OpenSearch 1.x supporta gli aggiornamenti dalle versioni 6.8 e 7.x di Elasticsearch. Per istruzioni su come aggiornare il dominio, consultare Avvio di un aggiornamento (console). Se si utilizza la AWS CLI o l'API di configurazione per aggiornare il dominio, è necessario specificare TargetVersion
come OpenSearch_1.x
.
OpenSearch 1.x introduce un'impostazione di dominio aggiuntiva denominata Abilita 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 domini OpenSearch per la prima volta o quando si esegue l'aggiornamento a 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à in domini OpenSearch esistenti, è necessario utilizzare l'operazione API _cluster/settings
PUT /_cluster/settings { "persistent" : { "compatibility.override_main_response_version" : true } }