Documentación Commerce Commerce en la nube

Configurar el servicio de Elasticsearch

Última actualización: 2 de septiembre de 2026

Temas:
Configuración

Creado para:

Administrador
Desarrollador

Elasticsearch es un producto de código abierto que le permite tomar datos de cualquier fuente, cualquier formato, y buscarlos y visualizarlos en tiempo real.

WARNING

Elasticsearch 7 y versiones posteriores no son compatibles con Adobe Commerce en infraestructuras en la nube. Adobe Commerce 2.4.4 y versiones posteriores admiten el servicio OpenSearch.

Para la versión 2.4.4 y posterior de Adobe Commerce, consulte Configuración del servicio OpenSearch.

Elasticsearch realiza búsquedas rápidas y avanzadas en los productos del catálogo de productos
Los analizadores de Elasticsearch admiten varios idiomas
Admite palabras de detención y sinónimos
La indexación no afecta a los clientes hasta que se completa la operación de reindexación

TIP

Adobe recomienda configurar siempre Elasticsearch para su proyecto de infraestructura en la nube de Adobe Commerce, incluso si tiene pensado configurar una herramienta de búsqueda de terceros para su aplicación de Adobe Commerce. La configuración de Elasticsearch proporciona una opción de reserva en caso de que falle la herramienta de búsqueda de terceros.

Siga estas instrucciones para la configuración del servicio en entornos de integración profesional y entornos de inicio, incluida la rama master.

NOTE

Para cambiar la configuración del servicio en los entornos de ensayo y producción de Pro, envíe un vale de soporte de Adobe Commerce. Para conocer los requisitos de programación y las instrucciones de disponibilidad del cliente, consulte Soporte de servicios Pro en Configurar servicios.

Para habilitar Elasticsearch:

En Proyectos iniciales, agregue el servicio elasticsearch al archivo .magento/services.yaml con la versión de Elasticsearch y el espacio en disco asignado en MB.

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

En los proyectos Pro, debe enviar un ticket de asistencia de Adobe Commerce para cambiar la versión de Elasticsearch en los entornos de ensayo y producción.

Establezca la propiedad relationships en el archivo .magento.app.yaml.

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

Agregar, confirmar y enviar cambios de código.

code language-bash
`git add .magento/services.yaml .magento.app.yaml && git commit -m "Enable Elasticsearch" && git push origin <branch-name>`

Para obtener información sobre cómo afectan estos cambios a sus entornos, consulte Servicios.

Una vez completado el proceso de implementación, utilice SSH para iniciar sesión en el entorno remoto.

code language-bash
`magento-cloud ssh`

Reindexe el índice de búsqueda del catálogo.

code language-bash
`bin/magento indexer:reindex catalogsearch_fulltext`

Limpie la caché.

code language-bash
`bin/magento cache:clean`

TIP

Después de la instalación inicial del servicio, puede cambiar la versión del software de un servicio instalado actualizando los archivos de configuración services.yaml y .magento.app.yaml. Consulte Cambiar la versión del servicio para obtener instrucciones sobre cómo actualizar o degradar un servicio. Este método de autoservicio no se aplica a los entornos de ensayo o producción Pro; consulte Compatibilidad con servicios Pro en Configurar servicios.

Compatibilidad de software de Elasticsearch

Cuando instale o actualice su proyecto de infraestructura de Adobe Commerce en la nube, compruebe siempre la compatibilidad entre la versión del servicio de Elasticsearch y el cliente de Elasticsearch PHP para Adobe Commerce.

Configuración por primera vez: confirme que la versión de Elasticsearch especificada en el archivo services.yaml es compatible con el cliente PHP de Elasticsearch configurado para Adobe Commerce.
Actualización del proyecto: compruebe que el cliente Elasticsearch PHP de la nueva versión de la aplicación sea compatible con la versión del servicio Elasticsearch instalada en la infraestructura en la nube.

La compatibilidad y la versión del servicio para Adobe Commerce en la infraestructura en la nube están determinadas por las versiones implementadas en la infraestructura en la nube y, a veces, difieren de las versiones admitidas por las implementaciones locales de Adobe Commerce. Consulte Versiones de servicio.

