DocumentazioneCommerceGuida di Commerce su infrastruttura Cloud

Configura servizio OpenSearch

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore
  • Sviluppatore

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.

WARNING
Elasticsearch 7.11 e versioni successive non è supportato per Adobe Commerce sull’infrastruttura cloud. Le versioni di Adobe Commerce 2.3.7-p3, 2.4.3-p2 e 2.4.4 e successive supportano il servizio OpenSearch. Gli impianti locali continuano a sostenere l'Elasticsearch.

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.

NOTE
Invia un ticket di supporto Adobe Commerce per modificare la configurazione del servizio negli ambienti di produzione e staging di Pro.
TIP
L’Adobe consiglia di impostare sempre OpenSearch per il progetto di infrastruttura cloud di Adobe Commerce, anche se si intende configurare uno strumento di ricerca di terze parti per l’applicazione Adobe Commerce. L'impostazione di OpenSearch fornisce un'opzione di fallback se lo strumento di ricerca di terze parti non riesce.

Per abilitare OpenSearch:

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

  2. Impostare o verificare la proprietà relationships nel file .magento.app.yaml.

    code language-yaml 
    relationships:
    opensearch: "opensearch:opensearch"

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

  4. Al termine del processo di distribuzione, utilizzare SSH per accedere all'ambiente remoto.

    code language-bash 
    magento-cloud ssh

  5. Reindicizza l’indice di ricerca del catalogo.

    code language-bash 
    bin/magento indexer:reindex catalogsearch_fulltext

  6. Pulire la cache.

    code language-bash 
    bin/magento cache:clean
TIP
Dopo la configurazione iniziale del servizio, è possibile modificare la versione del software per un servizio installato aggiornando i file di configurazione 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:

  1. Sulla workstation locale, passa alla directory del progetto.

  2. Mostra i dettagli di OpenSearch per l'ambiente attivo.

    code language-bash 
    magento-cloud relationships --property=opensearch

  3. In alternativa, è possibile utilizzare SSH per accedere all’ambiente remoto.

    code language-bash 
    magento-cloud ssh

  4. 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-terminal 
    +------------------------------------------+--------------------------------------------------------+
| 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                                                  |

  5. Recuperare il servizio OpenSearch installato version:number dall'endpoint del servizio.

    code language-bash 
    curl -XGET <opensearch-service-endpoint-ip-address>:9200
    code language-terminal 
    {
   "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/"
}
TIP
Per i progetti Pro, è necessario inviare un ticket di supporto Adobe Commerce per installare o aggiornare servizi solo negli ambienti Staging e Production.
Indicare le modifiche necessarie al servizio, includere i file .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.
Per le modifiche a un ambiente di produzione live (Solo Pro), devi fornire un preavviso minimo di 48 ore per consentire al team di infrastruttura cloud di disporre del tempo sufficiente per eseguire il marshalling delle risorse e eseguire un aggiornamento sicuro.

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:

  1. Rimuovere le voci del plug-in OpenSearch dal file .magento/services.yaml.

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

  3. Eseguire il commit delle .magento/services.yaml modifiche nell'archivio cloud.

  4. Reindicizza l’indice di ricerca del catalogo.

    code language-bash 
    bin/magento indexer:reindex catalogsearch_fulltext

  5. Pulire la cache.

    code language-bash 
    bin/magento cache:clean
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26