DocumentatieCommerceHandleiding Commerce on Cloud Infrastructure

OpenSearch-service instellen

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

Gemaakt voor:

  • Beheerder
  • Ontwikkelaar

De 🔗 dienst 0} OpenSearch {is een open-bron vork van Elasticsearch 7.10.2, na de verlenen van vergunningen veranderingen voor Elasticsearch. Zie het Project OpenSourcein GitHub.

WARNING
Elasticsearch 7.11 en hoger wordt niet ondersteund voor Adobe Commerce op cloudinfrastructuur. Adobe Commerce-versies 2.3.7-p3, 2.4.3-p2 en 2.4.4 en hoger ondersteunen de OpenSearch-service. De installaties ter plaatse blijven Elasticsearch steunen.

Met OpenSearch kunt u gegevens van elke bron, elke indeling en in real-time zoeken en visualiseren.

  • Snel en geavanceerd zoeken naar producten in de productcatalogus
  • OpenSearch Analyzers ondersteunen meerdere talen
  • Ondersteunt stopwoorden en synoniemen
  • Indexering heeft geen invloed op klanten totdat de herindexering is voltooid

Gebruik de volgende instructies voor de dienstopstelling op de milieu's van de Integratie Pro en van de Starter milieu's, met inbegrip van de master tak.

NOTE
leg een kaartje van de Steun van Adobe Commercevoor om de de dienstconfiguratie op ProProductie en het Opvoeren milieu's te veranderen.
TIP
De Adobe raadt u aan altijd OpenSearch voor uw Adobe Commerce op het project van de wolkeninfrastructuur te vestigen zelfs als u van plan bent om een derdezoekhulpmiddel voor uw toepassing van Adobe Commerce te vormen. Het instellen van OpenSearch biedt een fallback-optie als het zoekgereedschap van derden mislukt.

om OpenSearch toe te laten:

  1. Voor de integratieomgevingen Starter en Pro voegt u de service opensearch toe aan het .magento/services.yaml -bestand met de juiste versie en toegewezen schijfruimte in MB. In dit geval is versie 2 geschikt. De secundaire versie is niet vereist omdat de cloudinfrastructuur de nieuwste versie van OpenSearch gebruikt.

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

    Voor Pro projecten, moet u een kaartje van de Steun van Adobe Commercevoorleggen om de versie OpenSearch in de het Opvoeren en milieu's van de Productie te veranderen.

  2. Stel de eigenschap relationships in het .magento.app.yaml -bestand in of controleer deze.

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

  3. Wijzigingen in code toevoegen, vastleggen en doorvoeren.

    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>

    Voor informatie over hoe deze veranderingen uw milieu's beïnvloeden, zie de dienstenvormen.

  4. Nadat het plaatsingsproces voltooit, gebruik SSH aan login aan het verre milieu.

    code language-bash 
    magento-cloud ssh

  5. Indexeer de zoekindex van de catalogus opnieuw.

    code language-bash 
    bin/magento indexer:reindex catalogsearch_fulltext

  6. Maak de cache leeg.

    code language-bash 
    bin/magento cache:clean
TIP
Nadat u de service hebt ingesteld, kunt u de softwareversie van een geïnstalleerde service wijzigen door de configuratiebestanden van services.yaml en .magento.app.yaml bij te werken. Zie de dienstversie van de Veranderingvoor begeleiding bij de bevordering of het degraderen van de dienst.

Compatibiliteit met OpenSearch-software

Wanneer u uw Adobe Commerce op het project van de wolkeninfrastructuur installeert of bevordert, controleert altijd verenigbaarheid tussen de OpenSearch de dienstversie en OpenSearch PHPcliënt voor Adobe Commerce.

  • eerste opstelling - bevestig dat de versie OpenSearch die in het services.yaml dossier wordt gespecificeerd compatibel is met de cliënt OpenSearch PHP die voor Adobe Commerce wordt gevormd.

  • verbetering van het Project - verifieer dat de cliënt OpenSearch PHP in de nieuwe toepassingsversie compatibel is met de OpenSearch de dienstversie die op de wolkeninfrastructuur wordt geïnstalleerd.

De versie van de dienst en verenigbaarheidssteun wordt bepaald door versies die op de infrastructuur van de Wolk worden getest en worden opgesteld, en verschillen soms van versies die door Adobe Commerce op-gebouw plaatsingen worden gesteund. Zie {de vereisten van het 0} Systeem 🔗 in de Gids van de Installatie voor een lijst van gesteunde versies.

om de softwareverenigbaarheid te verifiëren OpenSearch:

  1. Wijzig op uw lokale werkstation de projectmap.

  2. De OpenSearch-details voor de actieve omgeving weergeven.

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

  3. U kunt SSH ook gebruiken om u aan te melden bij de externe omgeving.

    code language-bash 
    magento-cloud ssh

  4. Haal de verbindingsgegevens van de OpenSearch-service op.

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

    In de reactie, vind het IP adres en de haven voor het de diensteindpunt van 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. Haal de geïnstalleerde OpenSearch-service version:number op van het eindpunt van de service.

    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
Voor Pro projecten, moet u een kaartje van de Steun van Adobe Commercevoorleggen om dienstenin Staging en Production slechts milieu's te installeren of bij te werken.
Geef aan welke servicewijzigingen nodig zijn, neem de bijgewerkte .magento.app.yaml - en services.yaml -bestanden op en geef de PHP-versie op in het ticket. Voor zelfbedienings veranderingen in PHP versie, uitbreidingen, of milieu montages, zie PHP montagesin configuratie van de Toepassing.
Voor veranderingen in a levende milieu van de Productie (Pro slechts), moet u een minimum van 48 uurbericht verstrekken om het de infrastructuurteam van de Wolk voldoende tijd toe te staan om middelen te marshal en een veilige verbetering te leiden.

De OpenSearch-service opnieuw starten

Als u de OpenSearch-service opnieuw wilt starten, moet u contact opnemen met de ondersteuning van Adobe Commerce.

Aanvullende zoekconfiguratie

  • Standaard wordt de zoekconfiguratie voor Cloud-omgevingen telkens opnieuw gegenereerd wanneer u deze implementeert. Met de implementatievariabele van SEARCH_CONFIGURATION kunt u aangepaste zoekinstellingen tussen implementaties behouden. Zie variabelen opstellen.

  • Nadat u de OpenSearch-service voor uw project hebt ingesteld, gebruikt u de beheerinterface om de OpenSearch-verbinding te testen en de OpenSearch-instellingen voor Adobe Commerce aan te passen.

Plug-ins toevoegen voor OpenSearch

U kunt desgewenst plug-ins voor OpenSearch toevoegen door de sectie configuration:plugins toe te voegen aan de OpenSearch-service in het .magento/services.yaml -bestand. Met de volgende code worden bijvoorbeeld de insteekmodules voor ICU-analyse en Fonetische analyse ingeschakeld.

opensearch:
    type: opensearch:2
    disk: 1024
    configuration:
        plugins:
            - analysis-icu
            - analysis-phonetic

Zie het Project OpenSearchvoor meer informatie over stoppen.

Insteekmodules voor OpenSearch verwijderen

Het verwijderen van de insteekmoduleingangen uit de opensearch: sectie van het .magento/services.yaml dossier ​ ​schrapt of maakt de dienst niet onbruikbaar. Als u de service volledig wilt uitschakelen, moet u de OpenSearch-gegevens opnieuw indexeren nadat u de plug-ins uit het .magento/services.yaml -bestand hebt verwijderd. Dit ontwerp voorkomt mogelijk gegevensverlies of -beschadiging die afhankelijk is van deze plug-ins.

om stopSearch te verwijderen:

  1. Verwijder de items van de OpenSearch-insteekmodule uit het .magento/services.yaml -bestand.

  2. U kunt wijzigingen in de code toevoegen, doorvoeren en doorvoeren.

    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. Leg de .magento/services.yaml -wijzigingen vast in uw cloudopslagplaats.

  4. Indexeer de zoekindex van de catalogus opnieuw.

    code language-bash 
    bin/magento indexer:reindex catalogsearch_fulltext

  5. Maak de cache leeg.

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