DokumentationHandelAnvändarhandbok om Commerce i molnet

[Endast PaaS]{class="badge informative" title="Gäller endast Adobe Commerce i molnprojekt (Adobe-hanterad PaaS-infrastruktur) och lokala projekt."}

Konfigurera OpenSearch-tjänsten

Last update: Mon Jul 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Administratör
  • Utvecklare

Tjänsten OpenSearch är en öppen källkodsgaffel till Elasticsearch 7.10.2 efter licensändringarna för Elasticsearch. Se OpenSource-projektet i GitHub.

WARNING
Elasticsearch 7.11 och senare stöds inte för Adobe Commerce i molninfrastruktur. Adobe Commerce version 2.3.7-p3, 2.4.3-p2 och 2.4.4 och senare stöder OpenSearch-tjänsten. De lokala installationerna fortsätter att stödja Elasticsearch.

Med OpenSearch kan du hämta data från alla källor, alla format och söka och visualisera dem i realtid.

  • Snabba och avancerade sökningar på produkter i produktkatalogen
  • OpenSearch Analyzers stöder flera språk
  • Stöder stoppord och synonymer
  • Indexeringen påverkar inte kunderna förrän omindexeringsåtgärden har slutförts

Använd följande instruktioner för tjänstkonfiguration i Pro Integration-miljöer och Starter-miljöer, inklusive grenen master.

NOTE
Skicka en Adobe Commerce-supportanmälan om du vill ändra tjänstkonfigurationen i Pro Production- och mellanlagringsmiljöer.
TIP
Adobe rekommenderar att du alltid konfigurerar OpenSearch för ditt Adobe Commerce i molninfrastrukturprojekt, även om du tänker konfigurera ett tredjepartssökverktyg för ditt Adobe Commerce-program. Om det inte går att konfigurera OpenSearch finns ett reservalternativ om tredjepartssökverktyget misslyckas.

Så här aktiverar du OpenSearch:

  1. För integreringsmiljöer lägger du till tjänsten opensearch i filen .magento/services.yaml med rätt version och allokerat diskutrymme i MB. I det här fallet är version 2 lämplig. Den mindre versionen är inte obligatorisk.

    code language-yaml 
    opensearch:
    type: opensearch:2
    disk: 1024

    För Pro-projekt måste du skicka in en Adobe Commerce-supportanmälan för att kunna ändra OpenSearch-versionen i mellanlagrings- och produktionsmiljöer.

  2. Ange eller verifiera egenskapen relationships i filen .magento.app.yaml.

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

  3. Lägg till, implementera och push-ändra kod.

    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>

    Mer information om hur dessa ändringar påverkar dina miljöer finns i Konfigurera tjänster.

  4. När distributionen är klar använder du SSH för att logga in på fjärrmiljön.

    code language-bash 
    magento-cloud ssh

  5. Indexera om indexet för katalogsökning.

    code language-bash 
    bin/magento indexer:reindex catalogsearch_fulltext

  6. Rensa cachen.

    code language-bash 
    bin/magento cache:clean
TIP
Efter den första konfigurationen av tjänsten kan du ändra programversionen för en installerad tjänst genom att uppdatera konfigurationsfilerna för services.yaml och .magento.app.yaml. Mer information om hur du uppgraderar eller nedgraderar en tjänst finns i Ändra tjänstversion.

Kompatibelt med OpenSearch-program

När du installerar eller uppgraderar din Adobe Commerce i ett molninfrastrukturprojekt ska du alltid kontrollera kompatibiliteten mellan OpenSearch-tjänstversionen och OpenSearch PHP -klienten för Adobe Commerce.

  • Första gången du installerar - Bekräfta att OpenSearch-versionen som anges i filen services.yaml är kompatibel med OpenSearch PHP-klienten som konfigurerats för Adobe Commerce.

  • Projektuppgradering-Kontrollera att PHP-klienten för OpenSearch i den nya programversionen är kompatibel med OpenSearch-tjänstversionen som är installerad i molninfrastrukturen.

Tjänstversionen och kompatibilitetsstödet bestäms av versionerna som har testats och distribuerats i molninfrastrukturen, och skiljer sig ibland från versioner som stöds av Adobe Commerce lokala distributioner. En lista över vilka versioner som stöds finns i Systemkrav i installationshandboken.

