Instale o Adobe Commerce B2B extensão
A extensão B2B do Adobe Commerce, magento/extension-b2b
O está disponível para todas as versões compatíveis do Adobe Commerce. Ele é instalado após a instalação do Adobe Commerce.
Requisitos
- Adobe Commerce, todas as versões compatíveis
- PHP 8.1 / 8.2 / 8.3
- Composer
Plataformas compatíveis
- Adobe Commerce na infraestrutura em nuvem (ECE)
- Adobe Commerce no local (EE)
Etapas de instalação
Pré-requisitos
-
Acesso a repo.magento.com para baixar a extensão. Para geração de chaves e obtenção dos direitos necessários, consulte Obter suas chaves de autenticação.
Salve as chaves de autenticação para instalação definindo-as globalmente em seu COMPOSER_HOME diretório. Ou salve-os em um auth.json no diretório raiz do aplicativo Adobe Commerce.
-
Versão compatível da extensão B2B-Determine a versão mais recente da extensão B2B que é compatível com a versão do Adobe Commerce implantada.
-
Verifique as notas de versão para obter as informações mais atuais sobre compatibilidade de versão, atualizações ou alterações que podem afetar os requisitos de instalação ou atualização.
Instalar a extensão B2B (magento/b2b-extension
) usando o Composer. A extensão é um metapackage de compositor que inclui a coleção de módulos que habilitam os recursos B2B para uma instância do Adobe Commerce. Para obter uma lista de módulos incluídos, consulte Pacotes B2B.
note tip |
---|
TIP |
Ao instalar o Adobe Commerce B2B na infraestrutura em nuvem, a Adobe recomenda que você implante seu aplicativo do Adobe Commerce em uma integração ou ambiente de preparo antes de começar. |
A Adobe recomenda trabalhar em uma ramificação de desenvolvimento ao adicionar a extensão B2B ao seu projeto. Se você não tiver uma ramificação, consulte Criar uma ramificação para desenvolvimento. Ao instalar a extensão B2B, a variável Magento_B2b
o nome da extensão é inserido automaticamente no app/etc/config.php
arquivo. Não há necessidade de editar o arquivo diretamente.
Para instalar a extensão B2B:
-
Na estação de trabalho local, altere para o diretório do projeto.
-
Criar ou dar baixa em uma ramificação de desenvolvimento.
-
Adicione a extensão B2B à
require
seção docomposer.json
arquivo.code language-bash composer require magento/extension-b2b --no-update
-
Atualize as dependências do projeto.
code language-bash composer update
-
Adicionar, confirmar e enviar alterações de código.
code language-bash git add -A
code language-bash git commit -m "Install the B2B extension."
code language-bash git push origin <branch-name>
note note NOTE Enviar atualizações para o ambiente de nuvem inicia o processo de implantação da nuvem do Commerce para aplicar as alterações. Verifique o status da implantação no implantar log. Se encontrar erros de implantação, consulte Recuperação de falha de componente. -
Após a conclusão da build e implantação, use o SSH para fazer logon no ambiente remoto e verificar se a extensão B2B está instalada e ativada.
code language-bash bin/magento module:status Magento_B2b
Um nome de extensão usa o formato:
<VendorName>_<ComponentName>
.Exemplo de resposta:
code language-terminal Magento_B2b : Module is enabled
-
No diretório raiz do aplicativo do Adobe Commerce, atualize o
composer.json
para adicionar as dependências da extensão B2B:code language-bash composer require magento/extension-b2b:<version>
Se ocorrer um erro, por exemplo:
code language-terminal [InvalidArgumentException] Could not find a matching version of package magento/extension-b2b.
Verifique a ortografia do pacote, a restrição de versão e se o pacote está disponível e corresponde ao requisito de estabilidade mínima (estável).
-
Se solicitado, insira o chaves de autenticação.
Seu chave pública é seu nome de usuário; seu chave privada é sua senha. Se você armazenou suas chaves públicas e privadas no
auth.json
, você não receberá uma solicitação para autenticar. -
Execute os seguintes comandos depois que o Composer terminar de atualizar os módulos:
code language-bash bin/magento setup:upgrade
code language-bash bin/magento setup:di:compile
code language-bash bin/magento setup:static-content:deploy -f
code language-bash bin/magento cache:clean
note note NOTE No modo de Produção, você pode receber uma mensagem para Please rerun Magento compile command
. Digite os comandos para concluir a instalação. A Adobe Commerce não solicita que você execute o comando compilar no modo de Desenvolvedor.
Após concluir a instalação, configure e inicie os consumidores de mensagens.
Consumidores de mensagens
A extensão B2B do Adobe Commerce usa MySQL para gerenciamento de fila de mensagens. A tabela a seguir lista os consumidores de mensagem que oferecem suporte aos recursos B2B. Depois de instalar a extensão, inicie os consumidores de mensagem para os recursos B2B necessários para sua loja da Commerce.
sharedCatalogUpdatePrice
sharedCatalogUpdateCategoryPermissions
negotiableQuotePriceUpdate
purchaseorder.toorder
purchaseorder.transactional.email
purchaseorder.validation
quoteItemCleaner
inventoryQtyCounter
async.operations.all
Configurar consumidores de mensagem
Evite possíveis problemas de processamento ou atrasos adicionando os seguintes parâmetros quando você iniciar os consumidores de mensagem para recursos B2B.
-
--max-messages <value>
— Especifica o número máximo de mensagens que cada consumidor deve processar antes de terminar (padrão = 10000). Embora o Adobe não o recomende, você pode usar 0 para impedir que o consumidor termine. A prática recomendada para um aplicativo PHP é reiniciar processos de longa execução para evitar possíveis vazamentos de memória. -
--batch-size <value>
— Permite limitar os recursos do sistema consumidos pelos consumidores (CPU, memória). Usar lotes menores reduz o uso de recursos e, portanto, resulta em um processamento mais lento. Se especificadas, as mensagens em uma fila serão consumidas em lotes de<value>
cada. Essa opção é aplicável somente para o consumidor do lote. Se--batch-size
não estiver definido, o consumidor em lote receberá todas as mensagens disponíveis em uma fila.
Para obter informações sobre opções de configuração adicionais, consulte Configuração específica.
Iniciar consumidores de mensagem
Para habilitar operações assíncronas para recursos B2B, você deve iniciar vários consumidores de mensagem.
-
Listar os consumidores de mensagem disponíveis:
code language-bash bin/magento queue:consumers:list
O comando retorna os consumidores de mensagem disponíveis, incluindo todos Consumidores de mensagem B2B.
-
Inicie cada consumidor separadamente:
code language-bash bin/magento queue:consumers:start [--max-messages=<value>] [--batch-size=<value>] <consumer_name>
Por exemplo:
code language-bash bin/magento queue:consumers:start quoteItemCleaner
&
ao comando, retorne a um prompt e continue executando os comandos. Por exemplo: bin/magento queue:consumers:start sharedCatalogUpdatePrice &
.Para obter mais informações, consulte Gerenciar filas de mensagens no Guia de configuração.
Adicionar consumidores de mensagem ao cron
É possível automatizar a programação de execução para a SharedCatalogUpdateCategoryPermissions
e SharedCatalogUpdatePrice
consumidores de mensagem adicionando o agendamento ao arquivo de configuração cron /app/code/Magento/MessageQueue/etc/crontab.xml.
* * * * * ps ax | grep [s]haredCatalogUpdateCategoryPermissions >>/dev/null 2>&1 || nohup php /var/www/html/magento2/bin/magento queue:consumers:start sharedCatalogUpdateCategoryPermissions &
* * * * * ps ax | grep [s]haredCatalogUpdatePrice >>/dev/null 2>&1 || nohup php /var/www/html/magento2/bin/magento queue:consumers:start sharedCatalogUpdatePrice &
Você também pode configurar agendas para consumidores de mensagens no Configurações da loja em Admin.
Habilitar recursos B2B no Administrador
Depois de instalar a extensão B2B do Adobe Commerce e iniciar os consumidores de mensagem, você também deve ativar recursos B2B no Administrador.