Para comprobar la compatibilidad del software Elasticsearch:

En la estación de trabajo local, cambie al directorio del proyecto.

Mostrar los detalles de Elasticsearch para el entorno activo.

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

Como alternativa, puede utilizar SSH para iniciar sesión en el entorno remoto.

code language-bash
`magento-cloud ssh`

Compruebe la versión del paquete Composer de elasticsearch/elasticsearch.

code language-bash
`composer show elasticsearch/elasticsearch`

En la respuesta, compruebe la versión instalada en la propiedad versions.

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

Además, puede encontrar la versión del cliente Elasticsearch PHP en el archivo composer.lock en el directorio raíz del entorno.

Desde la línea de comandos, recupere los detalles de conexión del servicio Elasticsearch.

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

En la respuesta, busque la dirección IP del extremo del servicio Elasticsearch:

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                                                                 |
+------------------------------------------+----------------------------------------------------------------------+

Recupere el servicio Elasticsearch version:number instalado del extremo del servicio.

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

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"
}

Comprobar la compatibilidad de versiones entre el servicio Elasticsearch y el cliente PHP.

Si las versiones son incompatibles, realice una de las siguientes actualizaciones en la configuración de su entorno:

Cambie el cliente Elasticsearch PHP a una versión compatible con la versión del servicio Elasticsearch.

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

Cambie la versión del servicio Elasticsearch en el archivo services.yaml a una versión compatible con el cliente PHP de Elasticsearch.

Para conocer los requisitos de programación de actualización del servicio Pro y las instrucciones de disponibilidad del cliente, consulte Soporte de servicios Pro en Configurar servicios.

Reinicie el servicio de Elasticsearch

Si necesita reiniciar el servicio Elasticsearch, debe ponerse en contacto con el soporte técnico de Adobe Commerce.

Configuración de búsqueda adicional

De forma predeterminada, la configuración de búsqueda de los entornos de Cloud se regenera cada vez que realiza la implementación. Puede usar la variable de implementación SEARCH_CONFIGURATION para conservar la configuración de búsqueda personalizada entre implementaciones. Consulte Implementar variables.
Después de configurar el servicio de Elasticsearch para el proyecto, utilice la IU de administración para probar la conexión de Elasticsearch y personalizar la configuración de Elasticsearch para Adobe Commerce.

Añadir complementos para Elasticsearch

Opcionalmente, puede agregar complementos para Elasticsearch agregando la sección configuration:plugins al servicio Elasticsearch en el archivo .magento/services.yaml. Por ejemplo, el siguiente código habilita los complementos de análisis de ICU y análisis fonético.

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

Si usa el complemento de terceros Elastic Suite, debe actualizar el paquete ece-tools a la versión 2002.0.19 o posterior.
Al configurar Elastic Suite, agregue los ajustes de configuración a la variable de implementación ELASTICSUITE_CONFIGURATION. Esta configuración guarda la configuración en todas las implementaciones.

Eliminar complementos para Elasticsearch

Al eliminar las entradas del complemento de elasticsearch: en .magento/services.yaml, no se desinstalan ni se deshabilitan, como cabría esperar. Debe reindexar los datos de Elasticsearch. Este comportamiento es intencional para evitar la posible pérdida o corrupción de datos que dependen de estos complementos.

Para quitar complementos de Elasticsearch:

Quite las entradas del complemento Elasticsearch de su archivo .magento/services.yaml.

Agregue, confirme e inserte los cambios de código.

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>`

Confirme los cambios de .magento/services.yaml en su repositorio de Cloud.

Reindexe el índice de búsqueda del catálogo.

code language-bash
`bin/magento indexer:reindex catalogsearch_fulltext`

Limpie la caché.

code language-bash
`bin/magento cache:clean`

TIP

Para obtener más información sobre cómo usar o solucionar problemas del complemento Elastic Suite con Adobe Commerce, consulte la documentación de Elastic Suite.

recommendation-more-help

commerce-on-cloud-help-cloud-guide