Notas de versão do ECE-Tools

OpenSearch—Adicionou suporte ao OpenSearch para as versões 2.4.4, 2.4.3-p2 e 2.3.7-p3 do Adobe Commerce.

PHP—Suporte adicionado para o PHP 8.1.

symfony/process—Adicionou a compatibilidade com o symfony/process ^5.3.

Vários processos do consumidor—Adicionou uma opção multiple_processes para que você possa especificar o número de processos a serem gerados para cada consumidor. Consulte a descrição da variável CRON_CONSUMERS_RUNNER em Implantar variáveis.

Esquema OpenSearch e caminho completo do host—Adicionou a capacidade de configurar um esquema Elasticsearch e um caminho completo do host.

AWS S3—Alterou o método de habilitação do AWS S3.

Corrigir leitor de opções_do_driver—Adição da leitura da configuração de opções_do_driver da conexão do banco de dados do arquivo env.php por ece-tools para validadores.

Adicionado suporte para o Composer 2.0.

Requisitos do compositor atualizados parasymphony/console—Atualizou os requisitos de versão ECE-Tools composer.json para o pacote symphony/console para corrigir um problema que causava a falha dos comandos di:compile com o seguinte erro: Incompatible argument type: Required type: int. Actual type: string

atualizou as verificações de software do fim da vida útil (eol.yaml) para incluir o Elasticsearch 7.9.x.

Credenciais de autenticação Redis—Adicionou a capacidade de ler credenciais de autorização Redis da propriedade relationships durante a fase de implantação.

credenciais de autorização do Elasticsearch—Adicionou a capacidade de ler credenciais de autorização do Elasticsearch da propriedade relationships durante a fase de implantação.

Serviço de armazenamento de sessão dedicado—Adicionou redis-session como segunda opção para armazenamento de sessão. Você pode usar o serviço redis-session para armazenar informações de sessão e usar o serviço redis para cache a fim de fornecer melhor desempenho.

Mensagens SPLIT_DB obsoletas—Adicionou aviso de validador e mensagens críticas para a opção SPLIT_DB obsoleta para o Adobe Commerce 2.4.2 e sua remoção no Adobe Commerce 2.5.0.

versão do Elasticsearch de relações—Validador do Fixed Service para recuperar a versão correta do Elasticsearch das propriedades relationships no Cloud Docker e em ambientes de integração.

Validação flexível da porta Redis—O Redis agora pode validar a porta em uma conexão de cache personalizada a partir da URL server. Por exemplo, você pode adicionar o número da porta ao URL do servidor da seguinte maneira: server: 'tcp://rfs-store-simple-page-cache:26379'. Isso ajuda a evitar erros de validação em que a opção port está ausente ou incorreta.

Atualização para o Adobe Commerce 2.4.2—Correção de um problema que fazia com que os usuários executassem manualmente o bin/magento setup:upgrade para tornar seus sites operacionais após a atualização para o Adobe Commerce 2.4.2.

Armazenamento remoto—Adicionou a variável de ambiente REMOTE_STORAGE para habilitar Projetos na Nuvem para armazenamento remoto de arquivos de mídia usando um serviço de armazenamento, como o AWS S3. Esta opção de configuração faz parte do pacote ECE-Tools, mas não tem suporte no Adobe Commerce na infraestrutura de nuvem.

Novo comando cloud:config:validate—Comando adicionado php vendor/bin/ece-tools cloud:config:validate para validar a configuração .magento.env.yaml antes de enviar alterações para o ambiente de Nuvem remoto.

Liberando o opcache—Adicionou suporte para a opção PHP opcache.enable_cli para liberar o OPcache antes de executar o gancho de implantação. Essa configuração redefine a configuração do cache para garantir que as definições de configuração atuais sejam aplicadas em cada implantação.

Validação do BD Aurora—Atualizou a validação do serviço de banco de dados para que seja compatível com o banco de dados Aurora.

Nova variável de ambiente SCD_NO_PARENT — Adicionada a variável de ambiente SCD_NO_PARENT (para Adobe Commerce >=2.4.2) para gerenciar a geração de conteúdo estático para temas pai.

