ECE-Tools release notes

OpenSearch—Added support for OpenSearch for Adobe Commerce versions 2.4.4, 2.4.3-p2, and 2.3.7-p3.

PHP—Added support for PHP 8.1.

symfony/process—Added the compatibility with symfony/process ^5.3.

Consumer multiple processes—Added a multiple_processes option so that you can specify the number of processes to spawn for each consumer. See the CRON_CONSUMERS_RUNNER variable description in the Deploy variables.

OpenSearch scheme and full host path—Added the ability to configure an Elasticsearch scheme and full host path.

AWS S3—Changed the method of AWS S3 enablement.

Fix driver_options reader—Added reading driver_options configuration for DB connection from the env.php file by ece-tools for validators.

Added support for Composer 2.0.

Updated composer requirements for symphony/console—Updated the ECE-Tools composer.json version requirements for the symphony/console package to fix an issue that caused the di:compile commands to fail with the following error: Incompatible argument type: Required type: int. Actual type: string

Updated the end-of-life software checks (eol.yaml) to include Elasticsearch 7.9.x.

Redis authentication credentials—Added the ability to read Redis authorization credentials from the relationships property during the deploy phase.

Elasticsearch authorization credentials—Added the ability to read Elasticsearch authorization credentials from the relationships property during the deploy phase.

Dedicated session storage service—Added redis-session as a second option for session storage. You can use the redis-session service to store session information and use the redis service for cache to provide better performance.

Deprecated SPLIT_DB messages—Added validator warning and critical messages for the deprecated SPLIT_DB option for Adobe Commerce 2.4.2 and its removal in Adobe Commerce 2.5.0.

Elasticsearch version from relationships—Fixed Service validator to retrieve the correct version of Elasticsearch from the relationships properties in Cloud Docker and integration environments.

Flexible Redis port validation—Redis can now validate the port in a custom cache connection from the server URL. For example, you can add your port number to your server URL as follows: server: 'tcp://rfs-store-simple-page-cache:26379'. This helps prevent validation errors where the port option is either missing or incorrect.

Upgrading to Adobe Commerce 2.4.2—Fixed the issue that required users to manually run bin/magento setup:upgrade to make their sites operational after upgrading to Adobe Commerce 2.4.2.

Remote storage—Added the REMOTE_STORAGE environment variable to enable Cloud Projects for remote storage of media files using a storage service, such as AWS S3. This configuration option is part of the ECE-Tools package, but is not supported on Adobe Commerce on cloud infrastructure.

New cloud:config:validate command—Added command php vendor/bin/ece-tools cloud:config:validate to validate the .magento.env.yaml configuration before pushing changes to the remote Cloud environment.

Flushing the opcache—Added support for the opcache.enable_cli PHP option to flush the OPcache before running the deploy hook. This configuration resets the cache configuration to ensure that the current configuration settings are applied on each deployment.

Validation of Aurora DB—Updated the database service validation so that it is compatible with the Aurora database.

New SCD_NO_PARENT environment variable—Added the SCD_NO_PARENT environment variable (for Adobe Commerce >=2.4.2) to manage the generation of static content for parent themes.

Memory limits and commands—Fixed an issue where php vendor/bin/ece-tools commands would not work if the size of the cloud.log file exceeded the PHP memory_limit. Instead of reading the entire cloud.log file into memory, we now only read a smaller subset of data from the log file.

Custom database connections—Fixed a .magento.env.yaml configuration issue in which custom database connections defined for DATABASE_CONFIGURATION were not used. The connection settings were not being added to app/etc/env.php.

Empty error logs—Fixed an issue that caused deployments to fail if the cloud.error.log was empty.

MariaDB 10.3 validation—Fixed validation of MariaDB 10.3 for Adobe Commerce 2.3.6-p1.

Cache:flush logging—Improved log entries to indicate the start and finish of the cache:flush step.

Added ECE-Tools support for the read-only pub/static directory when static content is set to deploy in the build stage.

Added support for Elasticsearch 7.9 and Redis 6 for compatibility with upcoming Adobe Commerce releases.

Updated the ECE-Tools composer.json to add a required dependency for the Quality Patches Tool. This fixes a circular dependency that existed between the ECE-Tools and magento-cloud-patches packages.

Added search-engine validation to ensure that elasticsearch is set for Adobe Commerce on cloud infrastructure 2.4 and later. If the validation fails, the deployment is stopped with a critical error message that suggests fixes for the issue. See Critical Errors, Deploy stage.

Added Elasticsearch validation to check the compatibility between the Elasticsearch service version and the Adobe Commerce version.

Updated the Elasticsearch compatibility error message to show the versions of Elasticsearch that are compatible with the Adobe Commerce Elasticsearch module. The error message now provides the specific Elasticsearch versions to install in your Cloud infrastructure so that it is compatible with the Elasticsearch module used by your version of Adobe Commerce. See Warning Errors, Deploy stage.

Added warning errors 2026 and 2027 for invalid MAGE_MODE environment variable setting. The only valid value is production. Before this fix, MAGE_MODE could be set to developer without deployment errors, only to cause errors later when trying to write to read-only files. See Warning Errors.

Fixed validation for Redis, RabbitMQ, and MySQL services to ensure that these versions are compatible with the Adobe Commerce version. Valid versions of these services are now written to the cloud.log.

Updated the cloud.log to include the concurrent requests limit for sending requests during cache warmup. This value is configured in the WARM_UP_CONCURRENCY post-deploy variable.

Added the schema.error.yaml file that includes all error and warning notifications that can occur during the build, deploy, and post-deploy process along with suggestions for resolving the errors. The information in this file is also available in the Cloud Guide for Commerce. See Error message reference for ece-tools.

Changed the Cloud error log (/var/log/cloud.error.log) entries to JSON format to make the log easier to parse programmatically.

Added additional error checks to build, deploy, and post-deploy processing and improved existing checks:

• Error code 2026—Failed to restore some data generated during the build phase to the mounted directories

• Error code 3004—Cannot create backup files

• Error code 102—Added additional checks for issues that occur when the env.php file is not writable

Added the QUALITY_PATCHES environment variable to specify one or more quality patches to apply during the deployment process. See Build variables.