DokumentationHandelAnvändarhandbok om Commerce i molninfrastrukturen

Konfigurera OpenSearch-tjänsten

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Administratör
  • Utvecklare

Tjänsten OpenSearch är en öppen källkodsgaffel i 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 anläggningarna 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öerna Starter och Pro 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 krävs inte eftersom molninfrastrukturen använder den senaste versionen av OpenSearch.

    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/"
}
TIP
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.
Om du vill ändra en live-produktionsmiljö (endast för Pro) måste du ange minst 48 timmars varsel för att molninfrastrukturteamet ska få tillräckligt med tid för att dela resurser och genomföra en säker uppgradering.

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.

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:

  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.

    code language-bash 
    bin/magento indexer:reindex catalogsearch_fulltext

  5. Rensa cachen.

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