Note sulla versione di ECE-Tools

Il pacchetto ece-tools è un insieme di script e strumenti progettati per gestire e distribuire progetti Cloud. Queste note sulla versione descrivono gli ultimi miglioramenti apportati a questo pacchetto, che fa parte della suite di strumenti cloud per Commerce.

NOTE
Per informazioni sull'aggiornamento all'ultima versione del pacchetto ece-tools, vedere Aggiornamento degli strumenti ECE.

Il pacchetto ece-tools utilizza la seguente sequenza di versioni di rilascio: 200<major>.<minor>.<patch>

Le note sulla versione includono:

  • nuova icona Nuove funzioni
  • icona correzione Correzioni e miglioramenti

v2002.1.19 latest

Data di rilascio: 21 maggio 2024

  • nuova icona Lua—Aggiunta dell'opzione useLua per CACHE_CONFIGURATION.
  • icona correzione Convalida—Sono state aggiornate le convalide per le nuove versioni di Redis e RabbitMQ.

v2002.1.18

Data di rilascio: 8 aprile 2024

  • nuova icona PHP — Aggiunto supporto per PHP 8.3.
  • icona correzione Convalida - Convalida fine vita aggiornata.

v2002.1.17

Data di rilascio: 16 gennaio 2024

  • icona correzione Convalida per Elasticsearch & OpenSearch—È stato corretto il messaggio di convalida che generava un messaggio fuorviante per installare un servizio di ricerca quando LiveSearch è abilitato.
  • icona di correzione Avviso di distribuzione—È stato risolto un problema che causava avvisi di distribuzione per le cartelle non vuote.

v2002.1.16

Data di rilascio: 16 ottobre 2023

  • nuova icona Variabile di ambiente globale ENABLE_WEBHOOKS - Aggiunta della variabile globale ENABLE_WEBHOOKS da utilizzare con i webhook di Commerce per la connessione a un endpoint esterno, ad esempio l'azione di runtime di App Builder o un sistema di gestione dell'inventario di terze parti.

v2002.1.15

Data di rilascio: 31 luglio 2023

  • icona correzione Codici di errore—Aggiornamento dello schema dei codici di errore e del generatore di documenti dei codici di errore.
  • icona correzione Convalida per il modello Redis personalizzato-Aggiornamento della convalida per i modelli di back-end Redis personalizzati. Vedere l'esempio per la configurazione della cache.
  • icona correzione Convalida per RabbitMQ-Aggiunto supporto per RabbitMQ 3.11
  • icona correzione È stato corretto il collegamento errato-È stato corretto il collegamento errato alla documentazione di onboarding nel modello e-mail di benvenuto.

v2002.1.14

Data di rilascio: 10 marzo 2023

  • nuova icona PHP—Aggiunto supporto per PHP 8.2.
  • nuova icona Convalida per i servizi—Sono state aggiornate le convalide per i servizi richiesti di Commerce 2.4.6: MariaDB 10.6, Redis 7.0, PHP 8.2, OpenSearch 2.x e RabbitMQ 3.9.
  • icona correzione strumenti ece db-dump—È stato risolto un problema che causava l'interruzione anticipata dell'operazione db-dump.

v2002.1.13

Data di rilascio: 27 ottobre 2022

  • nuova icona Aggiunto supporto per eventi di Adobe I/O per Adobe Commerce. Gli sviluppatori di estensioni possono ora utilizzare il framework Adobe I/O Events per inviare informazioni sugli eventi Commerce dalle istanze Cloud alle proprie applicazioni scritte per Adobe App Builder. Eventi di Adobe I/O per Adobe Commerce in Anteprima partner.
  • nuova icona Convalida per la configurazione OPcache—Aggiunta di un validatore per verificare la configurazione OPcache per i percorsi esclusi.
  • icona correzione È stato risolto un problema con la configurazione della cache di GraphQL. Ora ECE-Tools mantiene il valore di GraphQL id_salt nella configurazione di cache nel file app/etc/env.php.

v2002.1.12

Data di rilascio: 13 settembre 2022

  • nuova icona Abilitasynchronous_replication—ECE-Tools imposta synchronous_replication=>true nel file app/etc/env.php quando MYSQL_USE_SLAVE_CONNECTION è abilitato. Questa configurazione interessa solo Commerce 2.4.6+. Vedi la descrizione della variabile MYSQL_USE_SLAVE_CONNECTION nelle Variabili di distribuzione.
  • nuova icona OpenSearch—Aggiunta della funzionalità per configurare e impostare il motore opensearch per la prossima versione di Adobe Commerce 2.4.6. Vedere Configurazione del servizio OpenSearch.

v2002.1.11

Data di rilascio: 4 agosto 2022

  • icona di correzione ElasticSuite Validator e OpenSearch—È stato corretto un problema di convalida del controllo di integrità ElasticSuite quando OpenSearch è installato.
  • icona correzione Tipi restituiti per i comandi di distribuzione—Sono stati corretti i tipi restituiti per i comandi di distribuzione.
  • icona di correzione RabbitMQproblema con la nuova installazione di Commerce 2.4.5—È stato risolto RabbitMQ problema di arresto anomalo nella nuova installazione di Commerce 2.4.5.

v2002.1.10

Data di rilascio: 31 marzo 2022

  • icona correzione Elasticsearch 7.10—Sono state aggiornate le convalide per supportare la versione 7.10 di Elasticsearch.

v2002.1.9

