DocumentazioneCommerceCommerce su Cloud

Configura servizio OpenSearch

Ultimo aggiornamento: 2 settembre 2026

Creato per:

  • Amministratore
  • Sviluppatore

Il servizio OpenSearch è un fork open-source di Elasticsearch 7.10.2, in seguito alle modifiche delle licenze per Elasticsearch. Visualizza il progetto OpenSource in GitHub. Requisiti di sistema elenca la versione supportata.

WARNING
Elasticsearch 7 e versioni successive non è supportato per Adobe Commerce sull’infrastruttura cloud. Adobe Commerce 2.4.4 e versioni successive supportano il servizio OpenSearch.

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
Per modificare la configurazione del servizio negli ambienti Pro Production e Staging, Invia un ticket di supporto Adobe Commerce. Per informazioni sui requisiti di pianificazione e sulla disponibilità dei clienti, vedere Supporto dei servizi Pro in Configurazione dei servizi.
TIP
Per i progetti Adobe Commerce su infrastruttura cloud che non utilizzano Live Search, Adobe consiglia di configurare OpenSearch per fornire un'opzione di fallback per gli strumenti di ricerca di terze parti. Tuttavia, OpenSearch e Live Search non possono essere entrambi abilitati nella stessa istanza di Commerce.

Per abilitare OpenSearch:

  1. Per gli ambienti di integrazione, aggiungere il servizio opensearch al file .magento/services.yaml con la versione appropriata e spazio su disco allocato in MB. In questo caso, è appropriata la versione 3. La versione secondaria non è richiesta.

    code language-yaml 
    opensearch:
    type: opensearch:3
    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. Questo metodo self-service non è applicabile agli ambienti Pro Staging o Production. Vedere Supporto servizi Pro in Configurazione servizi.

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-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:3                                           |
| 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-json 
    {
   "name" : "opensearch.0",
   "cluster_name" : "opensearch",
   "cluster_uuid" : "_yzaae6-ywSEW1MaAF8ZPWyQ",
   "version" : {
     "distribution" : "opensearch",
     "number" : "3.1.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/"
}

Per informazioni sui requisiti di pianificazione degli aggiornamenti del servizio Pro e sulla disponibilità dei clienti, vedere Supporto dei servizi Pro in Configurazione dei servizi.

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.

NOTE
Questo vale solo per gli ambienti di integrazione e avvio. Per installare i plug-in in un cluster Pro Staging o Production, invia una richiesta di supporto.
opensearch:
    type: opensearch:3
    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:

NOTE
Questa modifica si applica solo agli ambienti Integration e Starter. Per rimuovere il plug-in in un cluster Pro Staging o Production, è necessario inviare un ticket di supporto.

  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 (tutti gli ambienti: cluster di integrazione, avvio, staging Pro e produzione).

    code language-bash 
    bin/magento indexer:reindex catalogsearch_fulltext

  5. Pulire la cache.

    code language-bash 
    bin/magento cache:clean
recommendation-more-help
commerce-on-cloud-help-cloud-guide