DokumentationCommerceHandbuch zu Commerce mit Cloud Infrastructure

Projektstruktur

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

Erstellt für:

  • Admin
  • Entwickler

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 www zur Apex-Domäne und php Anwendung zur Bereitstellung von HTTP umleitet. Siehe Routen konfigurieren.
/.magento/services.yaml
Eine Konfigurationsdatei, die eine MySQL-Instanz (MariaDB), Redis, OpenSearch oder Elasticsearch definiert. Siehe Konfigurieren von Diensten.
/app
Der Ordner code wird für benutzerdefinierte Module verwendet. Der Ordner design wird für benutzerdefinierte Designs verwendet. Der Ordner "etc" 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. Das Paket ece-tools 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
Wird verwendet, um mehrere Stores und Sites mithilfe von Variablen zu definieren.
NOTE
Wenn Sie Ihre lokalen Änderungen auf den Remote-Server übertragen, verwendet das Bereitstellungsskript die Werte, die von den Konfigurationsdateien im Ordner ".magento"definiert wurden, und dann löscht das Skript den Ordner 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 and Pro Integration: /app
  • Starterproduktion: /<project-ID>
  • Pro Staging: /<project-ID>_stg
  • Pro Production: /<project-ID>

Schreibgeschützte Verzeichnisse

Die Remote-Umgebungen für Integration, Staging und Produktion sind schreibgeschützt. Die folgenden Verzeichnisse sind aus Sicherheitsgründen die Nur beschreibbaren Ordner:

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

Dateien ignorieren

Es gibt eine Basisdatei mit dem Adobe Commerce für das Projekt-Repository der Cloud-Infrastruktur mit dem Namen .gitignore . Siehe die neueste Datei .gitignore im Magento-Cloud-Repository. Um eine Datei hinzuzufügen, die sich in der Liste .gitignore befindet, können Sie beim Staging eines Commit die Option -f (erzwingen) verwenden:

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 Datei "composer.json"mit den folgenden Werten für den Abschnitt "extra".

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

  3. Fügen Sie die für die Basisvorlage entworfene Datei .gitignore hinzu. Wenn Sie beispielsweise die Datei .gitignore für die Vorlage Version 2.2.6 benötigen, verwenden Sie die Datei .gitignore für 2.2.6 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 sich die Commerce -Anwendung im Wartungsmodus befindet. 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