Workflow für Starterprojekte

Die Adobe Commerce-Cloud-Infrastruktur umfasst ein einzelnes Git-Repository mit einer master -Verzweigung für die Produktionsumgebung, die verzweigt werden kann, um eine Staging- und mehrere Integrationsumgebungen für Test- und Entwicklungsarbeiten zu erstellen. Sie können über bis zu vier aktive Umgebungen verfügen, darunter eine master -Umgebung für Ihren Produktionsserver. Eine Übersicht finden Sie unter Starterarchitektur .

Folgen Sie für Ihre Umgebungen dem Workflow Development > Staging > Production , um Ihre Site zu entwickeln und bereitzustellen.

  • Produktionsumgebung (Live-Site): Bietet eine vollständige Produktionsumgebung mit allen Diensten, die aus dem Code in der master-Verzweigung erstellt und bereitgestellt werden.
  • Staging-Umgebung: Bietet eine vollständige Staging-Umgebung, die die Produktionsumgebung mit allen Diensten abgleicht, die aus einer staging -Verzweigung erstellt und bereitgestellt werden, die Sie durch Klonen aus master erstellen.
  • Integrationsumgebungen: Stellt bis zu zwei aktive Entwicklungsumgebungen bereit, die Sie aus der staging -Verzweigung erstellen. Die Umgebung integration unterstützt keine Drittanbieterdienste wie Fastly und New Relic.

Für Ihre Zweige können Sie jede Entwicklungsmethode anwenden. Beispielsweise können Sie einer Agile-Methode wie dem Scrubbing folgen, um für jeden Sprint Zweige zu erstellen.

Von jedem Sprint aus können Sie für jede Benutzergeschichte Zweige erstellen. Alle Geschichten werden prüfbar. Sie können kontinuierlich mit der Sprint-Verzweigung zusammenführen und diese Verzweigung kontinuierlich überprüfen. Wenn der Sprint endet, können Sie den Sprint-Zweig mit master zusammenführen, um alle Sprint-Änderungen in der Produktion durchzuführen, ohne einen Prüffehler beheben zu müssen.

Entwicklungs-Workflow

Die Entwicklung und Implementierung von Starter-Plänen beginnt mit Ihrem ursprünglichen Projekt. Sie erstellen Ihr Projekt mit der "leeren Site", einem Adobe Commerce-Code-Repository für Cloud-Infrastrukturvorlagen mit vollständig vorbereitetem Speicher. Dadurch wird eine master -Verzweigung mit einer Kopie des Codes aus Ihrer Produktionsumgebung erstellt.

Der Entwicklungs-Workflow umfasst Folgendes:

Workflow Entwickeln und bereitstellen

Sie haben auch einige optionale Schritte, die Sie bei der Entwicklung und dem Testen Ihres Codes und Ihrer Store-Daten unterstützen:

Bei diesem Vorgang wird davon ausgegangen, dass Sie Ihren lokalen Entwicklerarbeitsbereich eingerichtet haben.

Klonen und Verzweigung

Bei einem neuen Starter-Planprojekt wurde eine master -Verzweigung aus der Adobe Commerce im Git-Repository der Cloud-Infrastruktur geklont. Um mit der Verzweigung zu beginnen und mit Code zu arbeiten, klonen Sie die Verzweigung master in Ihre lokale Umgebung.

Das Format des Git-Klon-Befehls lautet:

git fetch origin
git pull origin <environment-ID>

Wenn Sie das erste Mal mit der Arbeit in Zweigen für Ihr Starter-Projekt beginnen, erstellen Sie eine staging -Verzweigung. Dadurch wird eine Codeverzweigung erstellt, die mit der master -Verzweigung übereinstimmt, die in einer Staging-Umgebung bereitgestellt wird, um Konfigurations- und Codeänderungen vor der Bereitstellung in der Produktionsumgebung zu testen.

Erstellen Sie als Nächstes Zweige von staging , um Code zu entwickeln, Erweiterungen hinzuzufügen und Drittanbieter-Integrationen zu konfigurieren. Jedes Mal, wenn Sie benutzerdefinierten Code entwickeln, fügen Sie Erweiterungen hinzu, integrieren Sie in einen Drittanbieterdienst und arbeiten Sie in einer Entwicklungsverzweigung, die aus der staging -Verzweigung erstellt wurde. Es stehen vier aktive Integrationsumgebungen zur Verfügung. Wenn Sie eine aktive Verzweigung per Push bereitstellen, stellt eine dieser Integrationsumgebungen den Code zum Testen automatisch bereit.

Das Format des Befehls der Git-Verzweigung lautet:

git checkout <branch-name>

Das Format des Befehls Cloud CLI branch lautet:

magento-cloud environment:branch <environment-name> <parent-environment-ID>

Verzweigung vom Master

