Configura servizio OpenSearch
Il servizio OpenSearch è un fork open-source dell'Elasticsearch 7.10.2, ad Elasticsearch in seguito alle modifiche delle licenze. Visualizza il progetto OpenSource in GitHub.
OpenSearch consente di estrarre dati da qualsiasi origine, qualsiasi formato, nonché di eseguire ricerche e visualizzazioni in tempo reale.
- Ricerche rapide e avanzate sui prodotti nel catalogo dei prodotti
- Gli analizzatori OpenSearch supportano più lingue
- Supporta parole non significative e sinonimi
- L’indicizzazione non influisce sui clienti fino al completamento dell’operazione di reindicizzazione
Utilizzare le istruzioni seguenti per la configurazione del servizio negli ambienti di integrazione Pro e negli ambienti Starter, incluso il ramo master
.
Per abilitare OpenSearch:
-
Per gli ambienti di integrazione Starter e Pro, aggiungere il servizio
opensearch
al file.magento/services.yaml
con la versione appropriata e lo spazio su disco allocato in MB. In questo caso, è appropriata la versione 2. La versione secondaria non è necessaria perché l’infrastruttura cloud utilizza la versione più recente di OpenSearch.code language-yaml opensearch: type: opensearch:2 disk: 1024
Per i progetti Pro, è necessario Inviare un ticket di supporto Adobe Commerce per modificare la versione di OpenSearch negli ambienti di staging e produzione.
-
Impostare o verificare la proprietà
relationships
nel file.magento.app.yaml
.code language-yaml relationships: opensearch: "opensearch:opensearch"
-
Aggiungi, conferma e invia modifiche al codice.
code language-bash git add .magento/services.yaml .magento.app.yaml
code language-bash git commit -m "Enable OpenSearch"
code language-bash git push origin <branch-name>
Per informazioni su come queste modifiche influiscono sugli ambienti, vedi Configurare i servizi.
-
Al termine del processo di distribuzione, utilizzare SSH per accedere all'ambiente remoto.
code language-bash magento-cloud ssh
-
Reindicizza l’indice di ricerca del catalogo.
code language-bash bin/magento indexer:reindex catalogsearch_fulltext
-
Pulire la cache.
code language-bash bin/magento cache:clean
services.yaml
e .magento.app.yaml
. Per informazioni sull'aggiornamento o il downgrade di un servizio, vedere Modifica versione del servizio.Compatibilità con il software OpenSearch
Quando installi o aggiorni il progetto Adobe Commerce su infrastruttura cloud, verifica sempre la compatibilità tra la versione del servizio OpenSearch e il client OpenSearch PHP per Adobe Commerce.
-
Prima installazione-Verificare che la versione di OpenSearch specificata nel file
services.yaml
sia compatibile con il client OpenSearch PHP configurato per Adobe Commerce. -
Aggiornamento del progetto-Verificare che il client OpenSearch PHP nella nuova versione dell'applicazione sia compatibile con la versione del servizio OpenSearch installata nell'infrastruttura cloud.
Il supporto per la versione del servizio e la compatibilità è determinato dalle versioni testate e distribuite nell’infrastruttura Cloud e talvolta è diverso dalle versioni supportate dalle distribuzioni locali di Adobe Commerce. Per un elenco delle versioni supportate, vedere Requisiti di sistema nella Guida all'installazione.
Per verificare la compatibilità del software OpenSearch:
-
Sulla workstation locale, passa alla directory del progetto.
-
Mostra i dettagli di OpenSearch per l'ambiente attivo.
code language-bash magento-cloud relationships --property=opensearch
-
In alternativa, è possibile utilizzare SSH per accedere all’ambiente remoto.
code language-bash magento-cloud ssh
-
Recuperare i dettagli della connessione al servizio OpenSearch.
code language-bash vendor/bin/ece-tools env:config:show services
Nella risposta, trovare l'indirizzo IP e la porta per l'endpoint del servizio OpenSearch:
code language-none +------------------------------------------+--------------------------------------------------------+ | opensearch: | +------------------------------------------+--------------------------------------------------------+ | username | null | | scheme | http | | service | opensearch | | fragment | null | | ip | 169.254.220.11 | | hostname | hostf75wi3sd24l.opensearch.service._.magentosite.cloud | | port | 9200 | | cluster | projectID-develop-4ranwui | | host | opensearch.internal | | rel | opensearch | | path | null | | query | | | password | null | | type | opensearch:2 | | public | false | | host_mapped | false |
-
Recuperare il servizio OpenSearch installato
version:number
dall'endpoint del servizio.code language-bash curl -XGET <opensearch-service-endpoint-ip-address>:9200
code language-json { "name" : "opensearch.0", "cluster_name" : "opensearch", "cluster_uuid" : "_yzaae6-ywSEW1MaAF8ZPWyQ", "version" : { "distribution" : "opensearch", "number" : "2.5.0", "build_type" : "deb", "build_hash" : "aaaaaaa", "build_date" : "2023-01-23T12:07:18.760675Z", "build_snapshot" : false, "lucene_version" : "9.4.2", "minimum_wire_compatibility_version" : "7.10.0", "minimum_index_compatibility_version" : "7.0.0" }, "tagline" : "The OpenSearch Project: https://opensearch.org/" }
Staging
e Production
..magento.app.yaml
e services.yaml
aggiornati e indicare la versione PHP nel ticket. Per le modifiche self-service alle impostazioni di versione PHP, estensioni o ambiente, vedere Impostazioni PHP in Configurazione applicazione.Riavviare il servizio OpenSearch
Se devi riavviare il servizio OpenSearch, devi contattare il supporto Adobe Commerce.
Configurazione di ricerca aggiuntiva
-
Per impostazione predefinita, la configurazione di ricerca per gli ambienti Cloud viene rigenerata ogni volta che si distribuisce. È possibile utilizzare la variabile di distribuzione
SEARCH_CONFIGURATION
per mantenere le impostazioni di ricerca personalizzate tra le distribuzioni. Vedi Distribuire le variabili. -
Dopo aver configurato il servizio OpenSearch per il progetto, utilizzare l'interfaccia utente di amministrazione per verificare la connessione OpenSearch e personalizzare le impostazioni di OpenSearch per Adobe Commerce.
Aggiungi plug-in per OpenSearch
È possibile aggiungere plug-in per OpenSearch aggiungendo la sezione configuration:plugins
al servizio OpenSearch nel file .magento/services.yaml
. Ad esempio, il codice seguente abilita i plug-in di analisi ICU e analisi fonetica.
opensearch:
type: opensearch:2
disk: 1024
configuration:
plugins:
- analysis-icu
- analysis-phonetic
Per ulteriori informazioni sui plug-in, vedere Progetto OpenSearch.
Rimuovi i plug-in per OpenSearch
La rimozione delle voci del plug-in dalla sezione opensearch:
del file .magento/services.yaml
non disinstalla o disabilita il servizio not. Per disabilitare completamente il servizio, è necessario reindicizzare i dati OpenSearch dopo aver rimosso i plug-in dal file .magento/services.yaml
. Questa progettazione evita la possibile perdita o danneggiamento di dati che dipendono da questi plug-in.
Per rimuovere i plug-in di OpenSearch:
-
Rimuovere le voci del plug-in OpenSearch dal file
.magento/services.yaml
. -
Aggiungi, esegui il commit e invia le modifiche al codice.
code language-bash git add .magento/services.yaml
code language-bash git commit -m "Remove OpenSearch plugin"
code language-bash git push origin <branch-name>
-
Eseguire il commit delle
.magento/services.yaml
modifiche nell'archivio cloud. -
Reindicizza l’indice di ricerca del catalogo.
code language-bash bin/magento indexer:reindex catalogsearch_fulltext
-
Pulire la cache.
code language-bash bin/magento cache:clean