DocumentationCommerceGuide de Commerce sur les infrastructures cloud

Structure du projet

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Administration
  • Développeur

Un projet Adobe Commerce sur l’infrastructure cloud comprend des fichiers essentiels pour la configuration des informations d’identification et des applications. Ces fichiers sont disponibles dans en tant que modèle en fonction de la version d’Adobe Commerce. Voir les modèles cloud basés sur la version Adobe Commerce dans le magento/magento-cloud référentiel GitHub.

Le tableau suivant décrit les fichiers inclus dans un projet cloud :

Fichier
Description
/.magento/routes.yaml
Fichier de configuration qui redirige www vers le domaine d’expression et l’application php vers le service HTTP. Voir Configuration des itinéraires.
/.magento/services.yaml
Fichier de configuration qui définit une instance MySQL (MariaDB), Redis et OpenSearch ou Elasticsearch. Voir Configuration des services.
/app
Le dossier code est utilisé pour les modules personnalisés. Le dossier design est utilisé pour les thèmes personnalisés. Le dossier etc contient des fichiers de configuration pour l’application.
/m2-hotfixes
Utilisé pour les correctifs personnalisés.
/update
Dossier de service utilisé par le module de support.
.gitignore
Spécifiez les fichiers et répertoires à ignorer. Voir .gitignore reference.
.magento.app.yaml
Fichier de configuration qui définit les propriétés à utiliser pour créer votre application. Voir Configuration de l’application.
.magento.env.yaml
Fichier de configuration pour les phases de création, de déploiement et de post-déploiement. Le package ece-tools comprend un exemple de ce fichier. Voir Configuration des environnements.
composer.json
Récupère Adobe Commerce et les scripts de configuration pour préparer votre application. Voir Packages requis.
composer.lock
Stocke les dépendances de version pour chaque module. Voir Packages requis.
magento-vars.php
Utilisé pour définir plusieurs magasins et des sites utilisant des variables.
NOTE
Lorsque vous envoyez vos modifications locales au serveur distant, le script de déploiement utilise les valeurs définies par les fichiers de configuration dans le répertoire .magento, puis le script supprime le répertoire et son contenu. Votre environnement de développement local n’est pas affecté.

Répertoire racine de l’application

L’emplacement du répertoire racine de l’application dépend de l’environnement.

  • Starter and Pro Integration : /app
  • Starter Production : /<project-ID>
  • Pro Staging : /<project-ID>_stg
  • Pro Production : /<project-ID>

Répertoires accessibles en écriture

Les environnements d’intégration, d’évaluation et de production distants sont en lecture seule. Les répertoires suivants sont les répertoires only modifiables pour des raisons de sécurité :

  • var
  • pub/static
  • pub/media
  • app/etc
  • /tmp
NOTE
Dans les environnements de production et d’évaluation, chaque noeud de la grappe à trois noeuds possède un répertoire /tmp qui n’est pas partagé avec les autres noeuds.

Ignorer les fichiers

Il existe un fichier de base .gitignore avec le référentiel de projet Adobe Commerce on cloud infrastructure. Voir le dernier fichier .gitignore dans le référentiel magento-cloud. Pour ajouter un fichier qui se trouve dans la liste .gitignore, vous pouvez utiliser l’option -f (force) lors de l’évaluation d’une validation :

git add <path/filename> -f

Modifier le modèle de base

Vous pouvez utiliser les étapes suivantes pour modifier la structure d’un projet existant afin de refléter le dernier modèle de base pour Adobe Commerce sur l’infrastructure cloud.

  1. Cloner le projet vers un poste de travail local.

  2. Mettez à jour le fichier composer.json avec les valeurs suivantes pour la section extra.

    code language-json 
    "extra": {
    "magento-force": true
    "magento-deploystrategy": "copy"
}

  3. Ajoutez le fichier .gitignore conçu pour le modèle de base. Par exemple, si vous avez besoin du fichier .gitignore pour le modèle version 2.2.6, utilisez le fichier .gitignore pour 2.2.6 comme référence.

  4. Effacez le cache git.

    code language-bash 
    git rm -r --cached .

  5. Ajoutez et validez les modifications.

    code language-bash 
    git add -A && git commit -m "Update base template"
WARNING
Le processus de déploiement commence lorsque vous effectuez une fusion, une notification push ou une synchronisation de votre environnement, ou lorsque vous déclenchez un redéploiement manuel, pendant lequel l’application Commerce est en mode de maintenance. Pour un environnement de production, Adobe recommande d’effectuer ce travail aux heures creuses afin d’éviter les interruptions de service.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26