Integração e instalação
Instale o Serviço de catálogo para solicitar e receber dados do produto de uma instância do Commerce usando o API GraphQL do serviço de catálogo. O Serviço de catálogo é fornecido como um metapackage de compositor no repositório repo.magento.com.
Requisitos do sistema
Requisitos de software
- Adobe Commerce 2.4.4+
- PHP 8.1, 8.2, 8.3
- Compositor: 2.x
Plataformas compatíveis
- Adobe Commerce na infraestrutura em nuvem: 2.4.4+
- Adobe Commerce no local: 2.4.4+
Endpoints
Catalog Service O tem dois endpoints disponíveis para integração:
- Sandbox (
https://catalog-service-sandbox.adobe.io/graphql
) — usado para teste e validação antes de entrar em funcionamento - Produção (
https://catalog-service.adobe.io/graphql
) — usado para tráfego direto para comerciantes e sites da Commerce
Todas as instâncias de teste do Commerce usam o ponto de extremidade da sandbox.
Execute todos os testes de carga no endpoint da sandbox. Antes de começar o teste de carga, envie um Tíquete de suporte para que a equipe de Serviços possa antecipar o tráfego adicional do servidor.
Instalação e configuração
Para começar com Catalog Service para o Adobe Commerce, as seguintes etapas são obrigatórias:
- Instalar a extensão Serviço de Catálogo (
magento/catalog-service
) - Configurar o serviço e a exportação de dados
- Acessar o serviço
Instalar a extensão Serviço de Catálogo
Pré-requisito
-
Access repo.magento.com para instalar a extensão. Para geração de chaves e obtenção dos direitos necessários, consulte Obter suas chaves de autenticação. Para instalações em nuvem, consulte Guia da infraestrutura do Commerce na nuvem
-
Acesso à linha de comando do servidor de aplicativos do Adobe Commerce.
Instale a versão mais recente da extensão Serviços de catálogo (magento/catalog-service
) em uma instância do Adobe Commerce que esteja executando o Adobe Commerce versão 2.4.4 ou posterior. O Serviço de catálogo é fornecido como um metapackage de compositor do repo.magento.com repositório.
Use este método para instalar o Catalog Service extensão para uma instância Commerce Cloud.
-
Na estação de trabalho local, altere para o diretório do projeto do Adobe Commerce na infraestrutura em nuvem.
note note NOTE Para obter informações sobre como gerenciar os ambientes de projeto do Commerce localmente, consulte Gerenciamento de ramificações com a CLI no Guia do usuário do Adobe Commerce na infraestrutura em nuvem. -
Confira a ramificação do ambiente para atualizar usando a CLI do Adobe Commerce Cloud.
code language-shell magento-cloud environment:checkout <environment-id>
-
Adicione o módulo Serviço de Catálogo.
code language-bash composer require "magento/catalog-service" "^3.0.1" --no-update
-
Atualizar dependências de pacote.
code language-bash composer update "magento/catalog-service"
-
Confirmar e enviar alterações de código para a
composer.json
ecomposer.lock
arquivos. -
Adicionar, confirmar e enviar as alterações de código para o
composer.json
ecomposer.lock
para o ambiente de nuvem.code language-shell git add -A git commit -m "Add catalog service module" git push origin <branch-name>
Enviar as atualizações inicia o Processo de implantação da nuvem do Commerce para aplicar as alterações. Verifique o status da implantação no implantar log.
Use este método para instalar o Catalog Service extensão para uma instância local.
-
Use o Composer para adicionar o módulo Serviço de catálogo ao seu projeto:
code language-bash composer require "magento/catalog-service" "^3.0.1" --no-update
-
Atualize as dependências e instale a extensão:
code language-bash composer update "magento/catalog-service"
-
Atualizar o Adobe Commerce:
code language-bash bin/magento setup:upgrade
-
Limpe o cache:
code language-bash bin/magento cache:clean
note tip TIP Em alguns casos, especialmente ao implantar na produção, você pode evitar a limpeza do código compilado, pois pode levar algum tempo. Certifique-se de fazer backup do sistema antes de fazer qualquer alteração.
Configurar o serviço e a exportação de dados
Depois de instalar o Catalog Service, conclua as seguintes tarefas para integrar o serviço de Catálogo à sua instância do Adobe Commerce. Essa integração permite a sincronização de dados e a comunicação entre a instância do Commerce, o Serviço de catálogo e outros serviços de suporte.
-
Configurar o Conector dos Commerce Services especificando as chaves de API e selecionando um Espaço de dados SaaS.
A configuração do Commerce Services Connector é um processo único necessário para usar serviços da Adobe Commerce, como o Serviço de catálogo, o Live Search e o Product Recommendations. Se você já tiver configurado o conector para outro serviço, ignore esta etapa.
-
Execute uma sincronização de dados inicial a partir do Painel de gerenciamento de dados.
A sincronização inicial pode levar de alguns minutos a horas, dependendo do tamanho do catálogo. Você pode monitorar o status de sincronização no painel de Gerenciamento de dados. Após a sincronização inicial, o Catálogo exporta dados do produto de forma contínua para manter os serviços atualizados.
Para garantir que a exportação de catálogo esteja sendo executada corretamente:
- Confirme se os trabalhos cron estão em execução.
- Verifique se os indexadores estão sendo executados no Admin ou usando o comando da CLI do Commerce
bin/magento indexer:info
. - Verifique se
Catalog Attributes Feed, Product Feed, Product Overrides Feed
, eProduct Variant Feed
indexadores estão definidos comoUpdate by Schedule
.
Acessar o serviço
A variável Catalog Service A API do GraphQL pode ser acessada no https://catalog-service.adobe.io/graphql
usando comandos POST em HTTPS.
Em suas consultas do GraphQL, você deve especificar vários cabeçalhos HTTP, incluindo a chave de API pública adicionada à configuração do Adobe Commerce Services Connector no Administrador. Para obter detalhes, consulte GraphQL de serviços de vitrine documentação.
Configuração do firewall
Para permitir Catalog Service por meio de um firewall, adicione commerce.adobe.io
para o incluo na lista de permissões ➡.
Serviço de catálogo e API Mesh
A variável Malha de API para o Construtor de aplicativos Adobe Developer O permite aos desenvolvedores integrar APIs privadas ou de terceiros e outras interfaces com produtos Adobe usando o Adobe IO.
Consulte a Catalog Service e API Mesh tópico para obter detalhes sobre instalação e configuração.
Painel de gerenciamento de dados
Para obter mais informações sobre Catalog Service sincronização de dados, consulte o Painel de gerenciamento de dados.