Error message reference for ece-tools
This ece-tools error message reference provides information to troubleshoot errors that can occur during the Magento Commerce Cloud deployment process.
All error and warning messages generated during deployment are written to both the var/log/cloud.log
and /var/log/cloud.error.log
files. The Cloud error log file contains only errors and warnings from the latest deployment. An empty file indicates a successful deployment with no errors.
Error messages are categorized by deployment stage–build, deploy, and post-deploy. Each section provides a list of associated errors with the following information for each error:
- Error code: The Magento-assigned identifier for the error message
- Step: Indicates the step in the deployment scenario where the error can occur. If the Step column is blank, the error is a general error that can occur in multiple steps, or during pre-processing operations. See Scenario-based deployment for more information about the build, deploy, and post-deploy steps.
- Error description: A short phrase that summarizes the cause of the error
- Suggested action: Provides guidance to troubleshoot and resolve the error
Build stage
Error code | Build step | Error description | Suggested action |
---|---|---|---|
2 | Cannot write to the ./app/etc/env.php file |
Deployment script cannot make required changes to the /app/etc/env.php file. Check your filesystem permissions. |
|
3 | Configuration isn’t defined in the schema.yaml file |
Configuration isn’t defined in the ./vendor/magento/ece-tools/config/schema.yaml file. Check that the config variable name is correct, and that it defined. |
|
4 | Failed to parse the .magento.env.yaml file |
The ./.magento.env.yaml file format is invalid. Use a YAML parser to check the syntax and fix any errors. |
|
5 | Unable to read the .magento.env.yaml file |
Unable to read the ./.magento.env.yaml file. Check file permissions. |
|
6 | Unable to read the .schema.yaml file |
||
7 | refresh-modules | Cannot write to the ./app/etc/config.php file |
Deployment script cannot make required changes to the /app/etc/config.php file. Check your filesystem permissions. |
8 | validate-config | Cannot read the composer.json file |
Unable to read the ./composer.json file. Check file permissions. |
9 | validate-config | Composer.json is missing required autoload section | Required autoload section is missing from the composer.json file. Compare the autoload section from the Magento composer.json file template, and add the missing configuration. |
10 | validate-config | The file .magento.env.yaml contains an option which isn’t declared in the schema, or has an invalid value or stage |
The ./.magento.env.yaml file contains invalid configuration. Check the error log for detailed info. |
11 | refresh-modules | Command /bin/magento module:enable --all failed |
Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output. |
12 | apply-patches | Failed to apply patch | |
13 | set-report-dir-nesting-level | Cannot write to the file /pub/errors/local.xml |
|
14 | copy-sample-data | Failed to copy sample data files | |
15 | compile-di | Command /bin/magento setup:di:compile failed |
Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output. |
16 | dump-autoload | Command composer dump-autoload failed |
The composer dump-autoload command failed. Check the cloud.log for more information. |
17 | run-baler | The command to run Baler for Javascript bundling failed |
Check the SCD_USE_BALER environment variable to verify that the Baler module is configured and enabled for JS bundling. If you don’t need the Baler module, set SCD_USE_BALER: false . |
18 | compress-static-content | Required utility wasn’t found (timeout, bash) | |
19 | deploy-static-content | Command /bin/magento setup:static-content:deploy failed |
Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output. |
20 | compress-static-content | Static content compression failed | Check the cloud.log for more information. |
21 | backup-data: static-content | Failed to copy static content into the init directory |
Check the cloud.log for more information. |
22 | backup-data: writable-dirs | Failed to copy some writable directories into the init directory |
Failed to copy writable directories into the ./init folder. Check your filesystem permissions. |
23 | Unable to create a logger object | ||
24 | backup-data: static-content | Failed to clean the ./init/pub/static/ directory |
Failed to clean ./init/pub/static folder. Check your filesystem permissions. |
25 | Cannot find the Composer package | If you installed the Magento application version directly from the Magento git repository, verify that the DEPLOYED_MAGENTO_VERSION_FROM_GIT environment variable is configured. |
Deploy stage
Error code | Deploy step | Error description | Suggested action |
---|---|---|---|
101 | pre-deploy: cache | Incorrect cache configuration (missing port or host) | Cache configuration is missing required parameters server or port . Check the cloud.log for more information. |
102 | Cannot write to the ./app/etc/env.php file |
Deployment script cannot make required changes to the /app/etc/env.php file. Check your filesystem permissions. |
|
103 | Configuration isn’t defined in the schema.yaml file |
Configuration isn’t defined in the ./vendor/magento/ece-tools/config/schema.yaml file. Check that the config variable name is correct, and that it defined. |
|
104 | Failed to parse the .magento.env.yaml file |
Configuration isn’t defined in the ./vendor/magento/ece-tools/config/schema.yaml file. Check that the config variable name is correct, and that it defined. |
|
105 | Unable to read the .magento.env.yaml file |
Unable to read the ./.magento.env.yaml file. Check file permissions. |
|
106 | Unable to read the .schema.yaml file |
||
107 | pre-deploy: clean-redis-cache | Failed to clean the Redis cache | Failed to clean the Redis cache. Check that the Redis cache configuration is correct and that the Redis service is available. See Setup Redis service.. |
108 | pre-deploy: set-production-mode | Command /bin/magento maintenance:enable failed |
Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output. |
109 | validate-config | Incorrect database configuration | Check that the the DATABASE_CONFIGURATION environment variable is configured correctly. |
110 | validate-config | Incorrect session configuration | Check that the SESSION_CONFIGURATION environment variable is configured correctly. The configuration must contain at least the save parameter. |
111 | validate-config | Incorrect search configuration | Check that the SEARCH_CONFIGURATION environment variable is configured correctly.. The configuration must contain at least the engine parameter. |
112 | validate-config | Incorrect resource configuration | Check that the RESOURCE_CONFIGURATION environment variable is configured correctly. The configuration must contain at least connection parameter. |
113 | validate-config:elasticsuite-integrity | ElasticSuite is installed, but the ElasticSearch service is not available | ElasticSuite is installed, but the Elasticsearch service is not available. Check that the SEARCH_CONFIGURATION environment variable is configured correctly, and verify that the Elasticsearch service is available. |
114 | validate-config:elasticsuite-integrity | ElasticSuite is installed, but another search engine is used | ElasticSuite is installed but another search engine is configured. Update the SEARCH_CONFIGURATION environment variable to enable Elasticsearch and verify the Elasticsearch service configuration in the services.yaml file. |
115 | Database query execution failed | ||
116 | install-update: setup | Command /bin/magento setup:install failed |
Check the cloud.log and install_upgrade.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output. |
117 | install-update: config-import | Command app:config:import failed |
Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output. |
118 | Required utility wasn’t found (timeout, bash) | ||
119 | install-update: deploy-static-content | Command /bin/magento setup:static-content:deploy failed |
Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output. |
120 | compress-static-content | Static content compression failed | Check the cloud.log for more information. |
121 | deploy-static-content:generate | Cannot update the deployed version | Cannot update ./pub/static/deployed_version.txt file. Check your filesystem permissions. |
122 | clean-static-content | Failed to clean static content files | |
123 | install-update: split-db | Command /bin/magento setup:db-schema:split failed |
Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output. |
124 | clean-view-preprocessed | Failed to clean the var/view_preprocessed folder |
Unable to clean the ./var/view_preprocessed folder. Check your filesystem permissions. |
125 | install-update: reset-password | Failed to update the /var/credentials_email.txt file |
Failed to update the /var/credentials_email.txt file. Check your filesystem permissions. |
126 | install-update: update | Command /bin/magento setup:upgrade failed |
Check the cloud.log and install_upgrade.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output. |
127 | clean-cache | Command /bin/magento cache:flush failed |
Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output. |
128 | disable-maintenance-mode | Command /bin/magento maintenance:disable failed |
Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output. |
129 | install-update: reset-password | Enable to read reset password template | |
130 | install-update: cache_type | Command php ./bin/magento cache:enable failed. |
Command php ./bin/magento cache:enable runs only when Magento was installed but ./app/etc/env.php file was absent or empty at the beginning of the deployment. Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output. |
131 | install-update | The crypt/key key value does not exist in the ./app/etc/env.php file or the CRYPT_KEY cloud environment variable |
Post-deploy stage
Error code | Post-deploy step | Error description | Suggested action |
---|---|---|---|
201 | is-deploy-failed | Deploy stage failed | |
202 | The ./app/etc/env.php file is not writable |
Deployment script cannot make required changes to the /app/etc/env.php file. Check your filesystem permissions. |
|
203 | Configuration isn’t defined in the schema.yaml file |
Configuration isn’t defined in the ./vendor/magento/ece-tools/config/schema.yaml file. Check that the config variable name is correct, and that it defined. |
|
204 | Failed to parse the .magento.env.yaml file |
The ./.magento.env.yaml file format is invalid. Use a YAML parser to check the syntax and fix any errors. |
|
205 | Unable to read the .magento.env.yaml file |
Unable to read the ./.magento.env.yaml file. Check file permissions. |
|
206 | Unable to read the .schema.yaml file |
||
207 | warm-up | Failed to warm-up some pages | |
208 | time-to-firs-byte | Failed to test time to first byte (TTFB) | |
227 | clean-cache | Command /bin/magento cache:flush failed |
Check the cloud.log for more information. Add VERBOSE_COMMANDS: '-vvv' into .magento.env.yaml for more detailed command output. |