Note sulla versione di ECE-Tools

OpenSearch—Aggiunto supporto per OpenSearch per Adobe Commerce versioni 2.4.4, 2.4.3-p2 e 2.3.7-p3.

PHP—Aggiunto supporto per PHP 8.1.

symfony/process—Aggiunta compatibilità con symfony/process ^5.3.

Processi multipli consumer—Aggiunta di un’opzione multiple_processes che consente di specificare il numero di processi da generare per ogni consumer. Vedi la descrizione della variabile CRON_CONSUMERS_RUNNER nelle Variabili di distribuzione.

Schema OpenSearch e percorso host completo. È stata aggiunta la possibilità di configurare uno schema Elasticsearch e un percorso host completo.

AWS S3: metodo di abilitazione di AWS S3 modificato.

Correggi lettore driver_options—Aggiunta della configurazione driver_options di lettura per la connessione DB dal file env.php da parte di ece-tools per i validatori.

Aggiunto supporto per Composer 2.0.

Requisiti compositore aggiornati persymphony/console—Sono stati aggiornati i requisiti di versione composer.json degli strumenti ECE per il pacchetto symphony/console per risolvere un problema che ha causato l’errore seguente ai comandi di:compile: Incompatible argument type: Required type: int. Actual type: string

Aggiornamento dei controlli software di fine del ciclo di vita (eol.yaml) per includere Elasticsearch 7.9.x.

Credenziali di autenticazione Redis—Aggiunta la possibilità di leggere le credenziali di autorizzazione Redis dalla proprietà relationships durante la fase di distribuzione.

Credenziali di autorizzazione Elasticsearch—Aggiunta la possibilità di leggere le credenziali di autorizzazione Elasticsearch dalla proprietà relationships durante la fase di distribuzione.

Servizio di archiviazione delle sessioni dedicato. Aggiunta di redis-session come seconda opzione per l’archiviazione delle sessioni. È possibile utilizzare il servizio redis-session per archiviare le informazioni sulla sessione e utilizzare il servizio redis per la cache per fornire prestazioni migliori.

Messaggi SPLIT_DB obsoleti—Aggiunti avvisi di convalida e messaggi critici per l’opzione SPLIT_DB obsoleta per Adobe Commerce 2.4.2 e la sua rimozione in Adobe Commerce 2.5.0.

Versione di Elasticsearch dalle relazioni—È stato corretto il modulo di convalida del servizio per recuperare la versione corretta di Elasticsearch dalle proprietà relationships in Cloud Docker e negli ambienti di integrazione.

Convalida porta Redis flessibile. Redis può ora convalidare la porta in una connessione alla cache personalizzata dall’URL server. Ad esempio, è possibile aggiungere il numero di porta all’URL del server come segue: server: 'tcp://rfs-store-simple-page-cache:26379'. Ciò consente di evitare errori di convalida in cui l’opzione port è mancante o non corretta.

Aggiornamento ad Adobe Commerce 2.4.2—È stato risolto il problema che richiedeva agli utenti di eseguire manualmente bin/magento setup:upgrade per rendere operativi i propri siti dopo l’aggiornamento ad Adobe Commerce 2.4.2.

Archiviazione remota. Aggiunta variabile di ambiente REMOTE_STORAGE per abilitare i progetti cloud per l’archiviazione remota di file multimediali tramite un servizio di archiviazione, ad esempio AWS S3. Questa opzione di configurazione fa parte del pacchetto ECE-Tools, ma non è supportata in Adobe Commerce sull’infrastruttura cloud.

Nuovo comando cloud:config:validate—È stato aggiunto il comando php vendor/bin/ece-tools cloud:config:validate per convalidare la configurazione .magento.env.yaml prima di inviare le modifiche all’ambiente cloud remoto.

Svuotamento della opcache. È stato aggiunto il supporto per l’opzione PHP opcache.enable_cli per svuotare la OPcache prima di eseguire l’hook di distribuzione. Questa configurazione reimposta la configurazione della cache per garantire che le impostazioni di configurazione correnti vengano applicate a ogni distribuzione.

Convalida di Aurora DB: la convalida del servizio di database è stata aggiornata in modo da renderla compatibile con il database Aurora.

Nuova variabile di ambiente SCD_NO_PARENT - Aggiunta della variabile di ambiente SCD_NO_PARENT (per Adobe Commerce >=2.4.2) per gestire la generazione di contenuto statico per i temi principali.

