Instalando OpenSearch com Magento 2 de forma fácil

A partir da versão 2.4.3-p2, lançada em Abril de 2022, o Magento passou a suportar o OpenSearch como motor de busca.

Anteriormente, o ElasticSearch era utilizado como mecanismo de busca padrão.

Neste artigo você vai ver:

• Como instalar o OpenSearch e o que é preciso
  • Ajustes importantes
• Como configurar o Magento com OpenSearch
  • Pelo painel administrativo
  • Por linha de comando
  • Como instalar o Magento já com OpenSearch Configurado
• Que parâmetros usar
• Como testar se o seu OpenSearch está funcionando
• Como instalar o Magento sem OpenSearch ou ElasticSearch
• Outras formas de ter uma loja Magento pronta

Instalando OpenSearch

As últimas versões do Magento, utiliza OpenSearch 2.5. Para versões anteriores a 2.4.6, somente a versão 1.2 é suportada.

Você pode consultar os pré-requisitos do Adobe Commerce para verificar que versão você deve instalar.

Cada versão do OpenSearch por sua vez, é compatível com uma versão diferente do Java.

A distribuição OpenSearch para Linux vem com uma versão Adoptium JDK do Java compatível no diretório jdk. Para encontrar a versão do JDK, execute ./jdk/bin/java -version. Por exemplo, o tarball do OpenSearch 1.0.0 vem com Java 15.0.1+9 (não LTS), OpenSearch 1.3.0 vem com Java 11.0.14.1+1 (LTS) e OpenSearch 2.0.0 vem com Java 17.0.2 +8 (LTS). OpenSearch é testado com todas as versões Java compatíveis.

Para usar uma instalação Java diferente, defina a variável de ambiente OPENSEARCH_JAVA_HOME ou JAVA_HOME para o local de instalação do Java. Por exemplo:

export OPENSEARCH_JAVA_HOME=/caminho/do/opensearch-2.5.0/jdk

Ajustes importantes

Para usar o OpenSearch em produção, certifique-se de que a configuração do Linux vm.max_map_count esteja definida como pelo menos 262144.

Mesmo se você usar a imagem do Docker, defina esse valor na máquina host. Para verificar o valor atual, execute este comando:

cat /proc/sys/vm/max_map_count

Para aumentar o valor, adicione a seguinte linha a /etc/sysctl.conf:

vm.max_map_count=262144

Comandos para instalar o OpenSearch

O OpenSearch está disponível em vários sistemas operacionais, e no seu site oficial você consegue ver a lista dos comandos de instalação para cada plataforma.

Configurações do Magento

No Magento, a configuração do Motor de busca pode ser feita de três formas:

1. No Painel Administrativo

Navegue até Lojas > Configurações. E depois em Catálogo > Catálogo > Busca de Catálogo > Motor de Busca.

No painel também é possível configurar o caminho do servidor, porta, prefixo do índice, timeout, etc.

2. Via linha de comando

Você também pode usar o bin/magento config:set para configurar estes itens. Por exemplo:

bin/magento config:set catalog/search/engine opensearch
bin/magento config:set catalog/search/opensearch_server_hostname localhost
bin/magento config:set catalog/search/opensearch_server_port 9200
bin/magento config:set catalog/search/opensearch_index_prefix magento2
bin/magento config:set catalog/search/opensearch_enable_auth 0
bin/magento config:set catalog/search/opensearch_server_timeout 15

3. Ao instalar o Magento

Durante a instalação do Magento também é possível especificar o motor de busca de suas configurações. Isto é feito com os parâmetros listados abaixo e que são utilizados em conjunto com o bin/magento setup:install.

      --opensearch-host=OPENSEARCH-HOST                                                          OpenSearch server host.
      --opensearch-port=OPENSEARCH-PORT                                                          OpenSearch server port.
      --opensearch-enable-auth=OPENSEARCH-ENABLE-AUTH                                            Set to 1 to enable authentication. (default is 0, disabled)
      --opensearch-username=OPENSEARCH-USERNAME                                                  OpenSearch username. Only applicable if HTTP auth is enabled
      --opensearch-password=OPENSEARCH-PASSWORD                                                  OpenSearch password. Only applicable if HTTP auth is enabled
      --opensearch-index-prefix=OPENSEARCH-INDEX-PREFIX                                          OpenSearch index prefix.
      --opensearch-timeout=OPENSEARCH-TIMEOUT                                                    OpenSearch server timeout.

Digite bin/magento setup:install --help para a lista completa de parâmetros.

Quais parâmetros devo usar na configuração?

Caso tenha instalado o OpenSearch na mesma máquina que o Magento, e usou as configurações padrão, você deve especificar localhost como host, e 9200 como porta.

Para testar sua configuração, digite curl localhost:9200 e você deverá ter um retorno similar ao abaixo:

{
  "name" : "0cc5e9fb75e2",
  "cluster_name" : "docker-cluster",
  "cluster_uuid" : "L7JVE4u8Q3K7xvkrH2qwyw",
  "version" : {
    "distribution" : "opensearch",
    "number" : "1.2.4",
    "build_type" : "tar",
    "build_hash" : "e505b10357c03ae8d26d675172402f2f2144ef0f",
    "build_date" : "2022-01-14T03:37:51.375300Z",
    "build_snapshot" : false,
    "lucene_version" : "8.10.1",
    "minimum_wire_compatibility_version" : "6.8.0",
    "minimum_index_compatibility_version" : "6.0.0-beta1"
  },
  "tagline" : "The OpenSearch Project: https://opensearch.org/"
}

Caso algo esteja errado, o seu comando deverá devolver algum erro e não um JSON.

Posso instalar o Magento sem OpenSearch e sem ElasticSearch?

Sim. É possível utilizar apenas MySQL ou MariaDB como seu motor de busca.

Para isso, leia o artigo Magento 2 sem ElasticSearch. Sim, é possível.

Porque é tão difícil instalar o Magento?

É verdade que o Magento tem vários pré-requisios e nenhuma interface amigável de instalação como WooCommerce por exemplo.

Mas isso não quer dizer que precisa ser difícil instalar e configurar uma loja Magento pronta para o Brasil.

No link acima por exemplo, você encontra um mini curso gratuito de como instalar a Fire Store. Trata-se de uma loja Magento 2, pronta para o Brasil, com meio de pagamento, integração com os correios, traduzida, e com alguns recursos básicos para o nosso país.

Se desejar ir além e aprender a configurar um ambiente de desenvolvimento profissional com Docker e Magento 2, considere o Magento 2: O Curso. Neste curso, eu trago uma seção inteira sobre o assunto.

Espero que tenha gostado.

Links úteis

• Requisitos do Magento
• Instalação OpenSearch

• Sobre
• Últimos Posts

Ricardo Martins

É desenvolvedor web há 16 anos e um dos primeiros certificados pela Magento no Brasil. Instrutor de mais de 11 cursos Magento (os principais no magenteiro.com/cursos) com mais de 14 mil alunos de 105 países, é também criador do módulo PagSeguro Transparente, usado em mais de 12 mil lojas.

Últimos posts por Ricardo Martins (exibir todos)

• Você precisa testar esta plataforma de e-commerce - 9 de fevereiro de 2026
• A hora de montar o seu OnlyFans chegou! Veja 8 ideias pra começar o seu. - 4 de dezembro de 2024
• Vida longa ao Magento 1. Conheça o Maho. - 4 de outubro de 2024