DocumentationCommerceGuide de Commerce sur les infrastructures cloud

Structure du projet

Last update: Wed Apr 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Admin
  • Developer

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. Reportez-vous aux modèles cloud basés sur la version d’Adobe Commerce dans la 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 au domaine apex et php application pour servir le protocole 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
La variable code est utilisé pour les modules personnalisés. La variable design Le dossier est utilisé pour thèmes personnalisés. La variable etc contient les fichiers de configuration de 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. La variable 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 magasins multiples et les sites qui utilisent 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 la variable .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.

  • Intégration de Starter et Pro: /app
  • Production de démarrage: /<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 : only répertoires 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 comporte une /tmp répertoire qui n’est pas partagé avec les autres noeuds.

Ignorer les fichiers

Il y a une base .gitignore avec Adobe Commerce dans le référentiel de projet d’infrastructure cloud. Consultez la dernière version fichier .gitignore dans le référentiel magento-cloud. Pour ajouter un fichier qui se trouve dans la variable .gitignore , vous pouvez utiliser la variable -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 composer.json avec les valeurs suivantes pour la variable extra .

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

  3. Ajoutez la variable .gitignore fichier conçu pour le modèle de base. Par exemple, si vous avez besoin de la variable .gitignore pour le modèle de version 2.2.6, utilisez la méthode .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, au cours duquel la fonction Commerce l’application 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