Documentação

Erros de implantação ao ativar o módulo Early-Alpha Baler

Última atualização: 17 de junho de 2025

O comerciante enfrenta erros de implantação ao usar o módulo Baler em um ambiente de produção, pois o recurso está atualmente no estágio inicial de desenvolvimento alfa.

Aviso: o pacote JavaScript Early-alpha Baler não está pronto para uso de produção e é usado por sua conta e risco.

Descrição

Ambiente

  • Adobe Commerce na infraestrutura em nuvem 2.3.x e 2.4.x.
  • Adobe Commerce no local 2.3.x e 2.4.x.

Problema/sintomas

Não recomendamos que os comerciantes usem o módulo Baler em um ambiente de produção, pois ele está atualmente no estágio inicial de desenvolvimento alfa. Usá-lo pode resultar em erros de implantação.

Etapas a serem reproduzidas:

  1. O comerciante tenta inserir a variável SCD_USE_BALER no estágio de compilação do arquivo .magento.env.yaml, o que habilita o pacote agrupado do Baler Javascript.
  2. O comerciante também adiciona a dependência do compositor Baler: "magento/module-baler": "1.0.0-alpha" para exigir a seção de composer.json.

Resultado esperado:

Implantação bem-sucedida.

Resultado real:

O comerciante vê a seguinte mensagem de erro nos logs de implantação na nuvem, que é <project home>/var/log/cloud.log, no estágio de implantação de conteúdo estático:

[ 2020-08-19 12:06:12]  WARNING: [ 1007]  Baler JS bundling cannot be used because of the following issues:
[ 2020-08-19 12:06:12]  WARNING:  - Path to baler executable could not be found. The Node package may not be installed or may not be linked.

Causa

O módulo Baler está atualmente no estágio inicial de desenvolvimento alfa e o processo de instalação da extensão Baler é complexo.

Resolução

Você pode revisar a documentação existente do Baler Alpha em Github/Magento/Baler/Introdução ao alpha. No entanto, ele não está pronto para uso de produção e é usado por sua conta e risco. Em vez disso, é recomendável mesclar ou agrupar arquivos Javascript (JS) usando o agrupamento incorporado do Adobe Commerce (agrupamento básico) para otimização de arquivos.

  • Você pode ativar a mesclagem ou o agrupamento no Administrador (a mesclagem e o agrupamento não podem ser habilitados ao mesmo tempo): Lojas > Configurações > Configuração > Avançado > Desenvolvedor > Configurações do JavaScript.
  • Você também pode habilitar o agrupamento interno do Adobe Commerce (agrupamento básico) na linha de comando: php -f bin/magento config:set dev/js/enable_js_bundling 1

Para saber mais, consulte Otimização de arquivos CSS e Javascript no Adobe Commerce na infraestrutura de nuvem e no Adobe Commerce no local.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f