Limites e comandos de memória—Correção de um problema em que os comandos php vendor/bin/ece-tools não funcionariam se o tamanho do arquivo cloud.log excedesse o limite de memória do PHP. Em vez de ler todo o arquivo cloud.log na memória, agora lemos apenas um subconjunto menor de dados do arquivo de log.

Conexões de banco de dados personalizadas—Corrigido um problema de configuração .magento.env.yaml no qual as conexões de banco de dados personalizadas definidas para DATABASE_CONFIGURATION não eram usadas. As configurações de conexão não foram adicionadas a app/etc/env.php.

Logs de erros vazios—Correção de um problema que causava a falha das implantações se cloud.error.log estivesse vazio.

validação de MariaDB 10.3—Validação de MariaDB 10.3 corrigida para Adobe Commerce 2.3.6-p1.

Cache:flush registrando em log—Entradas de log aprimoradas para indicar o início e término da etapa cache:flush.

Adicionado suporte a ECE-Tools para o diretório pub/static somente leitura quando o conteúdo estático está definido para implantação no estágio de compilação.

Adição de suporte para Elasticsearch 7.9 e Redis 6 para compatibilidade com versões futuras do Adobe Commerce.

Atualizado o ECE-Tools composer.json para adicionar uma dependência necessária para a Ferramenta de correções de qualidade. Isso corrige uma dependência circular que existia entre os pacotes ECE-Tools e magento-cloud-patches.

Validação de mecanismo de pesquisa adicionada para garantir que elasticsearch esteja definido para o Adobe Commerce na infraestrutura de nuvem 2.4 e posterior. Se a validação falhar, a implantação será interrompida com uma mensagem de erro crítica que sugere correções para o problema. Consulte Erros Críticos, Estágio de Implantação.

Adição da validação do Elasticsearch para verificar a compatibilidade entre a versão do serviço Elasticsearch e a versão do Adobe Commerce.

Atualizou a mensagem de erro de compatibilidade do Elasticsearch para mostrar as versões do Elasticsearch compatíveis com o módulo Adobe Commerce Elasticsearch. A mensagem de erro agora fornece as versões específicas do Elasticsearch a serem instaladas na infraestrutura em nuvem para que sejam compatíveis com o módulo do Elasticsearch usado por sua versão do Adobe Commerce. Consulte Erros de Aviso, Estágio de Implantação.

adicionou os erros de aviso 2026 e 2027 para a configuração de variável de ambiente MAGE_MODE inválida. O único valor válido é production. Antes desta correção, MAGE_MODE poderia ser definido como developer sem erros de implantação, apenas para causar erros mais tarde ao tentar gravar em arquivos somente leitura. Consulte Erros de Aviso.

Corrigida a validação de serviços Redis, RabbitMQ e MySQL para garantir que essas versões sejam compatíveis com a versão do Adobe Commerce. Versões válidas desses serviços agora são gravadas em cloud.log.

Atualizou o cloud.log para incluir o limite de solicitações simultâneas para envio de solicitações durante o aquecimento do cache. Este valor está configurado na variável pós-implantação WARM_UP_CONCURRENCY.

Adicionado o arquivo schema.error.yaml que inclui todas as notificações de erro e aviso que podem ocorrer durante o processo de compilação, implantação e pós-implantação, juntamente com sugestões para resolver os erros. As informações neste arquivo também estão disponíveis no Guia da Nuvem para o Commerce. Consulte Referência de mensagem de erro para ece-tools.

alterou as entradas do log de erros da nuvem (/var/log/cloud.error.log) para o formato JSON para facilitar a análise programática do log.

Adição de verificações de erro adicionais para compilar, implantar e pós-implantar o processamento e verificações existentes aprimoradas:

• Código de erro 2026 — Falha ao restaurar alguns dados gerados durante a fase de compilação para os diretórios montados

• Código de erro 3004 — Não é possível criar arquivos de backup

• Código de erro 102 — Adição de verificações adicionais para problemas que ocorrem quando o arquivo env.php não é gravável

Adicionado a variável de ambiente QUALITY_PATCHES para especificar um ou mais patches de qualidade a serem aplicados durante o processo de implantação. Consulte Criar variáveis.

Atualizações de infraestrutura—

