DocumentaçãoCommerceGuia de instalação

[Somente PaaS]{class="badge informative" title="Aplica-se somente a projetos do Adobe Commerce na nuvem (infraestrutura do PaaS gerenciada pela Adobe) e a projetos locais."}

AWS OpenSearch

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Experiente
  • Administrador
  • Desenvolvedor

O Adobe Commerce 2.4.5 é compatível com o uso de clusters do Amazon OpenSearch Service. Este serviço é o sucessor do Amazon Elasticsearch Service. Este tópico descreve como configurar o Commerce para usar o AWS OpenSearch e como migrar dados de uma instância local do Elasticsearch ou OpenSearch para um cluster do AWS OpenSearch.

Criar um domínio do serviço AWS OpenSearch

Primeiro, é necessário estabelecer uma instância OpenSearch no AWS.
Leia Criação e gerenciamento de domínios do Amazon OpenSearch Service para obter instruções detalhadas.

Obter dados para o AWS OpenSearch

Depois que tudo estiver preparado no AWS, é hora de preenchê-lo com dados.

Para instalações menores, recomendamos que você crie índices diretamente na instância do AWS pelos seguintes motivos:

  • Recriar os índices é uma operação rápida.
  • Pode haver incompatibilidades de versão entre a instância antiga e a instância do AWS e elas podem ser evitadas ao criar diretamente na instância do AWS.

Instalações maiores podem considerar a migração de seus índices de dados da instância existente para o AWS. Embora isso possa reduzir o tempo de inatividade, ainda há um pequeno risco de problemas de incompatibilidade devido a versões diferentes entre o servidor Elasticsearch antigo e o AWS.

Não há necessidade de migrar índices, pois eles podem ser facilmente recriados na instância do AWS.
No entanto, ao migrar índices de dados, verifique se as versões do Elasticsearch/OpenSearch são compatíveis.

Consulte as instruções do Migrating to Amazon OpenSearch Service da Amazon para obter mais informações.

Configurar o Commerce para OpenSearch

As etapas para configurar o OpenSearch são abordadas no tópico Instalação avançada.

Para testar se a nova configuração está funcionando, teste o endpoint do OpenSearch diretamente:

  1. Crie um produto no Administrador (Por exemplo: sku="testproduct1").

  2. Reindexe por meio do Administrador.

  3. Consulte o endpoint do OpenSearch (encontrado na interface do usuário do AWS):

    Para obter índices, anexe: /_cat/indices/*?v=true à URL:
    <AWS OS endpoint>/_cat/indices/*?v=true

Para obter produtos do índice, anexe: /magento2docker_product_1/_search?q=* à URL:
<AWS OS endpoint>/magento2docker_product_1/_search?q=testproduct1

Recursos adicionais

Para obter informações adicionais, consulte a documentação do OpenSearch AWS.

recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995