Skip to content

Commit 1b2e562

Browse files
committed
Update error codes
1 parent 84c9315 commit 1b2e562

File tree

2 files changed

+9
-1
lines changed

2 files changed

+9
-1
lines changed

dist/error-codes.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@
55
Critical errors indicate a problem with the Commerce on cloud infrastructure project configuration that causes deployment failure, for example incorrect, unsupported, or missing configuration for required settings. Before you can deploy, you must update the configuration to resolve these errors.
66

77
### Build stage
8+
89
| Error code | Build step | Error description (Title) | Suggested action |
910
| - | - | - | - |
1011
| 2 | | Can not write to the `./app/etc/env.php` file | Deployment script can not make required changes to the `/app/etc/env.php` file. Check your filesystem permissions. |
@@ -34,6 +35,7 @@ Critical errors indicate a problem with the Commerce on cloud infrastructure pro
3435
| 26 | validate-config | Remove Magento Braintree module configuration which is no longer supported in Adobe Commerce and Magento Open Source 2.4 and later versions. | Support for the Braintree module is no longer included with Magento 2.4.0 and later. Remove the CONFIG__STORES__DEFAULT__PAYMENT__BRAINTREE__CHANNEL variable from the variables section of the `.magento.app.yaml` file. For Braintree payment support, use an official extension from the Commerce Marketplace instead. |
3536

3637
### Deploy stage
38+
3739
| Error code | Deploy step | Error description (Title) | Suggested action |
3840
| - | - | - | - |
3941
| 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. |
@@ -77,6 +79,7 @@ Critical errors indicate a problem with the Commerce on cloud infrastructure pro
7779
| 139 | validate-config | Incorrect search engine | This Adobe Commerce or Magento Open Source version does not support OpenSearch. You must use versions 2.3.7-p3, 2.4.3-p2, or later |
7880

7981
### Post-deploy stage
82+
8083
| Error code | Post-deploy step | Error description (Title) | Suggested action |
8184
| - | - | - | - |
8285
| 201 | is-deploy-failed | Deploy stage failed | |
@@ -90,6 +93,7 @@ Critical errors indicate a problem with the Commerce on cloud infrastructure pro
9093
| 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. |
9194

9295
### General
96+
9397
| Error code | General step | Error description (Title) | Suggested action |
9498
| - | - | - | - |
9599
| 243 | | Configuration is not defined in the `schema.yaml` file | Check that the config variable name is correct, and that it defined. |
@@ -104,6 +108,7 @@ Critical errors indicate a problem with the Commerce on cloud infrastructure pro
104108
Warning errors indicate a problem with the Commerce on cloud infrastructure project configuration such as incorrect, deprecated, unsupported, or missing configuration settings for optional features that can affect site operation. Although a warning does not cause deployment failure, you should review warning messages and update the configuration to resolve them.
105109

106110
### Build stage
111+
107112
| Error code | Build step | Error description (Title) | Suggested action |
108113
| - | - | - | - |
109114
| 1001 | validate-config | File app/etc/config.php does not exist | |
@@ -115,6 +120,7 @@ Warning errors indicate a problem with the Commerce on cloud infrastructure proj
115120
| 1007 | run-baler | Baler JS bundling can not be used | |
116121

117122
### Deploy stage
123+
118124
| Error code | Deploy step | Error description (Title) | Suggested action |
119125
| - | - | - | - |
120126
| 2001 | pre-deploy:cache | Cache is configured for a Redis service that is not available. Configuration will be ignored. | |
@@ -149,6 +155,7 @@ Warning errors indicate a problem with the Commerce on cloud infrastructure proj
149155
| 2030 | validate-config | Elasticsearch and OpenSearch services are both installed at infrastructure layer. Adobe Commerce and Magento Open Source 2.4.4 and later use OpenSearch by default | Consider removing the Elasticsearch or OpenSearch service from the infrastructure layer to optimize resource usage. |
150156

151157
### Post-deploy stage
158+
152159
| Error code | Post-deploy step | Error description (Title) | Suggested action |
153160
| - | - | - | - |
154161
| 3001 | validate-config | Debug logging is enabled in Adobe Commerce | To save disk space, do not enable debug logging for your production environments. |
@@ -157,6 +164,7 @@ Warning errors indicate a problem with the Commerce on cloud infrastructure proj
157164
| 3004 | backup | Can not create backup files | |
158165

159166
### General
167+
160168
| Error code | General step | Error description (Title) | Suggested action |
161169
| - | - | - | - |
162170
| 4001 | | Can not get system processor count: | |

src/Command/Dev/GenerateSchemaError.php

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -116,7 +116,7 @@ private function generateDocs(array $errors): string
116116
$result .= sprintf("\n### %s%s\n", ucfirst($stage), $stage === 'general' ? '' : ' stage');
117117

118118
$table = sprintf(
119-
"| Error code | %s step | Error description (Title) | Suggested action |\n",
119+
"\n| Error code | %s step | Error description (Title) | Suggested action |\n",
120120
ucfirst($stage)
121121
);
122122
$table .= "| - | - | - | - |\n";

0 commit comments

Comments
 (0)