Code entwickeln

Mithilfe der Basisverzweigung von Adobe Commerce im Cloud-Infrastrukturcode können Sie mit der Installation von Erweiterungen, der Entwicklung von benutzerdefiniertem Code, dem Hinzufügen von Designs und vielem mehr beginnen.

Verwenden Sie eine Verzweigungsstrategie für Ihre Entwicklungsarbeit. Die Verwendung einer Verzweigung, um all Ihre Arbeit auf einmal zu erledigen, kann Tests erschweren. Sie können beispielsweise kontinuierliche Integration und Sprint-Methoden anwenden, um zu funktionieren:

  • Fügen Sie einige Erweiterungen hinzu und konfigurieren Sie sie mit Ihrer ersten Verzweigung
  • Push diesen Code, test und merge an Staging, dann Production
  • Vollständige Konfiguration Ihrer Dienste in services.yaml und Hinzufügen eines Designs
  • Push diesen Code, test und merge an Staging, dann Production
  • Integration mit einem Drittanbieterdienst
  • Push diesen Code, test und merge an Staging, dann Production

Bis Ihr Store vollständig erstellt, konfiguriert und startbereit ist. Aber lesen Sie weiter, es gibt viele Optionen für Ihre Store- und Code-Konfiguration.

NOTE
Schließen Sie noch keine Konfigurationen in Ihrer lokalen Workstation ab.

Push-Code von lokal

Store konfigurieren

Wenn Sie bereit sind, Ihren Store zu konfigurieren, pushen Sie den gesamten Code in die integration -Umgebung. Konfigurieren Sie Ihre Speichereinstellungen über den Administrator für die Integrationsumgebung und nicht in Ihrer lokalen Umgebung. Sie können die URL finden, indem Sie auf Aufrufseite in der Cloud Console klicken.

Die besten Informationen zu Konfigurationen finden Sie in der Dokumentation zu Adobe Commerce und den installierten Erweiterungen. Im Folgenden finden Sie einige Links und Ideen, die Ihnen bei den ersten Schritten helfen:

  • Best Practices für die Store-Konfiguration für bestimmte Best Practices in der Cloud
  • Grundlegende Konfiguration für den Store-Administratorzugriff, Namen, Sprachen, Währungen, Branding, Sites, Store-Ansichten und mehr
  • Design für Ihr Erscheinungsbild der Site und Stores, einschließlich CSS und Layouts
  • Systemkonfiguration für Rollen, Tools, Benachrichtigungen und Ihren Verschlüsselungsschlüssel für Ihre Datenbank
  • Erweiterungseinstellungen anhand der Dokumentation

Neben den Speichereinstellungen können Sie auch mehrere Sites und Stores, konfigurierte Dienste und mehr konfigurieren. Siehe Konfigurieren des Stores.

Konfigurationsverwaltungsdateien generieren

Wenn Sie mit Adobe Commerce vertraut sind, können Sie sich darüber Gedanken machen, wie Sie Ihre Konfigurationseinstellungen aus Ihrer Datenbank in die Staging- und Produktionsumgebungen übernehmen können. Zuvor mussten Sie alle Konfigurationseinstellungen auf Papier oder in eine Datei kopieren und dann die Einstellungen manuell auf andere Umgebungen anwenden. Oder Sie haben Ihre Datenbank möglicherweise verlassen und diese Daten in eine andere Umgebung übertragen.

Adobe Commerce in der Cloud-Infrastruktur bietet zwei Konfigurationsmanagement -Befehle, mit denen Konfigurationseinstellungen aus Ihrer Umgebung in eine Datei exportiert werden. Diese Befehle stehen nur für Adobe Commerce in der Cloud-Infrastruktur 2.2 und höher zur Verfügung.

  • php .vendor/bin/ece-tools config:dump - Exportiert nur die Konfigurationseinstellungen, die Sie eingegeben oder von den Standardeinstellungen geändert haben, in eine Konfigurationsdatei. Empfohlen.
  • php bin/magento app:config:dump - Exportiert alle Konfigurationseinstellungen, einschließlich der geänderten und standardmäßigen, in eine Konfigurationsdatei.

Die generierte Datei ist app/etc/config.php.

Generieren Sie die Datei in der Integrationsumgebung, in der Sie Adobe Commerce konfiguriert haben. Führen Sie die Schritte zum Generieren der Datei, Hinzufügen zu Ihrer Verzweigung und Bereitstellen der Datei durch.

