设置Elasticsearch服务

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

主题：

创建对象：

undefined
undefined

Elasticsearch是一种开源产品，它允许您从任何来源获取任何格式的数据，并实时搜索和可视化这些数据。

WARNING

云基础架构上的Adobe Commerce不支持Elasticsearch7.11及更高版本。 Adobe Commerce版本2.3.7-p3、2.4.3-p2、2.4.4及更高版本支持OpenSearch服务。内部部署安装继续支持Elasticsearch。

对于Adobe Commerce版本2.4.4及更高版本，请参阅设置OpenSearch服务。

Elasticsearch对产品目录中的产品执行快速和高级搜索
Elasticsearch分析器支持多种语言
支持停用词和同义词
在重新索引操作完成之前，索引不会影响客户

TIP

Adobe建议，即使您计划为Adobe Commerce on cloud infrastructure应用程序配置第三方搜索工具，也应始终为Adobe Commerce设置Elasticsearch。设置Elasticsearch可在第三方搜索工具失败时提供回退选项。

请按照以下说明在专业集成环境和入门环境（包括master分支）上进行服务设置。

NOTE

提交Adobe Commerce支持票证以更改Pro生产和暂存环境中的服务配置。

启用Elasticsearch：

对于入门项目，请将elasticsearch服务添加到.magento/services.yaml文件，该文件具有Elasticsearch版本，并且分配的磁盘空间以MB为单位。

code language-yaml
`elasticsearch: type: elasticsearch:<version> disk: 1024`

对于Pro项目，您必须提交Adobe Commerce支持工单以在暂存环境和生产环境中更改Elasticsearch版本。

在.magento.app.yaml文件中设置relationships属性。

code language-yaml
`relationships: elasticsearch: "elasticsearch:elasticsearch"`

添加、提交和推送代码更改。

code language-bash
`git add .magento/services.yaml .magento.app.yaml && git commit -m "Enable Elasticsearch" && 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`

TIP

在初始服务设置之后，您可以通过更新services.yaml和.magento.app.yaml配置文件来更改已安装服务的软件版本。有关升级或降级服务的指导，请参阅更改服务版本。

Elasticsearch软件兼容性

在云基础架构项目上安装或升级Adobe Commerce时，请始终检查Elasticsearch服务版本与Adobe Commerce的ElasticsearchPHP客户端之间的兼容性。

首次设置 — 确认services.yaml文件中指定的Elasticsearch版本与为Adobe Commerce配置的ElasticsearchPHP客户端兼容。
项目升级 — 验证新应用程序版本中的ElasticsearchPHP客户端是否与云基础架构上安装的Elasticsearch服务版本兼容。

云基础架构上Adobe Commerce的服务版本和兼容性支持取决于云基础架构上部署的版本，并且有时与Adobe Commerce内部部署支持的版本不同。请参阅服务版本。

检查Elasticsearch软件兼容性：

显示活动Elasticsearch的环境详细信息。

code language-bash
`magento-cloud relationships --property=elasticsearch`

或者，您可以使用SSH登录到远程环境。

code language-bash
`magento-cloud ssh`

检查elasticsearch/elasticsearch的编辑器包版本。

code language-bash
`composer show elasticsearch/elasticsearch`

在响应中，检查versions属性中安装的版本。

code language-none

code language-none
name : elasticsearch/elasticsearch descrip. : PHP Client for Elasticsearch keywords : client, elasticsearch, search versions : * v7.17.1 type : library license : Apache License 2.0 (Apache-2.0) (OSI approved) https://spdx.org/licenses/Apache-2.0.html#licenseText license : GNU Lesser General Public License v2.1 only (LGPL-2.1-only) (OSI approved) https://spdx.org/licenses/LGPL-2.1-only.html#licenseText homepage : source : [git] git@github.com:elastic/elasticsearch-php.git f1b8918f411b837ce5f6325e829a73518fd50367 dist : [zip] https://api.github.com/repos/elastic/elasticsearch-php/zipball/f1b8918f411b837ce5f6325e829a73518fd50367 f1b8918f411b837ce5f6325e829a73518fd50367 path : ~/vendor/elasticsearch/elasticsearch names : elasticsearch/elasticsearch

