Notas de versão do ECE-Tools

OpenSearch—Adição de suporte ao OpenSearch para Adobe Commerce versões 2.4.4, 2.4.3-p2 e 2.3.7-p3.

PHP—Suporte adicionado para PHP 8.1.

symfony/process—Adição da compatibilidade com o symfony/process ^5.3.

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

Esquema OpenSearch e caminho completo do host— Adição da capacidade de configurar um esquema de Elasticsearch e um caminho completo do host.

AWS S3—Alteração do método de ativação do AWS S3.

Corrigir leitor de driver_options—Adição da leitura da configuração driver_options para conexão de BD do env.php arquivo por ece-tools para validadores.

Adição de suporte para o Composer 2.0.

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

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

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

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

Serviço dedicado de armazenamento de sessão—Adicionado redis-session como uma segunda opção para armazenamento de sessão. Você pode usar o redis-session serviço para armazenar informações da sessão e usar o redis para que o cache forneça melhor desempenho.

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

Versão do Elasticsearch de relacionamentos—Validador de serviço fixo para recuperar a versão correta do Elasticsearch do relationships propriedades 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 do server URL. 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 nos quais o port opção está ausente ou incorreta.

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

Armazenamento remoto—Adição de REMOTE_STORAGE variável de ambiente para habilitar Projetos na nuvem para armazenamento remoto de arquivos de mídia usando um serviço de armazenamento, como o AWS S3. Essa opção de configuração faz parte do pacote ECE-Tools, mas não é compatível com o Adobe Commerce na infraestrutura em nuvem.

Novo cloud:config:validate comando— Adicionado comando php vendor/bin/ece-tools cloud:config:validate para validar o .magento.env.yaml antes de enviar as alterações para o ambiente de nuvem remoto.

Liberando o opcache—Suporte adicionado para o opcache.enable_cli Opção PHP 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 Aurora DB—Atualização da 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—Adição de SCD_NO_PARENT Variável de ambiente (para Adobe Commerce >=2.4.2) para gerenciar a geração de conteúdo estático para temas principais.

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

Conexões de banco de dados personalizadas—Correção de um .magento.env.yaml problema de configuração em que conexões de banco de dados personalizadas são definidas para DATABASE_CONFIGURATION não foram utilizados. As configurações de conexão não eram adicionadas a app/etc/env.php.

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

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

Cache:log de liberação—Entradas de log aprimoradas para indicar o início e o término do cache:flush etapa.

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

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

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

Adição da validação do mecanismo de pesquisa para garantir que elasticsearch está definido para Adobe Commerce na infraestrutura em 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 de Elasticsearch e a versão do Adobe Commerce.

Atualização da 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.

Adição de erros de aviso 2026 e 2027 para inválido MAGE_MODE configuração da variável de ambiente. O único valor válido é production. Antes dessa correção, MAGE_MODE pode ser definido como developer sem erros de implantação, apenas para causar erros posteriormente ao tentar gravar em arquivos somente leitura. Consulte Erros de Aviso.

Correção da validação para os 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 no cloud.log.

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

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

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

Adição de verificações de erros para criar, implantar e pós-implantar o processamento e aprimoramento das verificações existentes:

• 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 a variável env.php o arquivo não é gravável

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

Atualizações da infraestrutura—

• Melhorias no registro—Melhor recurso de rastreamento de registros atribuindo códigos de saída a erros críticos de implantação e expondo 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 de despejos de banco de dados (vendor/bin/ece-tools db-dump) e mensagens de log atualizadas para esclarecer que a operação de despejo de banco de dados alterna o aplicativo para o modo de manutenção, interrompe os processos da fila do consumidor e desativa os trabalhos cron antes do início do despejo.

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

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

• Correção de um problema no processo de instalação que retornava incorretamente a variável Crypt key missing erro. A variável crypt/key é gerado automaticamente durante a instalação.

Atualizações de serviço—

• Suporte adicionado para PHP 7.4 e MariaDB 10.4.

Atualizações de variável de ambiente—

• Adição de SCD_USE_BALER para ativar o módulo Baler para empacotamento de JavaScript durante o processo de criação da infraestrutura em nuvem do Adobe Commerce. Consulte a descrição da variável no criar variáveis.

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

Atualizações de comando da CLI—

• Atualização dos seguintes comandos CLI com uma opção para registro mais detalhado:

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

  O nível de registro para cada chamada é determinado pela configuração do VERBOSE_COMMANDS na variável .magento.env.yaml arquivo.

Melhorias na validação—

• Verificações de compatibilidade do Elasticsearch 7.x—Atualização da validação de Elasticsearch para as 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 do serviço instalado em relação aos requisitos do Adobe Commerce 2.4.

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

  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 as dependências do Zend Framework.

• Validação adicionada para env.php arquivo e dados—Adição de verificações para o env.php arquivos e dados durante o processo de instalação e atualização.

  • Se a variável env.php arquivo estiver ausente na instalação, e a variável crypt/key o valor não está especificado no .magento.app.yaml falha na implantação 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 a variável env.php arquivo ou a configuração contiver apenas um tipo de cache, a variável cron:enable é 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 da infraestrutura—

• Adição de pacote separado para o Cloud Docker para Commerce—Dissociação do pacote Docker do ece-tools pacote para manter a qualidade do código e fornecer versões independentes. Atualizações e correções relacionadas ao ece-tools são gerenciados no magento-cloud-docker Repositório GitHub.

• Recursos de patch atualizados—A funcionalidade de correção foi movida do pacote ECE-Tools para um magento-cloud-patches pacote. Durante a implantação, ece-tools O usa o novo pacote para aplicar patches. Consulte Notas de versão de patches de nuvem.

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

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

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

• Alterou o hooks configuração no.magento.app.yaml—Atualizamos o hooks formato de configuração para suportar implantações baseadas em cenários. 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.

• Adição de suporte para o RabbitMQ 3.8.

• Validação adicionada para verificar as versões do serviço instaladas em relação à data 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.

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

Atualizações de variável de ambiente—

• Ampliou a funcionalidade do WARM_UP_PAGES variável de ambiente para suportar o pré-carregamento de cache de páginas de produto específicas. Consulte a definição expandida na variáveis pós-implantação tópico.

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

• Remoção da SCD_EXCLUDE_THEMES, STATIC_CONTENT_THREADS,DO_DEPLOY_STATIC_CONTENT, e STATIC_CONTENT_SYMLINK variáveis de ambiente. Consulte Alterações incompatíveis com versões anteriores.

• Correção de um problema no processo de configuração do Elastic Suite para que a configuração padrão seja substituída conforme esperado ao configurar o ELASTICSUITE_CONFIGURATION implantar variável sem o _merge opção.

Atualizações de comando da CLI—

• Novo comando cron— Agora é possível gerenciar manualmente o processamento de cron no ambiente de infraestrutura Adobe Commerce em nuvem usando o cron:disable e cron:enable comandos. 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.

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

• Remover comandos de build obsoletos— Os seguintes comandos de build foram removidos: m2-ece-build, m2-ece-deploy, m2-ece-scd-dumpe renomeado ece-tools docker comandos para ece-docker. Consulte Alterações incompatíveis com versões anteriores

Remoção do obsoleto build_options.ini arquivo e adição da validação para falhar a criação, se o arquivo existir. Use o .magento.env.yaml arquivo para configurar as opções de compilação.

Correção de um problema que causava a falha do processo de criação quando a variável config.php O arquivo está vazio.