Så här verifierar du OpenSearch-programkompatibilitet:

  1. Byt till din projektkatalog på din lokala arbetsstation.

  2. Visa information om OpenSearch för den aktiva miljön.

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

  3. Du kan också använda SSH för att logga in på fjärrmiljön.

    code language-bash 
    magento-cloud ssh

  4. Hämta anslutningsinformationen för OpenSearch-tjänsten.

    code language-bash 
    vendor/bin/ece-tools env:config:show services

    I svaret hittar du IP-adressen och porten för OpenSearch-tjänstens slutpunkt:

    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                                                  |

  5. Hämta den installerade OpenSearch-tjänsten version:number från tjänstslutpunkten.

    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/"
}
recommendation-more-help

  • För Pro-projekt måste du skicka en Adobe Commerce Support-biljett om du bara vill installera eller uppdatera tjänster i Staging- och Production-miljöer.

  • Ange vilka tjänständringar som krävs, inkludera dina uppdaterade .magento.app.yaml- och services.yaml-filer och ange PHP-versionen i biljetten. Om du vill göra ändringar i PHP-version, tillägg eller miljöinställningar för självbetjäning läser du PHP-inställningar i Programkonfiguration.

  • För ändringar i en aktiv produktionsmiljö (endast Pro) krävs minst 48 timmars varsel. Detta ger molninfrastruktursteamet tillräckligt med tid för att samla in resurser och genomföra en säker uppgradering. Anmälningsperioden börjar när infrastrukturteamet godkänner begäran och schemalägger uppgraderingen, exklusive helger. Om du t.ex. vill att uppgraderingarna ska vara klara på måndag måste du få en bekräftelse på den schemalagda uppgraderingen senast på onsdagen. Under perioder med hög efterfrågan kan det ta längre tid att behandla din begäran.

style
shade-box

Starta om tjänsten OpenSearch

Om du behöver starta om tjänsten OpenSearch måste du kontakta Adobe Commerce support.

Ytterligare sökkonfiguration

  • Som standard återskapas sökkonfigurationen för molnmiljöer varje gång du distribuerar. Du kan använda distributionsvariabeln SEARCH_CONFIGURATION om du vill behålla anpassade sökinställningar mellan distributioner. Se Distribuera variabler.

  • När du har konfigurerat OpenSearch-tjänsten för ditt projekt använder du Admin-gränssnittet för att testa OpenSearch-anslutningen och anpassa OpenSearch-inställningarna för Adobe Commerce.

Lägg till plugin-program för OpenSearch

Du kan också lägga till plugin-program för OpenSearch genom att lägga till avsnittet configuration:plugins i OpenSearch-tjänsten i filen .magento/services.yaml. Följande kod aktiverar till exempel ICU-analys och plugin-program för fonetisk analys.

NOTE
Detta gäller endast för integrerings- och startmiljöer. Skicka en supportförfrågan om du vill installera plugin-programmen i ett Pro Staging- eller Production-kluster.
opensearch:
    type: opensearch:2
    disk: 1024
    configuration:
        plugins:
            - analysis-icu
            - analysis-phonetic

Mer information om plugin-program finns i OpenSearch-projektet.

Ta bort plugin-program för OpenSearch

Om du tar bort plugin-posterna från avsnittet opensearch: i filen .magento/services.yaml avinstalleras eller inaktiveras inte tjänsten. Om du vill inaktivera tjänsten helt måste du indexera om dina OpenSearch-data efter att du har tagit bort plugin-programmen från .magento/services.yaml-filen. Den här designen förhindrar att data som är beroende av dessa plugin-program går förlorade eller skadas.

Så här tar du bort OpenSearch-plugin-program:

NOTE
Den här ändringen gäller endast för integrerings- och startmiljöer. Du måste skicka en supportanmälan för att ta bort plugin-programmet i ett Pro Staging- eller Production-kluster.

  1. Ta bort OpenSearch-pluginposterna från filen .magento/services.yaml.

  2. Lägg till, implementera och push-överföra kodändringar.

    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. Genomför .magento/services.yaml-ändringarna i din molndatabas.

  4. Indexera om indexet för katalogsökning (alla miljöer: integrerings-, start-, Pro-mellanlagrings- och produktionskluster).

    code language-bash 
    bin/magento indexer:reindex catalogsearch_fulltext

  5. Rensa cachen.

    code language-bash 
    bin/magento cache:clean
7c2b03ac-000c-497d-aba3-2c6dc720a938