name     : elasticsearch/elasticsearch
descrip. : PHP Client for Elasticsearch
keywords : client, elasticsearch, search
versions : * v7.17.1
type     : library
license  : Apache License 2.0 (Apache-2.0) (OSI approved) https://spdx.org/licenses/Apache-2.0.html#licenseText
license  : GNU Lesser General Public License v2.1 only (LGPL-2.1-only) (OSI approved) https://spdx.org/licenses/LGPL-2.1-only.html#licenseText
homepage :
source   : [git] git@github.com:elastic/elasticsearch-php.git f1b8918f411b837ce5f6325e829a73518fd50367
dist     : [zip] https://api.github.com/repos/elastic/elasticsearch-php/zipball/f1b8918f411b837ce5f6325e829a73518fd50367 f1b8918f411b837ce5f6325e829a73518fd50367
path     : ~/vendor/elasticsearch/elasticsearch
names    : elasticsearch/elasticsearch

此外，您还可以在环境根目录的composer.lock文件中找到ElasticsearchPHP客户端版本。

从命令行中，检索Elasticsearch服务连接详细信息。

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

在响应中，查找Elasticsearch服务端点的IP地址：

code language-none

code language-none
\| elasticsearch: \| +------------------------------------------+----------------------------------------------------------------------+ \| username \| null \| \| scheme \| http \| \| service \| elasticsearch \| \| fragment \| null \| \| ip \| 169.254.220.11 \| \| hostname \| dzggu33f75wi3sd24lgwtoupxm.elasticsearch.service._.magentosite.cloud \| \| public \| false \| \| cluster \| fo3qdoxtla4j4-master-7rqtwti \| \| host \| elasticsearch.internal \| \| rel \| elasticsearch \| \| query \| \| \| path \| null \| \| password \| null \| \| type \| elasticsearch:6.5 \| \| port \| 9200 \| +------------------------------------------+----------------------------------------------------------------------+

| elasticsearch:                                                                                                  |
+------------------------------------------+----------------------------------------------------------------------+
| username                                 | null                                                                 |
| scheme                                   | http                                                                 |
| service                                  | elasticsearch                                                        |
| fragment                                 | null                                                                 |
| ip                                       | 169.254.220.11                                                       |
| hostname                                 | dzggu33f75wi3sd24lgwtoupxm.elasticsearch.service._.magentosite.cloud |
| public                                   | false                                                                |
| cluster                                  | fo3qdoxtla4j4-master-7rqtwti                                         |
| host                                     | elasticsearch.internal                                               |
| rel                                      | elasticsearch                                                        |
| query                                    |                                                                      |
| path                                     | null                                                                 |
| password                                 | null                                                                 |
| type                                     | elasticsearch:6.5                                                    |
| port                                     | 9200                                                                 |
+------------------------------------------+----------------------------------------------------------------------+

从服务终结点检索已安装的Elasticsearch服务version:number。

code language-bash
`curl -XGET <elasticsearch-service-endpoint-ip-address>:9200/`

code language-json

code language-json
`{ "name" : "-AqGi9D", "cluster_name" : "elasticsearch", "cluster_uuid" : "_yze6-ywSEW1MaAF8ZPWyQ", "version" : { "number" : "6.5.4", "build_flavor" : "default", "build_type" : "deb", "build_hash" : "82a8aa7", "build_date" : "2019-01-23T12:07:18.760675Z", "build_snapshot" : false, "lucene_version" : "7.5.0", "minimum_wire_compatibility_version" : "5.6.0", "minimum_index_compatibility_version" : "5.0.0" }, " tagline" : "You Know, for Search" }`