Wichtige Hinweise zur Konfigurationsverwaltung:

  • Jede Konfigurationseinstellung, die in der über den Befehl app:config:dump generierten Datei enthalten ist, ist in der bereitgestellten Umgebung nicht bearbeitbar oder schreibgeschützt. Dies ist ein Grund, warum Adobe die Verwendung des Befehls .vendor/bin/ece-tools config:dump empfiehlt.

    Sie installieren beispielsweise ein Modul für Fastly in Ihrer Entwicklungsumgebung. Sie können dieses Modul nur in der Staging- und Produktionsumgebung konfigurieren. Mit dem Befehl .vendor/bin/ece-tools config:dump können diese Standardfelder bearbeitet werden, wenn Sie Ihre Entwicklungsänderungen in der Staging- und Produktionsumgebung bereitstellen.

  • Die generierte Datei kann abhängig von der Größe Ihrer Implementierung lang sein. Der Befehl .vendor/bin/ece-tools config:dump generiert eine kleinere Datei als die vom Befehl app:config:dump generierte Datei.

Wenn Sie Adobe Commerce Version 2.2 oder höher verwenden, bieten die Konfigurationsverwaltungsbefehle eine zusätzliche Funktion zum Schutz vertraulicher Daten, wie Sandbox-Anmeldeinformationen für ein PayPal-Modul. Während des Exportvorgangs werden alle Werte, die vertrauliche Daten enthalten, in eine separate Konfigurationsdatei exportiert, nämlich env.php im Verzeichnis app/etc/. Diese Datei verbleibt in Ihrer lokalen Umgebung und wird nicht kopiert, wenn Sie Ihren Code in eine andere Verzweigung übertragen. Sie können in allen Adobe Commerce-Versionen der Cloud-Infrastruktur auch Umgebungsvariablen mit CLI-Befehlen erstellen.

Umgebungsvariablen generieren

Siehe Konfigurationsverwaltung.

Push-Code und -Test

An dieser Stelle sollte eine entwickelte Codeverzweigung mit einer Konfigurationsdatei (config.local.php oder config.php) vorhanden sein, die getestet werden kann.

Jedes Mal, wenn Sie Code aus Ihrer lokalen Umgebung pushen, wird eine Reihe von Build- und Bereitstellungsskripten ausgeführt. Diese Skripte generieren neuen Code und stellen ihn in der Remote-Umgebung bereit. Wenn Sie beispielsweise eine Entwicklungsverzweigung von Ihrer lokalen Umgebung in die Remote-Verzweigung verschieben, aktualisiert eine übereinstimmende Umgebung die Dienste, den Code und statischen Inhalte.

Sie können direkt mit einer Store-URL, einer Admin-URL und einer SSH auf diese Umgebung zugreifen. Zu diesen Umgebungen gehören ein Webserver, eine Datenbank und konfigurierte Dienste. Wenn Sie bereit sind, können Sie mit der Bereitstellung und dem Testen in der Staging-Umgebung beginnen.

Weitere Informationen finden Sie unter Freigabe-Workflow.

Optional: Beispieldaten installieren

Wenn Sie bei der Entwicklung Ihres Stores Beispieldaten benötigen, können Sie Beispieldaten installieren. Diese Daten simulieren einen aktiven Store, einschließlich Kunden, Produkten und anderen Daten. Diese Beispieldaten funktionieren am besten mit einer "leeren Site"-Adobe Commerce für die Installation von Cloud-Infrastrukturvorlagen bei der Projekterstellung. Es empfiehlt sich, die Beispieldaten vor der Live-Schaltung zu entfernen. Siehe Installieren optionaler Beispieldaten.

Optionale Beispieldaten installieren

Optional: Produktionsdaten abrufen

Fügen Sie alle Ihre Produkte, Kataloge, Site-Inhalte usw. direkt zur production -Umgebung hinzu. Durch Hinzufügen dieser Daten zur Produktionsumgebung können Sie aktualisierte Preise, Gutscheine, Lagerbestände, Verkaufsankündigungen, Informationen über zukünftige Angebote und mehr für Ihre Kunden bereitstellen. Diese Daten enthalten keine Erweiterungskonfigurationen, die Sie in Ihrer lokalen Entwicklungsverzweigung konfigurieren.

Wenn Sie Funktionen entwickeln, Erweiterungen hinzufügen und Designs entwerfen, ist es hilfreich, echte Daten für die Arbeit mit bereitzustellen. Sie können jederzeit einen Datenbank-Dump aus der Produktionsumgebung erstellen und diesen nach Bedarf an Ihre Staging- und Integrationsumgebungen senden.

So exportieren Sie Produktionsdaten als Testdaten für die Verwendung in Staging- und Integrationsumgebungen:

Informationen zum Migrieren dieser Daten finden Sie unter Migrieren und Bereitstellen von statischen Dateien und Daten.

Produktionsdaten abrufen und bereinigen

