Instalar pacotes do Adobe Commerce
Essa integração do Commerce permite a sincronização de ativos entre o Adobe Commerce e o Adobe Experience Manager Assets (AEM Assets). A extensão fornece um conjunto de ferramentas e serviços para gerenciar imagem de produto, vídeo e outros ativos de mídia em ambas as plataformas.
Adicione esta extensão ao ambiente Commerce instalando a extensão PHP aem-assets-integration
. Você também precisa ativar o Adobe I/O Events para Commerce e gerar as credenciais necessárias para a comunicação e os fluxos de trabalho entre o Adobe Commerce e o Adobe Experience Manager Assets.
Requisitos de acesso
Você precisa das seguintes funções e permissões para habilitar a integração do Commerce com o AEM Assets.
-
Administrador do projeto na nuvem do Commerce—Instale as extensões necessárias e configure o servidor de aplicativos do Commerce a partir do Administrador ou da linha de comando.
-
Acesso ao 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 na nuvem, consulte o Guia de Infraestrutura do Commerce na Nuvem
-
-
Administrador do Commerce—Atualize a configuração de armazenamento e gerencie as contas de usuário do Commerce.
Fluxo de trabalho de instalação e configuração
Instale o pacote do Adobe Commerce e prepare o ambiente do Commerce concluindo as seguintes tarefas:
-
Instale a Integração do AEM Assets para a extensão do Commerce (
aem-assets-integration
). -
Configure o Commerce Services Connector para conectar sua instância do Adobe Commerce e com os serviços que permitem a transmissão de dados entre o Adobe Commerce e o AEM Assets.
Instalar a extensão aem-assets-integration
Instale a versão mais recente da extensão de Integração do AEM Assets (aem-assets-integration
) em uma instância do Adobe Commerce com a versão Adobe Commerce 2.4.5+. A extensão é entregue como um metapackage de compositor do repositório.magento.com.
Use este método para instalar a extensão AEM Assets Integration em uma instância do 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 o gerenciamento local de ambientes de projeto do Commerce, consulte Gerenciamento de ramificações com a CLI no Guia do Usuário do Adobe Commerce na Infraestrutura da Nuvem. -
Confira a ramificação de ambiente para atualizar usando a CLI da Adobe Commerce Cloud.
code language-shell magento-cloud environment:checkout <environment-id>
-
Adicione a extensão Integração do AEM Assets para Commerce.
code language-shell composer require "magento/aem-assets-integration" "<version-tbd>" --no-update
-
Atualizar dependências de pacote.
code language-shell composer update "magento/aem-assets-integration"
-
Confirmar e enviar alterações de código para os arquivos
composer.json
ecomposer.lock
. -
Adicione, confirme e envie por push as alterações de código dos arquivos
composer.json
ecomposer.lock
para o ambiente de nuvem.code language-shell git add -A git commit -m "Install AEM Assets Integration extension for Adobe Commerce" git push origin <branch-name>
O envio das atualizações inicia o processo de implantação da nuvem do Commerce para aplicar as alterações. Verifique o status da implantação no log de implantação.
Use este método para instalar a extensão AEM Assets Integration para uma instância local.
-
Use o Composer para adicionar a extensão do AEM Assets Integration for Commerce ao seu projeto:
code language-shell composer require "magento/aem-assets-integration" --no-update
-
Atualize as dependências e instale a extensão:
code language-shell composer update "magento/aem-assets-integration"
-
Atualizar o Adobe Commerce:
code language-shell bin/magento setup:upgrade
-
Limpe o cache:
code language-shell bin/magento cache:clean
note tip |
---|
TIP |
Ao implantar na produção, considere não limpar o código compilado para economizar tempo. Sempre faça backup do sistema antes de fazer alterações. |
Configurar o Commerce Services Connector
Para transmitir dados entre sua instância do Adobe Commerce e os serviços que habilitam a Integração do AEM Assets, configure o Commerce Services Connector no Admin (System > Services > Commerce Services Connector).
Forneça os seguintes valores na configuração
- Chaves de API de produção e sandbox para autenticação
- Nome do espaço de dados (identificador SaaS) para armazenamento seguro em nuvem
- ID da organização IMS onde os ambientes Commerce e AEM Assets são provisionados
Para obter instruções detalhadas, assista ao vídeo de configuração do Commerce Services Connector, ou consulte a documentação do Commerce Services Connector.
Quando você salva a configuração, o sistema gera o projeto SaaS e as IDs do banco de dados para o seu ambiente. Esses valores são necessários para habilitar a sincronização de ativos entre o Adobe Commerce e o AEM Assets.
Configurar o Adobe I/O Events para o Commerce
A Integração do AEM Assets usa o serviço do Adobe I/O Events para enviar dados de eventos personalizados entre a instância do Commerce e o Experience Cloud. Os dados do evento são usados para coordenar workflows para a integração do AEM Assets.
Antes de configurar o Adobe I/O Events, verifique a configuração do trabalho RabbitMQ e cron para seu projeto do Commerce:
-
Certifique-se de que o RabbitMQ esteja ativado e ouvindo eventos.
- Instalação do RabbitMQ para Adobe Commerce no local
- Instalação do RabbitMQ para Adobe Commerce na infraestrutura em nuvem
- Verifique se os trabalhos cron estão habilitados. Os trabalhos do Cron são necessários para comunicação e fluxos de trabalho para a integração do AEM Assets.
Ativar a estrutura de eventos do Commerce
Ative a estrutura de eventos no Administrador do Commerce.
-
No Administrador, vá para Stores > Settings > Configuration > Adobe Services > Adobe I/O Events.
-
Expandir Commerce events.
-
Defina Enabled como
Yes
. -
Insira o nome da empresa de comerciante em Merchant ID e o nome do ambiente nos campos Environment ID. Use somente caracteres alfanuméricos e sublinhados ao definir esses valores.
Configurar VCL Personalizado para solicitações de bloqueio
Se você usar um trecho de VCL personalizado para bloquear solicitações de entrada desconhecidas, talvez precise incluir o cabeçalho HTTP X-Ims-Org-Idheader
para permitir conexões de entrada do serviço AEM Assets Integration for Commerce.
O seguinte código de trecho de VCL personalizado (formato JSON) mostra um exemplo com um cabeçalho de solicitação X-Ims-Org-Id
.
{
"name": "blockbyuseragent",
"dynamic": "0",
"type": "recv",
"priority": "5",
"content": "if ( req.http.X-ims-org ~ \"<YOUR-IMS-ORG>\" ) {error 405 \"Not allowed\";}"
}
Antes de criar um trecho com base neste exemplo, revise os valores para determinar se você precisa fazer alterações:
-
name
: Nome do trecho VCL. Este exemplo usa o nomeblockbyuseragent
. -
dynamic
: Define a versão do trecho. Este exemplo usa0
. Consulte os trechos de VCL do Fastly para obter informações detalhadas sobre o modelo de dados. -
type
: Especifica o tipo de trecho VCL, que determina o local do trecho no código VCL gerado. Este exemplo usarecv
. Consulte a Referência de trecho Fastly VCL para obter a lista de tipos de trecho. -
priority
: Determina quando o trecho VCL é executado. Este exemplo usa a prioridade5
para ser executado imediatamente e verificar se uma solicitação de administrador vem de um endereço IP permitido. -
content
: o trecho de código VCL a ser executado, que verifica o endereço IP do cliente. Se o IP estiver na ACL do Edge, o acesso será bloqueado com um erro405 Not allowed
para todo o site. Todos os outros endereços IP de clientes têm acesso permitido.
Para obter informações detalhadas sobre o uso de trechos de VCL para bloquear solicitações de entrada, consulte VCL personalizado para solicitações de bloqueio no Guia de Infraestrutura do Commerce na Nuvem.
Obter credenciais de autenticação para acesso à API
A integração do AEM Assets para o Commerce exige credenciais de autenticação do OAuth para permitir o acesso da API à instância do Commerce. Essas credenciais são necessárias para autenticar solicitações de API ao gerenciar ativos usando a integração do AEM Assets.
Gere as credenciais adicionando a integração à instância do Commerce e ativando-a.
Adicionar a integração ao ambiente do Commerce
-
No Admin, vá para Sistema > Extensões > Integrações e clique em Adicionar nova integração.
-
Insira informações sobre a integração.
Na seção Geral, especifique apenas o Nome e o Email da integração. Use o email para uma conta do Adobe IMS com acesso à organização em que o Commerce e o Experience Manager Assets são implantados.
-
Confirme sua identidade clicando em Confirmar Identidade.
O sistema verifica sua identidade ao autenticar no Experience Cloud com sua Adobe Id.
-
Configure os recursos da API.
-
No painel esquerdo, clique em API.
-
Selecione o recurso de mídia externa Catalog > Inventory > Products > External Media.
-
-
Clique em Save.
Gerar credenciais do OAuth
Na página Integrações, gere as credenciais de autenticação do OAuth clicando em Ativar para a integração com o Assets. Você precisa dessas credenciais para registrar o projeto do Commerce com o serviço do Mecanismo de regras da Assets e para enviar solicitações de API para gerenciar ativos entre o Adobe Commerce e o AEM Assets.
-
Na página Integrações, gere as credenciais clicando em Activate.
-
Se você planeja usar a API, salve as credenciais da chave do consumidor e do token de acesso para configurar a autenticação no cliente da API.
-
Clique em Done.