The OpenSearch service is an open-source fork of Elasticsearch 7.10.2, following the licensing changes for Elasticsearch. See System requirements for a list of supported versions.
Elasticsearch 7.11 and later is not supported for Adobe Commerce on cloud infrastructure. Adobe Commerce and Magento Open Source versions 2.4.4, 2.4.3-p2, and 2.3.7-p3 support the OpenSearch service. The on-premises installations continue to support Elasticsearch.
OpenSearch enables you to take data from any source, any format, and search and visualize it in real time.
Use the following instructions for service setup on Pro Integration environments and Starter environments, including the master
branch.
Submit an Adobe Commerce Support ticket to change the service configuration on Pro Production and Staging environments.
Adobe recommends that you always set up OpenSearch for your Adobe Commerce on cloud infrastructure project even if you plan to configure a third-party search tool for your Adobe Commerce application. Setting up OpenSearch provides a fallback option if the third-party search tool fails.
To enable OpenSearch:
For Starter projects, add the opensearch
service to the .magento/services.yaml
file with the appropriate version and allocated disk space in MB.
opensearch:
type: opensearch:<version>
disk: 1024
For Pro projects, you must Submit an Adobe Commerce Support ticket to change the OpenSearch version in the Staging and Production environments.
Set the relationships
property in the .magento.app.yaml
file.
relationships:
opensearch: "opensearch:opensearch"
Add, commit, and push code changes.
git add .magento/services.yaml .magento.app.yaml && git commit -m "Enable OpenSearch" && git push origin <branch-name>
For information on how these changes affect your environments, see Services.
Verify the service relationships and configure OpenSearch in the Admin UI.
Reindex the Catalog Search index.
bin/magento indexer:reindex catalogsearch_fulltext
Clean the cache.
bin/magento cache:clean
After initial service setup, you can change the software version for an installed service by updating the services.yaml
and .magento.app.yaml
configuration files. See Change service version.