Messages d'erreur pour ECE-Tools
Cette référence de message d’erreur fournit des informations permettant de résoudre les erreurs qui peuvent se produire pendant les processus de création, de déploiement et de post-déploiement d’Adobe Commerce sur l’infrastructure cloud.
Tous les messages d’erreur critiques et d’avertissement qui se produisent pendant le déploiement sont écrits dans les fichiers var/log/cloud.log
et /var/log/cloud.error.log
. Le fichier journal des erreurs cloud contient uniquement les erreurs du dernier déploiement. Un fichier vide indique un déploiement réussi sans erreur.
Dans le fichier cloud.error.log
, chaque entrée est formatée sous la forme d’une chaîne JSON pour une analyse plus facile :
{"errorCode":1006,"stage":"build","step":"validate-config","suggestion":"No stores/website/locales found in config.php\n To speed up the deploy process do the following:\n 1. Using SSH, log in to your Magento Cloud account\n 2. Run \"php ./vendor/bin/ece-tools config:dump\"\n 3. Using SCP, copy the app/etc/config.php file to your local repository\n 4. Add, commit, and push your changes to the app/etc/config.php file","title":"The configured state is not ideal","type":"warning"}
Les messages d’erreur sont classés par l’une des étapes de déploiement : version, déploiement et post-déploiement. Chaque section fournit une liste des erreurs associées avec les informations suivantes pour chaque erreur :
- Code d’erreur : identifiant attribué par Adobe Commerce au message d’erreur
- Phase : indique si l’erreur s’est produite lors de l’étape de création, de déploiement ou de post-déploiement
- Étape : indique l’étape du scénario de déploiement qui peut renvoyer l’erreur. Si la colonne Étape est vide, l’erreur est une erreur générale qui peut être renvoyée par plusieurs étapes ou lors d’opérations de prétraitement. Voir Déploiement basé sur un scénario pour plus d’informations sur les étapes de création, de déploiement et de post-déploiement.
- Suggestion : fournit des conseils pour dépanner et résoudre l’erreur
- Titre (description de l’erreur) : description qui résume la cause de l’erreur
- Type : indique si l’erreur est une erreur critique ou un avertissement
Erreurs critiques
Les erreurs critiques indiquent un problème de configuration du projet Commerce sur l’infrastructure cloud qui provoque l’échec du déploiement, par exemple une configuration incorrecte, non prise en charge ou manquante pour les paramètres requis. Avant de pouvoir effectuer un déploiement, vous devez mettre à jour la configuration pour résoudre ces erreurs.
Étape de création
./app/etc/env.php
/app/etc/env.php
. Vérifiez les autorisations de votre système de fichiers.schema.yaml
./vendor/magento/ece-tools/config/schema.yaml
. Vérifiez que le nom de la variable de configuration est correct et défini..magento.env.yaml
./.magento.env.yaml
n'est pas valide. Utilisez un analyseur YAML pour vérifier la syntaxe et corriger les erreurs..magento.env.yaml
./.magento.env.yaml
. Vérifiez les autorisations de fichier..schema.yaml
./vendor/magento/ece-tools/config/magento.env.yaml
. Vérifiez les autorisations de fichier et redéployez (magento-cloud environment:redeploy
)../app/etc/config.php
/app/etc/config.php
. Vérifiez les autorisations de votre système de fichiers.composer.json
./composer.json
. Vérifiez les autorisations de fichier.composer.json
ne contient pas la section de chargement automatique requiseautoload
obligatoire est manquante dans le fichier composer.json
. Comparez la section de chargement automatique au fichier composer.json
dans le modèle cloud et ajoutez la configuration manquante..magento.env.yaml
contient une option qui n’est pas déclarée dans le schéma, ou une option configurée avec une valeur ou une étape non valide./.magento.env.yaml
contient une configuration non valide. Consultez le journal des erreurs pour obtenir des informations détaillées./bin/magento module:enable --all
composer update
localement. Ensuite, validez et envoyez le fichier composer.lock
mis à jour. Vérifiez également le cloud.log
pour plus d’informations. Pour une sortie de commande plus détaillée, ajoutez l’option VERBOSE_COMMANDS: '-vvv'
au fichier .magento.env.yaml
./pub/errors/local.xml
/bin/magento setup:di:compile
cloud.log
. Ajoutez VERBOSE_COMMANDS: '-vvv'
dans .magento.env.yaml
pour une sortie de commande plus détaillée.composer dump-autoload
composer dump-autoload
a échoué. Pour plus d’informations, consultez la cloud.log
.Baler
pour le regroupement JavaScriptSCD_USE_BALER
pour vous assurer que le module Baler est configuré et activé pour le regroupement JS. Si vous n’avez pas besoin du module Baler, définissez SCD_USE_BALER: false
./bin/magento setup:static-content:deploy
de commandecloud.log
. Pour une sortie de commande plus détaillée, ajoutez l’option VERBOSE_COMMANDS: '-vvv'
au fichier .magento.env.yaml
.cloud.log
.init
cloud.log
.init
./init
. Vérifiez les autorisations de votre système de fichiers../init/pub/static/
./init/pub/static
. Vérifiez les autorisations de votre système de fichiers.DEPLOYED_MAGENTO_VERSION_FROM_GIT
est configurée..magento.app.yaml
. Pour l’assistance au paiement par Braintree, utilisez plutôt une extension officielle du Commerce Marketplace .Étape de déploiement
server
ou port
à la configuration du cache. Pour plus d’informations, consultez la cloud.log
../app/etc/env.php
/app/etc/env.php
. Vérifiez les autorisations de votre système de fichiers.schema.yaml
./vendor/magento/ece-tools/config/schema.yaml
. Vérifiez que le nom de la variable de configuration est correct et qu'il est défini..magento.env.yaml
./vendor/magento/ece-tools/config/schema.yaml
. Vérifiez que le nom de la variable de configuration est correct et qu'il est défini..magento.env.yaml
./.magento.env.yaml
. Vérifiez les autorisations de fichier..schema.yaml
/bin/magento maintenance:enable
de commandecloud.log
. Pour une sortie de commande plus détaillée, ajoutez l’option VERBOSE_COMMANDS: '-vvv'
au fichier .magento.env.yaml
.DATABASE_CONFIGURATION
est correctement configurée.SESSION_CONFIGURATION
est correctement configurée. La configuration doit contenir au moins le paramètre save
.SEARCH_CONFIGURATION
est correctement configurée. La configuration doit contenir au moins le paramètre engine
.RESOURCE_CONFIGURATION
est correctement configurée. La configuration doit contenir au moins connection
paramètre.SEARCH_CONFIGURATION
est configurée correctement et que le service Elasticsearch est disponible.SEARCH_CONFIGURATION
pour activer l’Elasticsearch et vérifiez la configuration du service Elasticsearch dans le fichier services.yaml
./bin/magento setup:install
de commandecloud.log
et install_upgrade.log
. Pour une sortie de commande plus détaillée, ajoutez l’option VERBOSE_COMMANDS: '-vvv'
au fichier .magento.env.yaml
.app:config:import
de commandecloud.log
. Pour une sortie de commande plus détaillée, ajoutez l’option VERBOSE_COMMANDS: '-vvv'
au fichier .magento.env.yaml
./bin/magento setup:static-content:deploy
de commandecloud.log
. Pour une sortie de commande plus détaillée, ajoutez l’option VERBOSE_COMMANDS: '-vvv'
au fichier .magento.env.yaml
.cloud.log
../pub/static/deployed_version.txt
. Vérifiez les autorisations de votre système de fichiers./bin/magento setup:db-schema:split
de commandecloud.log
. Pour une sortie de commande plus détaillée, ajoutez l’option VERBOSE_COMMANDS: '-vvv'
au fichier .magento.env.yaml
.var/view_preprocessed
./var/view_preprocessed
. Vérifiez les autorisations de votre système de fichiers./var/credentials_email.txt
/var/credentials_email.txt
. Vérifiez les autorisations de votre système de fichiers./bin/magento setup:upgrade
de commandecloud.log
et install_upgrade.log
. Pour une sortie de commande plus détaillée, ajoutez l’option VERBOSE_COMMANDS: '-vvv'
au fichier .magento.env.yaml
./bin/magento cache:flush
de commandecloud.log
. Pour une sortie de commande plus détaillée, ajoutez l’option VERBOSE_COMMANDS: '-vvv'
au fichier .magento.env.yaml
./bin/magento maintenance:disable
de commandecloud.log
. Ajoutez VERBOSE_COMMANDS: '-vvv'
dans .magento.env.yaml
pour une sortie de commande plus détaillée.php ./bin/magento cache:enable
php ./bin/magento cache:enable
s’exécute uniquement lors de l’installation d’Adobe Commerce, mais ./app/etc/env.php
fichier était absent ou vide au début du déploiement. Pour plus d’informations, consultez la cloud.log
. Ajoutez VERBOSE_COMMANDS: '-vvv'
dans .magento.env.yaml
pour une sortie de commande plus détaillée.crypt/key
n’existe pas dans le fichier ./app/etc/env.php
ou la variable d’environnement cloud CRYPT_KEY
./app/etc/env.php
n’est pas présent au début du déploiement d’Adobe Commerce ou si la valeur crypt/key
est indéfinie. Si vous avez migré la base de données à partir d’un autre environnement, récupérez la valeur de la clé de chiffrement de cet environnement. Ajoutez ensuite la valeur à la variable d’environnement cloud CRYPT_KEY dans votre environnement actuel. Voir Clé de chiffrement Adobe Commerce. Si vous avez supprimé le fichier ./app/etc/env.php
par erreur, utilisez la commande suivante pour le restaurer à partir des fichiers de sauvegarde créés à partir d’un déploiement précédent : ./vendor/bin/ece-tools backup:restore
la commande de l’interface de ligne de commande ..magento.app.yaml
. Pour la prise en charge des Braintree, utilisez plutôt une extension Braintree Payments officielle du Commerce Marketplace .engine
. S’il est configuré, supprimez l’option ou définissez la valeur sur « elasticsearch ».Étape de post-déploiement
./app/etc/env.php
n'est pas accessible en écriture/app/etc/env.php
. Vérifiez les autorisations de votre système de fichiers.schema.yaml
./vendor/magento/ece-tools/config/schema.yaml
. Vérifiez que le nom de la variable de configuration est correct et qu'il est défini..magento.env.yaml
./.magento.env.yaml
n'est pas valide. Utilisez un analyseur YAML pour vérifier la syntaxe et corriger les erreurs..magento.env.yaml
.schema.yaml
/bin/magento cache:flush
de commandecloud.log
. Ajoutez VERBOSE_COMMANDS: '-vvv'
dans .magento.env.yaml
pour une sortie de commande plus détaillée.Général
schema.yaml
.magento.env.yaml
./.magento.env.yaml
n'est pas valide. Utilisez un analyseur YAML pour vérifier la syntaxe et corriger les erreurs..magento.env.yaml
./.magento.env.yaml
. Vérifiez les autorisations de fichier..schema.yaml
cloud.log
.cloud.log
.cloud.log
.cloud.log
.Erreurs d’avertissement
Les erreurs d’avertissement indiquent un problème de configuration du projet Commerce sur l’infrastructure cloud, tel que des paramètres de configuration incorrects, obsolètes, non pris en charge ou manquants pour les fonctionnalités facultatives pouvant affecter le fonctionnement du site. Bien qu’un avertissement ne provoque pas d’échec de déploiement, vous devez consulter les messages d’avertissement et mettre à jour la configuration pour les résoudre.
Étape de création
Étape de déploiement
bin/magento admin:user:create
.app/etc/env.php
était manquant ou vide.cloud.log
.