{
   "name" : "-AqGi9D",
   "cluster_name" : "elasticsearch",
   "cluster_uuid" : "_yze6-ywSEW1MaAF8ZPWyQ",
   "version" : {
     "number" : "6.5.4",
     "build_flavor" : "default",
     "build_type" : "deb",
     "build_hash" : "82a8aa7",
     "build_date" : "2019-01-23T12:07:18.760675Z",
     "build_snapshot" : false,
     "lucene_version" : "7.5.0",
     "minimum_wire_compatibility_version" : "5.6.0",
     "minimum_index_compatibility_version" : "5.0.0"
},
"  tagline" : "You Know, for Search"
}

检查Elasticsearch服务和PHP客户端之间的版本兼容性。

如果版本不兼容，请对环境配置进行以下更新之一：

将ElasticsearchPHP客户端更改为与Elasticsearch服务版本兼容的版本。

code language-bash
`composer require "elasticsearch/elasticsearch:~<version>"`

将services.yaml文件中的Elasticsearch服务版本更改为与ElasticsearchPHP客户端兼容的版本。

TIP

对于Pro项目，您必须提交Adobe Commerce支持票证才能仅在Staging和Production环境中安装或更新服务。

指示所需的服务更改，包括更新的.magento.app.yaml和services.yaml文件，并在票证中声明PHP版本。有关对PHP版本、扩展或环境设置的自助更改，请参阅_应用程序配置_中的PHP设置。

对于对_实时_生产环境的更改（仅限 Pro），您必须提供至少48小时的通知，以便Cloud Infrastructure团队有足够的时间来调配资源并进行安全升级。

重新启动Elasticsearch服务

如果需要重新启动Elasticsearch服务，必须与Adobe Commerce支持部门联系。

其他搜索配置

默认情况下，每次部署时都会重新生成云环境的搜索配置。您可以使用SEARCH_CONFIGURATION部署变量来保留部署之间的自定义搜索设置。请参阅部署变量。
为项目设置Elasticsearch服务后，使用管理员UI测试Elasticsearch连接并自定义Adobe Commerce的Elasticsearch设置。

添加插件以进行Elasticsearch

或者，您可以通过将configuration:plugins部分添加到.magento/services.yaml文件中的Elasticsearch服务来添加用于Elasticsearch的插件。例如，以下代码启用ICU分析和拼音分析插件。

elasticsearch:
    type: elasticsearch:<service-version>
    disk: 1024
    configuration:
        plugins:
            - analysis-icu
            - analysis-phonetic

如果您使用Elastic Suite第三方插件，则必须将ece-tools包更新为版本2002.0.19或更高版本。
设置Elastic Suite时，将配置设置添加到ELASTICSUITE_CONFIGURATION部署变量。此配置跨部署保存设置。

删除Elasticsearch插件

从.magento/services.yaml中的elasticsearch:中删除插件项不会像您预期的那样卸载或禁用它们。必须重新索引Elasticsearch数据。此行为旨在防止依赖这些插件的数据可能丢失或损坏。

要删除Elasticsearch插件：

从.magento/services.yaml文件中删除Elasticsearch插件条目。

添加、提交和推送代码更改。

code language-bash
`git add .magento/services.yaml`

code language-bash
`git commit -m "Remove Elasticsearch 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`

TIP

有关将Elastic Suite插件与Adobe Commerce结合使用或对其疑难解答的详细信息，请参阅Elastic Suite文档。

故障排除

请参阅以下Adobe Commerce支持文章，以获取有关Elasticsearch问题疑难解答的帮助：

已配置Elasticsearch5，但搜索页未加载，并显示“Fielddata已禁用……”错误
使用Elasticsearch6.x时，目录分页不起作用
Adobe Commerce疑难解答程序中的Elasticsearch
Elasticsearch索引状态为yellow或red

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26