DokumentationCommerceHandbuch zu Commerce mit Cloud Infrastructure

Projektstruktur

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

Erstellt für:

  • Admin
  • Developer

Ein Adobe Commerce-Projekt zur Cloud-Infrastruktur umfasst wichtige Dateien für Anmeldedaten und die Anwendungskonfiguration. Diese Dateien sind je nach Adobe Commerce-Version als Vorlage verfügbar. Siehe Cloud-Vorlagen, die auf der Adobe Commerce-Version basieren im magento/magento-cloud GitHub-Repository.

In der folgenden Tabelle werden die in einem Cloud-Projekt enthaltenen Dateien beschrieben:

Datei
Beschreibung
/.magento/routes.yaml
Konfigurationsdatei, die umleitet www zur Apex-Domäne und php -Anwendung zur Bereitstellung von HTTP. Siehe Routen konfigurieren.
/.magento/services.yaml
Eine Konfigurationsdatei, die eine MySQL-Instanz (MariaDB), Redis, OpenSearch oder Elasticsearch definiert. Siehe Dienste konfigurieren.
/app
Die code -Ordner wird für benutzerdefinierte Module verwendet. Die design Ordner wird verwendet für benutzerdefinierte Designs. Die etc -Ordner enthält Konfigurationsdateien für die Anwendung.
/m2-hotfixes
Wird für benutzerdefinierte Patches verwendet.
/update
Ein vom Support-Modul verwendeter Dienstordner.
.gitignore
Geben Sie an, welche Dateien und Ordner ignoriert werden sollen. Siehe .gitignore reference.
.magento.app.yaml
Eine Konfigurationsdatei, die die Eigenschaften zum Erstellen der Anwendung definiert. Siehe Anwendung konfigurieren.
.magento.env.yaml
Konfigurationsdatei für die Build-, Bereitstellungs- und Postbereitstellungsphasen. Die ece-tools -Paket enthält ein Beispiel dieser Datei. Siehe Umgebungen konfigurieren.
composer.json
Ruft Adobe Commerce und die Konfigurationsskripte ab, um Ihre Anwendung vorzubereiten. Siehe Erforderliche Pakete.
composer.lock
Speichert Versionsabhängigkeiten für jedes Paket. Siehe Erforderliche Pakete.
magento-vars.php
Zur Definition mehrere Stores und Sites, die Variablen verwenden.
NOTE
Wenn Sie Ihre lokalen Änderungen auf den Remote-Server übertragen, verwendet das Bereitstellungsskript die Werte, die von den Konfigurationsdateien im .magento und löscht dann das Skript das Verzeichnis und dessen Inhalt. Ihre lokale Entwicklungsumgebung ist nicht betroffen.

Stammordner der Anwendung

Der Speicherort des Stammordners der Anwendung hängt von der Umgebung ab.

  • Starter- und Pro-Integration: /app
  • Starterproduktion: /<project-ID>
  • Pro Staging: /<project-ID>_stg
  • Pro Produktion: /<project-ID>

Schreibgeschützte Verzeichnisse

Die Remote-Umgebungen für Integration, Staging und Produktion sind schreibgeschützt. Die folgenden Verzeichnisse sind only Schreibbare Verzeichnisse aus Sicherheitsgründen:

  • var
  • pub/static
  • pub/media
  • app/etc
  • /tmp
NOTE
In Produktions- und Staging-Umgebungen verfügt jeder Knoten im Cluster mit drei Knoten über eine /tmp Verzeichnis, das nicht für die anderen Knoten freigegeben ist.

Dateien ignorieren

Es gibt eine Basis .gitignore Datei mit Adobe Commerce im Projekt-Repository der Cloud-Infrastruktur. Aktuelle Informationen anzeigen .gitignore-Datei im magento-cloud-Repository. So fügen Sie eine Datei hinzu, die sich im .gitignore -Liste verwenden, können Sie die -f (erzwungene) Option beim Staging eines Commit:

git add <path/filename> -f

Basisvorlage ändern

Sie können die folgenden Schritte ausführen, um die Struktur eines vorhandenen Projekts zu ändern und die neueste Basisvorlage für Adobe Commerce in der Cloud-Infrastruktur widerzuspiegeln.

  1. Klonen Sie das Projekt auf einer lokalen Workstation.

  2. Aktualisieren Sie die composer.json mit den folgenden Werten für die extra Abschnitt.

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

  3. Fügen Sie die .gitignore Datei, die für die Basisvorlage entwickelt wurde. Wenn Sie beispielsweise die .gitignore -Datei für die Vorlage Version 2.2.6 verwenden Sie die .gitignore für 2.2.6 -Datei als Referenz.

  4. Löschen Sie den Git-Cache.

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

  5. Fügen Sie Änderungen hinzu und übertragen Sie sie.

    code language-bash 
    git add -A && git commit -m "Update base template"
WARNING
Der Bereitstellungsprozess beginnt, wenn Sie eine Zusammenführung, Push-Benachrichtigung oder Synchronisation Ihrer Umgebung durchführen oder wenn Sie eine manuelle Neuimplementierung Trigger haben, während der die Commerce Die Anwendung befindet sich im Wartungsmodus. Für eine Produktionsumgebung empfiehlt Adobe, diese Arbeit außerhalb der Spitzenzeiten abzuschließen, um Dienstunterbrechungen zu vermeiden.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26