• Melhorias no log—Recurso de rastreamento de log aprimorado ao atribuir códigos de saída a erros críticos de implantação e ao expor os códigos de saída em notificações de mensagens de erro e eventos de log. Consulte Referência de mensagem de erro para ece-tools.

• Melhoria do processo para despejos de banco de dados (vendor/bin/ece-tools db-dump) e atualização de mensagens de log para esclarecer que a operação de despejo de banco de dados alterna o aplicativo para o modo de manutenção, interrompe os processos de fila do consumidor e desabilita os trabalhos cron antes do início do despejo.

• Corrigido um problema para garantir que a URL do projeto seja atualizada corretamente ao implantar em ambientes de Preparo e Produção. Agora, ece-tools usa a URL para a rota com o atributo primary:true definido na configuração de rota do projeto. Consulte Implantar variáveis.

• atualizou o fluxo de trabalho do cenário de compilação generate.xml para aplicar patches. Os patches devem ser aplicados anteriormente para atualizar o Adobe Commerce para corrigir qualquer problema que possa causar falha nas etapas di:compile e module:refresh.

• Corrigido um problema no processo de instalação que retornava incorretamente o erro Crypt key missing. O valor crypt/key é gerado automaticamente durante a instalação.

Atualizações de serviço—

• Adicionado suporte para PHP 7.4 e MariaDB 10.4.

Atualizações de variáveis de ambiente—

• Adicionada a variável SCD_USE_BALER para habilitar o módulo Baler para agrupamento de JavaScript durante o processo de compilação da infraestrutura de nuvem do Adobe Commerce. Consulte a descrição da variável em variáveis de compilação.

• Adicionado a variável de ambiente REDIS_BACKEND para configurar o modelo de back-end Redis para o cache Redis para Adobe Commerce 2.3.5 ou posterior. Consulte a descrição da variável em implantar variáveis.

atualizações de comando CLI—

• Atualizou os seguintes comandos CLI com uma opção para log mais detalhado:

  • app:config:dump
  • app:config:import
  • module:enable

  O nível de log para cada chamada é determinado pela configuração da variável VERBOSE_COMMANDS no arquivo .magento.env.yaml.

Melhorias na validação—

• verificações de compatibilidade do Elasticsearch 7.x—Validação do Elasticsearch atualizada para verificações de compatibilidade de software do Elasticsearch 7.x.

• Verificações de versão de serviço atualizada e validação de EOL—Validação atualizada para verificar versões de serviço instaladas em relação ao Adobe Commerce 2.4. requisitos.

• Corrigido um problema de validação para que a seguinte mensagem de aviso de pós-implantação fosse exibida somente se a configuração de gancho post-deploy estivesse ausente do arquivo .magento.app.yaml:

  code language-text
  Your application does not have the "post_deploy" hook enabled.

