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 de 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 de Elasticsearch—Adicionou a capacidade de ler credenciais de autorização de 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 de Elasticsearch das relações—Validador do Fixed Service para recuperar a versão correta de Elasticsearch das propriedades relationships no Cloud Docker e nos 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 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 de 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 de Elasticsearch para mostrar as versões de Elasticsearch compatíveis com o módulo Elasticsearch Adobe Commerce. 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 pela 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

Adicionada a variável de ambiente QUALITY_PATCH 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 e validação de EOL atualizadas—Validação atualizada para verificar as versões de serviço instaladas em relação aos requisitos do Adobe Commerce 2.4.

• 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.