Instalando OpenSearch com Magento 2 de forma fácil
Desenvolvimento, Magento 2
Publicado em 16 de agosto de 2023
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
- Como configurar o Magento com OpenSearch
- 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.
OpenSearch Version Versões Java Compatíveis Versão Java Embutida 1.0 – 1.2.x 11, 15 15.0.1+9 1.3.x 8, 11, 14 11.0.14.1+1 2.0.0 11, 17 17.0.2+8
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
- PagSeguro (PagBank) para Magento 1 recebe a Nova Geração - 9 de abril de 2024
- Recorrência no WooCommerce Sem Plugins Pagos - 28 de janeiro de 2024
- Chargeback. O que é, e como se livrar deles. - 19 de dezembro de 2023
Deixe seu comentário
[fbcomments url="https://www.magenteiro.com/blog/magento-2/instalar-opensearch-com-magento-2/"]