Data di rilascio: 10 marzo 2022

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

  • nuova icona PHP—Aggiunto supporto per PHP 8.1.

  • icona correzione symfony/process—Aggiunta compatibilità con symfony/process ^5.3.

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

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

  • icona correzione AWS S3: metodo di abilitazione di AWS S3 modificato.

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

v2002.1.8

Data di rilascio: 25 ottobre 2021

  • nuova icona Percorso dump alternativo. Aggiunta dell'opzione --dump-directory che consente di scegliere una directory di destinazione per un dump del database. Ora /app/var/dump-main è la directory di destinazione predefinita per un dump del database. Consulta Gestione backup: scarica il database
  • icona correzione Aggiorna monologo—È stata aggiornata la versione minima richiesta per il pacchetto monolog in ^2.3.
  • icona correzione Aggiorna Symfony—Sono state aggiornate le dipendenze di Symfony per renderle compatibili con Adobe Commerce 2.4.4.
  • icona di correzione Caricamento automatico funzionalità/risoluzione—È stato risolto un problema che si verificava durante la distribuzione in un ambiente di integrazione e durante la visualizzazione dell'errore CRITICAL: [9] Required configuration is missed in autoload section of composer.json file..

v2002.1.7

Data di rilascio: 29 luglio 2021

Aggiornamenti configurazione

  • nuova icona Aggiunto supporto per Composer 2.0.

  • icona correzione 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

  • icona correzione Aggiornamento dei controlli software di fine del ciclo di vita (eol.yaml) per includere l'Elasticsearch 7.9.x.

v2002.1.6

Data di rilascio: 20 aprile 2021

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

  • nuova icona Credenziali di autorizzazione dell'Elasticsearch—Aggiunta la possibilità di leggere le credenziali di autorizzazione dell'Elasticsearch dalla proprietà relationships durante la fase di distribuzione.

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

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

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

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

  • icona di correzione 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.

v2002.1.5

Data di rilascio: 1 febbraio 2021

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

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

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

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

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

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

  • icona di correzione 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.

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

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

  • icona correzione Cache:log di scaricamento—Sono state migliorate le voci di registro per indicare l'inizio e la fine del passaggio cache:flush.

v2002.1.4

Data di rilascio: 19 novembre 2020

  • icona correzione È stato risolto un problema che causava un errore di distribuzione quando il motore di ricerca specificato nella variabile di ambiente SEARCH_CONFIGURATION è un valore diverso da elasticsearch.

v2002.1.3

Data di rilascio: 9 novembre 2020

Aggiornamenti dell'infrastruttura

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

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

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

Miglioramenti di convalida e registro

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

  • nuova icona Aggiunta della convalida dell'Elasticsearch per verificare la compatibilità tra la versione del servizio Elasticsearch e la versione di Adobe Commerce.

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

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

  • icona correzione È 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.

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

Aggiornamenti del comando CLI

  • nuova icona Sono stati aggiunti comandi CLI (cloud:config:create e cloud:config:update) per creare e aggiornare il file .magento.env.yaml con una configurazione che può includere una o più variabili di compilazione, distribuzione e post-distribuzione. Vedere Crea file di configurazione da CLI.

Aggiornamenti della variabile di ambiente

  • nuova icona Aggiunta variabile di compilazione SKIP_COMPOSER_DUMP_AUTOLOAD. L'impostazione della variabile su true impedisce all'applicazione di eseguire il comando composer dump-autoload durante un'installazione di Cloud Docker per Commerce. La variabile è rilevante solo per Cloud Docker per contenitori Commerce con file system scrivibili (creati per il test e lo sviluppo utilizzando ./vendor/bin/ece-docker build:compose --with-test). In tali installazioni, ignorando il comando composer dump-autoload si evitano errori durante l'esecuzione di altri comandi che tentano di accedere ai file da una directory generated eliminata.

v2002.1.2

Data di rilascio: 5 agosto 2020

Miglioramenti di convalida e registro

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

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

  • nuova icona 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

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

v2002.1.1

Data di rilascio: 25 giugno 2020

  • nuova icona Aggiornamenti dell'infrastruttura

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

    • nuova icona È 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.

    • icona di correzione È 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.

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

    • icona correzione È 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.

  • nuova icona Aggiornamenti dei servizi

    • nuova icona Aggiunto supporto per PHP 7.4 e MariaDB 10.4.
  • nuova icona Aggiornamenti della variabile di ambiente

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

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

  • nuova icona Aggiornamenti del comando CLI

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

  • nuova icona Miglioramenti alla convalida

    • nuova icona Verifica compatibilità Elasticsearch 7.x—Convalida Elasticsearch aggiornata per i controlli compatibilità software Elasticsearch 7.x.

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

    • icona di correzione È 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.
      
    • nuova icona 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.

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

v2002.1.0

Data di rilascio: 6 febbraio 2020

  • nuova icona Aggiornamenti dell'infrastruttura

    • nuova icona È 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.

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

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

  • nuova icona Supporto per le distribuzioni basate su scenari

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

    • nuova icona È 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.

NOTE
Prima di eseguire l'aggiornamento a ECE-Tools versione 2002.1.0, rivedere indietro modifiche non compatibili per informazioni sulle modifiche che potrebbero richiedere aggiorna la configurazione o i processi del progetto di infrastruttura cloud di Adobe Commerce.
05f2f56e-ac5d-4931-8cdb-764e60e16f26