Limiti di memoria e comandi—È stato risolto un problema che impediva il funzionamento di php vendor/bin/ece-tools comandi se le dimensioni del file cloud.log superavano il limite di memoria PHP. Invece di leggere l’intero file cloud.log in memoria, ora si legge solo un sottoinsieme di dati più piccolo dal file di registro.

Connessioni di database personalizzate—È stato risolto un problema di configurazione .magento.env.yaml a causa del quale non venivano utilizzate le connessioni di database personalizzate definite per DATABASE_CONFIGURATION. Impossibile aggiungere le impostazioni di connessione a app/etc/env.php.

Registri di errore vuoti—È stato risolto un problema che causava errori di distribuzione se cloud.error.log era vuoto.

Convalida MariaDB 10.3—È stata corretta la convalida di MariaDB 10.3 per Adobe Commerce 2.3.6-p1.

Cache:flush logging—Sono state migliorate le voci di log per indicare l’inizio e la fine del passaggio cache:flush.

Aggiunta del supporto ECE-Tools per la directory pub/static di sola lettura quando il contenuto statico è impostato per la distribuzione nella fase di compilazione.

Aggiunto supporto per Elasticsearch 7.9 e Redis 6 per compatibilità con le prossime versioni di Adobe Commerce.

Aggiornamento degli strumenti ECE composer.json per aggiungere una dipendenza necessaria per lo strumento Patch di qualità. In questo modo viene corretta una dipendenza circolare esistente tra i pacchetti ECE-Tools e magento-cloud-patches.

Aggiunta della convalida del motore di ricerca per garantire che elasticsearch sia impostato per Adobe Commerce sull’infrastruttura cloud 2.4 e versioni successive. Se la convalida non riesce, la distribuzione viene interrotta con un messaggio di errore critico che suggerisce correzioni per il problema. Vedi Errori critici, fase di distribuzione.

Aggiunta della convalida Elasticsearch per verificare la compatibilità tra la versione del servizio Elasticsearch e la versione di Adobe Commerce.

Il messaggio di errore di compatibilità di Elasticsearch è stato aggiornato in modo da visualizzare le versioni di Elasticsearch compatibili con il modulo Elasticsearch di Adobe Commerce. Il messaggio di errore fornisce ora le versioni specifiche di Elasticsearch da installare nell’infrastruttura Cloud in modo che siano compatibili con il modulo Elasticsearch utilizzato dalla versione di Adobe Commerce in uso. Vedi Errori di avviso, fase di distribuzione.

Sono stati aggiunti errori di avviso 2026 e 2027 per un’impostazione non valida della variabile di ambiente MAGE_MODE. L’unico valore valido è production. Prima di questa correzione, è possibile impostare MAGE_MODE su developer senza errori di distribuzione, solo per causare errori in un secondo momento quando si tenta di scrivere in file di sola lettura. Vedi Errori di avviso.

È stata corretta la convalida per i servizi Redis, RabbitMQ e MySQL per garantire che queste versioni siano compatibili con la versione di Adobe Commerce. Versioni valide di questi servizi sono ora scritte in cloud.log.

Aggiornato cloud.log per includere il limite di richieste simultanee per l’invio di richieste durante il riscaldamento della cache. Questo valore è configurato nella variabile post-distribuzione WARM_UP_CONCURRENCY.

Aggiunto il file schema.error.yaml che include tutte le notifiche di errore e di avviso che possono verificarsi durante il processo di compilazione, distribuzione e post-distribuzione insieme a suggerimenti per la risoluzione degli errori. Le informazioni contenute in questo file sono disponibili anche nella Guida a Cloud per Commerce. Vedi Riferimento messaggio di errore per strumenti ece.

Le voci del registro errori cloud (/var/log/cloud.error.log) sono state modificate in formato JSON per semplificare l’analisi del registro a livello di programmazione.

Sono stati aggiunti ulteriori controlli di errore per la compilazione, la distribuzione e l’elaborazione post-distribuzione e sono stati migliorati i controlli esistenti:

• Codice di errore 2026 - Impossibile ripristinare alcuni dati generati durante la fase di build nelle directory montate

• Codice di errore 3004 - Impossibile creare i file di backup

• Codice errore 102 - Sono state aggiunte ulteriori verifiche per i problemi che si verificano quando il file env.php non è scrivibile

