OpenSearch サービスの設定
この OpenSearch サービスは、Elasticsearchのライセンスの変更に従った、Elasticsearch 7.10.2 のオープンソースのフォークです。 を参照してください。 OpenSource プロジェクト （GitHub 内）。
OpenSearch を使用すると、任意のソース、任意の形式からデータを取得し、リアルタイムで検索および視覚化できます。
- 製品カタログ内の製品に対するクイック検索と詳細検索
- OpenSearch アナライザーは複数の言語をサポートしています
- ストップワードおよび同義語のサポート
- インデックス再作成が完了するまで、インデックス作成は顧客に影響しません
Pro 統合環境およびスターター環境でのサービス設定については、以下の手順に従ってください。 master 分岐。
OpenSearch を有効にするには:
-
スターターおよび Pro 統合環境の場合は、
opensearchへのサービス.magento/services.yaml適切なバージョンと MB 単位の割り当てられたディスク容量を持つファイル。 この場合、バージョン 2 が適切です。 クラウドインフラストラクチャでは最新バージョンの OpenSearch が使用されるので、マイナーバージョンは必要ありません。code language-yaml opensearch: type: opensearch:2 disk: 1024Pro プロジェクトの場合は、次の操作が必要です Adobe Commerce サポートチケットを送信 ステージング環境および実稼動環境で OpenSearch のバージョンを変更する場合。
-
を設定または確認します。
relationshipsのプロパティ.magento.app.yamlファイル。code language-yaml relationships: opensearch: "opensearch:opensearch" -
コードの変更を追加、コミットおよびプッシュします。
code language-bash git add .magento/services.yaml .magento.app.yamlcode language-bash git commit -m "Enable OpenSearch"code language-bash git push origin <branch-name>これらの変更が環境に与える影響については、を参照してください。 サービスの設定.
-
デプロイメントプロセスが完了したら、SSH を使用してリモート環境にログインします。
code language-bash magento-cloud ssh -
カタログ検索インデックスを再インデックス化します。
code language-bash bin/magento indexer:reindex catalogsearch_fulltext -
キャッシュをクリーンアップします。
code language-bash bin/magento cache:clean
services.yaml および .magento.app.yaml 設定ファイル。 参照： サービスバージョンの変更 サービスのアップグレードまたはダウングレードのガイダンス。OpenSearch ソフトウェアの互換性
クラウドインフラストラクチャプロジェクトでAdobe Commerceをインストールまたはアップグレードする際は、常に OpenSearch サービスのバージョンとの互換性を確認してください。 OpenSearch PHP Adobe Commerce用クライアント。
-
初回設定 – で指定した OpenSearch バージョンを確認します。
services.yamlファイルは、Adobe Commerce用に設定された OpenSearch PHP クライアントと互換性があります。 -
プロジェクトのアップグレード – 新しいアプリケーション バージョンの OpenSearch PHP クライアントが、クラウド インフラストラクチャにインストールされている OpenSearch サービス バージョンと互換性があることを確認します。
サービスのバージョンと互換性のサポートは、Cloud Infrastructure でテストおよびデプロイされたバージョンによって決まり、Adobe Commerceのオンプレミスデプロイメントでサポートされているバージョンとは異なる場合があります。 参照： 必要システム構成 が含まれる インストールガイド （サポートされているバージョンのリストの場合）。
OpenSearch ソフトウェアの互換性を確認するには:
-
ローカルワークステーションで、をプロジェクトディレクトリに変更します。
-
アクティブな環境の OpenSearch の詳細を表示します。
code language-bash magento-cloud relationships --property=opensearch -
または、SSH を使用してリモート環境にログインすることもできます。
code language-bash magento-cloud ssh -
OpenSearch サービス接続の詳細を取得します。
code language-bash vendor/bin/ece-tools env:config:show services応答で、OpenSearch サービスエンドポイントの IP アドレスとポートを見つけます。
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 | -
インストールされている OpenSearch サービスの取得
version:numberサービスエンドポイントから。code language-bash curl -XGET <opensearch-service-endpoint-ip-address>:9200code 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/" }
Staging および Production 環境のみ。.magento.app.yaml および services.yaml ファイルを開き、PHP のバージョンをチケットに書き込みます。 PHP のバージョン、拡張機能、または環境設定のセルフサービスの変更については、を参照してください。 PHP 設定 。対象： アプリケーション設定.OpenSearch サービスを再起動します
OpenSearch サービスを再起動する必要がある場合は、Adobe Commerce サポートに連絡してください。
追加の検索設定
-
デフォルトでは、クラウド環境の検索設定は、デプロイするたびに再生成されます。 を使用できます
SEARCH_CONFIGURATION変数をデプロイして、デプロイメント間でカスタム検索設定を保持します。 参照： 変数のデプロイ. -
プロジェクトの OpenSearch サービスを設定した後、管理 UI を使用して OpenSearch 接続をテストし、Adobe Commerceの OpenSearch 設定をカスタマイズします。
OpenSearch 用プラグインの追加
オプションで、を追加して OpenSearch 用のプラグインを追加できます。 configuration:plugins の OpenSearch サービスへのセクション .magento/services.yaml ファイル。 例えば、次のコードは ICU 分析と音声分析プラグインを有効にします。
opensearch:
type: opensearch:2
disk: 1024
configuration:
plugins:
- analysis-icu
- analysis-phonetic
を参照してください。 OpenSearch プロジェクト プラグインの詳細については、を参照してください。
OpenSearch のプラグインを削除
からプラグインエントリを削除しています opensearch: の節 .magento/services.yaml ファイルの処理 ではない サービスをアンインストールまたは無効にします。 このサービスを完全に無効にするには、からプラグインを削除した後で、OpenSearch データのインデックスを再作成する必要があります。 .magento/services.yaml ファイル。 この設計により、これらのプラグインに依存するデータの損失や破損を防ぐことができます。
OpenSearch プラグインを削除するには:
-
から OpenSearch プラグインのエントリを削除
.magento/services.yamlファイル。 -
コードの変更を追加、コミット、プッシュします。
code language-bash git add .magento/services.yamlcode language-bash git commit -m "Remove OpenSearch plugin"code language-bash git push origin <branch-name> -
をコミット
.magento/services.yamlクラウドリポジトリーに対する変更。 -
カタログ検索インデックスを再インデックス化します。
code language-bash bin/magento indexer:reindex catalogsearch_fulltext -
キャッシュをクリーンアップします。
code language-bash bin/magento cache:clean