• Adição da validação para dependências do Zend Framework—Adição da validação de dependência de compositor para o Zend Framework que migrou para o projeto Laminas. Se as dependências necessárias estiverem ausentes, a seguinte mensagem de erro será exibida durante o processo de criação.

  code language-text
  Required configuration is missing from the autoload section of the composer.json file. Add ("Laminas\Mvc\Controller\Zend\": "setupsrc/ Zend/Mvc/Controller/") to the `autoload -> psr-4` section. Then, re-run the "composer update" command locally, and commit the updated composer.json and composer.lock files.

  Consulte Verificar dependências do Zend Framework.

• Adicionada validação para env.php arquivos e dados—Adicionadas verificações para o env.php arquivo e dados durante o processo de instalação e atualização.

  • Se o arquivo env.php estiver ausente na instalação e o valor crypt/key não estiver especificado no arquivo .magento.app.yaml, a implantação falhará com a seguinte notificação:

    code language-text
    The crypt/key key value does not exist in the ./app/etc/env.php file or the CRYPT_KEY cloud environment variable``Missing crypt key for upgrading Magento`.

  • Se a instalação não incluir o arquivo env.php ou a configuração contiver apenas um tipo de cache, o comando cron:enable será executado durante o processo de atualização para restaurar o arquivo com todos os cache_types. A notificação a seguir é adicionada ao log:

    code language-text
    Magento state indicated as installed but configuration file app/etc/env.php was empty or did not exist. Required data will be restored from environment configurations and from the .magento.env.yaml file.

Atualizações de infraestrutura—

• Adição de um pacote separado do Cloud Docker para Commerce—Dissociação entre o pacote do Docker e o pacote ece-tools para manter a qualidade do código e fornecer versões independentes. As atualizações e correções relacionadas a ece-tools são gerenciadas no repositório GitHub da magento-cloud-docker.

• Atualização dos recursos de patch—A funcionalidade de patch do pacote ECE-Tools foi movida para um pacote magento-cloud-patches separado. Durante a implantação, ece-tools usa o novo pacote para aplicar patches. Consulte as notas de versão de patches de nuvem.

• Dependências atualizadas do Composer—Atualizou o arquivo composer.json do Adobe Commerce na infraestrutura de nuvem com uma dependência para o pacote magento/magento-cloud-docker. Agora, ece-tools inclui dependências para todos os pacotes em Cloud Tools Suite for Commerce. Esses pacotes são instalados e atualizados automaticamente quando você instala ou atualiza o ece-tools.

Suporte para implantações baseadas em cenário—

• Agora é possível personalizar os processos de compilação, implantação e pós-implantação usando arquivos de configuração XML para substituir ou personalizar a configuração padrão.

• Alterou a configuração hooks em.magento.app.yaml—Atualizamos o formato de configuração hooks para oferecer suporte a implantações baseadas em cenário. O formato herdado da versão anterior das ECE-Tools 2002.0.x ainda é suportado. No entanto, é necessário atualizar para o novo formato para usar o recurso de implantação baseada em cenário. Consulte Implantações baseadas em cenário.

Atualizações de serviço—

• Suporte adicionado para o PHP 7.3.

• Adicionado suporte para RabbitMQ 3.8.

• Validação adicionada para verificar as versões de serviço instaladas em relação à data de EOL de cada serviço. Agora, os clientes recebem uma notificação se uma versão do serviço estiver dentro de três meses da data EOL, e um aviso se a data EOL estiver no passado.

• Corrigido um problema de configuração do Elasticsearch para garantir que as configurações corretas do Elasticsearch sejam definidas em todos os ambientes.

Atualizações de variáveis de ambiente—

• Estendeu a funcionalidade da variável de ambiente WARM_UP_PAGES para oferecer suporte ao pré-carregamento de cache para páginas de produto específicas. Consulte a definição expandida no tópico variáveis pós-implantação.

• Adicionado a variável de ambiente ERROR_REPORT_DIR_NESTING_LEVEL para simplificar o gerenciamento de dados do relatório de erros no diretório <magento_root>/var/report/. Consulte a descrição da variável no tópico variáveis de compilação.

• Removido as variáveis de ambiente SCD_EXCLUDE_THEMES, STATIC_CONTENT_THREADS,DO_DEPLOY_STATIC_CONTENT e STATIC_CONTENT_SYMLINK. Ver Alterações incompatíveis com versões anteriores.

• Corrigido um problema no processo de configuração do Conjunto Elástico para que a configuração padrão fosse substituída conforme esperado ao configurar a variável de implantação ELASTICSUITE_CONFIGURATION sem a opção _merge.

atualizações de comando CLI—

• Novo comando cron—Agora é possível gerenciar manualmente o processamento de cron no ambiente do Adobe Commerce na infraestrutura de nuvem usando os comandos cron:disable e cron:enable. Use o comando disable para interromper todos os processos cron ativos e desativar todos os trabalhos cron. Use o comando enable para reativar os processos do cron quando estiver pronto. Consulte Desabilitar trabalhos cron.

• Melhoria no relatório de erros—Adição de um melhor registro para falhas de comando CLI que ocorrem durante o processamento de ECE-Tools.

• Remover comandos de compilação obsoletos— Os seguintes comandos de compilação foram removidos: m2-ece-build, m2-ece-deploy, m2-ece-scd-dump e ece-tools docker renomeados para ece-docker. Ver Alterações incompatíveis com versões anteriores

Removido o arquivo build_options.ini obsoleto e adicionada validação para falhar a compilação se o arquivo existir. Use o arquivo .magento.env.yaml para configurar as opções de compilação.

Corrigido um problema que causava a falha do processo de compilação quando o arquivo config.php estava vazio.