Aggiunta della variabile di ambiente QUALITY_PATCHES per specificare una o più patch di qualità da applicare durante il processo di distribuzione. Vedi Variabili di compilazione.

Aggiornamenti dell’infrastruttura—

• Miglioramenti alla registrazione—È stata migliorata la funzionalità di tracciamento del registro assegnando codici di uscita a errori critici di distribuzione ed esponendo i codici di uscita nelle notifiche dei messaggi di errore e negli eventi di registro. Vedi Riferimento messaggio di errore per strumenti ece.

• È stato migliorato il processo per le immagini del database (vendor/bin/ece-tools db-dump) e i messaggi di registro aggiornati per chiarire che l’operazione di dump del database passa l’applicazione alla modalità di manutenzione, interrompe i processi della coda del consumatore e disabilita i processi cron prima dell’inizio dell’immagine.

• È stato risolto un problema che impediva l’aggiornamento corretto dell’URL del progetto durante la distribuzione negli ambienti di staging e produzione. Ora ece-tools utilizza l’URL per la route con l’attributo primary:true impostato nella configurazione della route del progetto. Vedi Distribuire le variabili.

• Aggiornato il flusso di lavoro dello scenario di compilazione generate.xml per l’applicazione di patch. Le patch devono essere applicate prima per aggiornare Adobe Commerce e risolvere eventuali problemi che potrebbero causare errori nei passaggi di:compile e module:refresh.

• È stato risolto un problema nel processo di installazione che restituiva erroneamente l’errore Crypt key missing. Il valore crypt/key viene generato automaticamente durante l’installazione.

Aggiornamenti dei servizi—

• Aggiunto supporto per PHP 7.4 e MariaDB 10.4.

Aggiornamenti della variabile di ambiente—

• Aggiunta della variabile SCD_USE_BALER per abilitare il modulo Baler per il bundle JavaScript durante il processo di compilazione dell’infrastruttura cloud Adobe Commerce. Vedi la descrizione della variabile nelle variabili build.

• Aggiunta della variabile di ambiente REDIS_BACKEND per configurare il modello di back-end Redis per la cache Redis per Adobe Commerce 2.3.5 o versione successiva. Vedi la descrizione della variabile nelle variabili di distribuzione.

Aggiornamenti del comando CLI—

• Sono stati aggiornati i seguenti comandi CLI con un’opzione per una registrazione più dettagliata:

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

  Il livello di registrazione per ogni chiamata è determinato dalla configurazione della variabile VERBOSE_COMMANDS nel file .magento.env.yaml.

Miglioramenti alla convalida—

• Controlli di compatibilità di Elasticsearch 7.x—È stata aggiornata la convalida di Elasticsearch per i controlli di compatibilità del software Elasticsearch 7.x.

• Versioni del servizio aggiornate e controlli di convalida EOL—Convalida aggiornata per verificare le versioni del servizio installate rispetto a Adobe Commerce 2.4. requisiti.

• È stato risolto un problema di convalida in modo che il seguente messaggio di avviso post-distribuzione venga visualizzato solo se la configurazione dell’hook post-deploy non è presente nel file .magento.app.yaml:

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

• Aggiunta della convalida per le dipendenze di Zend Framework - Aggiunta della convalida delle dipendenze del compositore per Zend Framework migrato al progetto Laminas. Se mancano le dipendenze richieste, durante il processo di compilazione viene visualizzato il seguente messaggio di errore.

  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.

  Vedere Verificare le dipendenze di Zend Framework.

• Aggiunta della convalida per env.php file e dati - Aggiunta delle verifiche per il file env.php e i dati durante il processo di installazione e aggiornamento.

  • Se il file env.php non è presente nell’installazione e il valore crypt/key non è specificato nel file .magento.app.yaml, la distribuzione non riesce e viene visualizzata la seguente notifica:

    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 l’installazione non include il file env.php o la configurazione contiene un solo tipo di cache, il comando cron:enable viene eseguito durante il processo di aggiornamento per ripristinare il file con tutti i cache_types. Al registro viene aggiunta la seguente notifica:

    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.

Aggiornamenti dell’infrastruttura—

• È stato aggiunto un pacchetto separato per Cloud Docker per Commerce. Il pacchetto Docker è stato separato dal pacchetto ece-tools per mantenere la qualità del codice e fornire versioni indipendenti. Gli aggiornamenti e le correzioni relativi a ece-tools sono gestiti dall’archivio GitHub magento-cloud-docker.