NOTE
Bevor Sie die Daten in eine andere Umgebung übertragen, sollten Sie erwägen, Ihre Daten zu bereinigen. Sie haben einige Optionen, darunter Verwendung von Support-Dienstprogrammen oder Entwicklung eines Skripts zum Scannen von Kundendaten.
WARNING
Veröffentlichen Sie eine Datenbank nicht von einer Integration- oder Staging-Umgebung in eine Produktionsumgebung. Wenn Sie dies tun, überschreiben die Daten aus der Integration oder Staging-Umgebung Ihre Live-Produktionsdaten, einschließlich Vertrieb, Bestellungen, neue und aktualisierte Kunden und mehr.

Bereitstellungsarbeitsablauf

Wie in den Architekturinformationen beschrieben, wird Adobe Commerce zur Cloud-Infrastruktur Git-gesteuert. Die Bereitstellung von Adobe Commerce in der Cloud-Infrastruktur ist Teil Ihrer Git-Push-Prozesse für Zweige.

Wenn Sie verzweigten Code von Ihrer lokalen Umgebung an den Remote-Zweig pushen, beginnt eine Reihe von Build- und Bereitstellungsskripten.

Build-Skripte:

  • Die Site in der Zielumgebung wird während eines Builds weiterhin ausgeführt

  • Adobe Commerce auf Cloud-Infrastruktur-Patches und Hotfixes überprüfen und ausführen

  • Kompilieren Sie Ihren Code mit einem Build- und Bereitstellungsprotokoll

  • Überprüfen Sie, ob die Bereitstellung statischer Inhalte während dieser Phase auf Configuration Management erfolgt.

  • Erstellen oder verwenden Sie ein Muster mit unverändertem Code für einen schnelleren Prozess

  • Bereitstellung aller Backend-Dienste und -Anwendungen

Bereitstellen von Skripten:

  • Platziert Ihre Site in die Zielumgebung im Wartungsmodus

  • Stellt statischen Inhalt bereit, wenn er beim Erstellen nicht abgeschlossen wurde

  • Installation oder Aktualisierung von Adobe Commerce in der Cloud-Infrastruktur

  • Routing für Traffic konfigurieren

Wenn Sie fertig sind, wird Ihr Store mit all Ihrem aktualisierten Code und Ihren aktualisierten Konfigurationen online und live geschaltet.

Siehe Bereitstellungsprozess.

Push to Staging und Test

Pushen Sie Ihren Code in Iterationen immer in die Umgebung staging , um ihn vollständig zu testen. Wenn Sie diese Umgebung zum ersten Mal verwenden, müssen Sie einige Dienste konfigurieren, darunter Fastly und New Relic. Konfigurieren Sie außerdem Zahlungskanäle, Versand, Benachrichtigungen und andere wichtige Dienste mit Sandbox- oder Testberechtigungen.

Staging ist eine Produktionsumgebung vor der Produktion, die alle Dienste und Einstellungen so nahe wie möglich an der Produktion anbietet. Testen Sie alle Dienste gründlich, überprüfen Sie Ihre Leistungstestwerkzeuge, führen Sie UAT-Tests als Administrator und Kunde durch, bis Sie das Gefühl haben, dass Ihr Geschäft für die Produktion bereit ist.

Siehe Bereitstellen Ihres Stores.

Push to Production

Wenn Sie zum Zweig master pushen, verschieben Sie es in die Umgebung production . Schließen Sie die Konfigurations- und Testaktivitäten in der Produktionsumgebung wie in der Staging-Umgebung ab, mit einem wichtigen Unterschied. Verwenden Sie in der Produktionsumgebung Live-Anmeldeinformationen für die Konfiguration und Tests. Sobald Sie Ihre Site starten, können Kunden Käufe abschließen und Administratoren können den Live Store verwalten.

Siehe Bereitstellen Ihres Stores.

Site-Launch

Es gibt einen klaren Überblick über die Möglichkeiten, mit Ihrer Site zu leben. Nachdem Sie diese Schritte ausgeführt haben, kann Ihr Geschäft Produkte in Ihrem angepassten Design sofort zum Verkauf bereitstellen.

Siehe Site-Launch.

Kontinuierliche Integration

Nach Ihren Verzweigungs- und Entwicklungsmethoden können Sie einfach neue Funktionen entwickeln, Änderungen konfigurieren und Erweiterungen hinzufügen, um fortlaufend Updates zu entwickeln und bereitzustellen.

Alle Cloud-Infrastrukturumgebungen unterstützen die kontinuierliche Integration für konstante Aktualisierungen. Dieser Workflow unterstützt Veröffentlichungen mehrmals am Tag oder nach einem festgelegten Zeitplan entsprechend Ihren Geschäftsanforderungen.

  • Erstellen von Entwicklungszweigen mit zukünftigen Funktionen und Änderungen

  • Testen Sie den Code in Ihrer integration -Umgebung.

  • Bereitstellen und Testen in der staging-Umgebung

  • In der production -Umgebung bereitstellen

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26