• Funzionalità di applicazione delle patch aggiornate—La funzionalità di applicazione delle patch è stata spostata dal pacchetto ECE-Tools a un pacchetto magento-cloud-patches separato. Durante la distribuzione, ece-tools utilizza il nuovo pacchetto per applicare le patch. Consulta le note sulla versione delle patch cloud.

• Sono state aggiornate le dipendenze del Compositore—È stato aggiornato il file composer.json per Adobe Commerce nell’infrastruttura cloud con una dipendenza per il pacchetto magento/magento-cloud-docker. Ora ece-tools include le dipendenze per tutti i pacchetti in Cloud Tools Suite for Commerce. Questi pacchetti vengono installati e aggiornati automaticamente quando si installa o si aggiorna ece-tools.

Supporto per le distribuzioni basate su scenari—

• Ora è possibile personalizzare i processi di compilazione, distribuzione e post-distribuzione utilizzando i file di configurazione XML per sostituire o personalizzare la configurazione predefinita.

• È stata modificata la configurazione hooks in.magento.app.yaml. Il formato di configurazione hooks è stato aggiornato per supportare le distribuzioni basate su scenari. Il formato legacy della versione precedente di ECE-Tools 2002.0.x è ancora supportato. Tuttavia, è necessario eseguire l’aggiornamento al nuovo formato per utilizzare la funzione di distribuzione basata su scenari. Consulta Distribuzioni basate su scenari.

Aggiornamenti dei servizi—

• Aggiunto supporto per PHP 7.3.

• Aggiunto supporto per RabbitMQ 3.8.

• Aggiunta della convalida per verificare le versioni del servizio installate rispetto alla data di fine del ciclo di vita per ogni servizio. Ora i clienti ricevono una notifica se la versione di un servizio è entro tre mesi dalla data di fine del ciclo di vita e un avviso se la data di fine del ciclo di vita è nel passato.

• È stato risolto un problema di configurazione di Elasticsearch per garantire che in tutti gli ambienti siano configurate le impostazioni Elasticsearch corrette.

Aggiornamenti della variabile di ambiente—

• Ha esteso la funzionalità della variabile di ambiente WARM_UP_PAGES per supportare il precaricamento della cache per pagine di prodotto specifiche. Vedi la definizione espansa nell’argomento variabili post-distribuzione.

• Aggiunta variabile di ambiente ERROR_REPORT_DIR_NESTING_LEVEL per semplificare la gestione dei dati della segnalazione errori nella directory <magento_root>/var/report/. Vedi la descrizione della variabile nell’argomento variabili build.

• Ha rimosso le variabili di ambiente SCD_EXCLUDE_THEMES, STATIC_CONTENT_THREADS,DO_DEPLOY_STATIC_CONTENT e STATIC_CONTENT_SYMLINK. Visualizza modifiche non compatibili con le versioni precedenti.

• È stato risolto un problema nel processo di configurazione della suite elastica in modo che la configurazione predefinita venga sovrascritta come previsto quando si configura la variabile di distribuzione ELASTICSUITE_CONFIGURATION senza l’opzione _merge.

Aggiornamenti del comando CLI—

• Nuovo comando cron. È ora possibile gestire manualmente l’elaborazione cron nell’ambiente Adobe Commerce nell’infrastruttura cloud utilizzando i comandi cron:disable e cron:enable. Utilizzare il comando disable per arrestare tutti i processi cron attivi e disattivare tutti i processi cron. Utilizzare il comando enable per riattivare i processi cron quando si è pronti. Vedi Disabilita processi cron.

• È stata migliorata la segnalazione degli errori. È stata aggiunta una registrazione migliore per gli errori dei comandi CLI che si verificano durante l’elaborazione ECE-Tools.

• Rimuovi i comandi di compilazione obsoleti— Sono stati rimossi i seguenti comandi di compilazione: m2-ece-build, m2-ece-deploy, m2-ece-scd-dump e sono stati rinominati ece-tools docker comandi in ece-docker. Visualizza modifiche non compatibili con le versioni precedenti

Il file build_options.ini obsoleto è stato rimosso e la convalida aggiunta non è riuscita a generare la build se il file esiste. Utilizza il file .magento.env.yaml per configurare le opzioni di compilazione.

È stato risolto un problema che ha causato un errore nel processo di compilazione quando il file config.php è vuoto.