DokumentationCommerceHandbuch zu Commerce mit Cloud Infrastructure

Verwalten von Verzweigungen mit dem Cloud Console

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

Erstellt für:

  • Entwickler

Sie können Ihre Umgebungen mit der CLI Cloud Console oder magento-cloud verwalten. Ihre Projektdateien werden in einem Git-Repository gespeichert. Sie können Git-Befehle verwenden, um Ihren Code zu verwalten. Die CLI magento-cloud ist jedoch für die Interaktion mit Plattformfunktionen konzipiert, die Git-Befehle dagegen nicht. Siehe Git-Befehle im Cloud-CLI-Thema.

In diesem Thema wird erläutert, wie Sie mit dem Cloud Console Folgendes erreichen können:

  • Hinzufügen oder Löschen einer Umgebung
  • Synchronisieren (git pull) von der übergeordneten Umgebung
  • Zusammenführen (git push) mit der übergeordneten Umgebung
TIP
Sie können keine Verzweigungen aus der Staging- und Produktionsumgebung von Pro erstellen. Sie können eine Verzweigung vom Zweig master durchführen.

Erstellen einer Umgebung

Die Verzweigungsstrategie verwendet einen gemeinsamen Git-Workflow, in dem Sie Code entwickeln und Erweiterungen in einer Entwicklungsverzweigung hinzufügen. Siehe Architekturübersichten Starter und Pro .

  • Erstellen Sie für Starter einen staging -Zweig aus der Verzweigung master und dann einen Zweig aus staging zur Entwicklung.
  • Erstellen Sie für Pro einen Entwicklungszweig aus der Umgebung Integration .

Ihr Konto unterstützt eine begrenzte Anzahl von (inaktiven) aktiven Verzweigungen {width="32"} (active) and an unlimited number of inactive branch {width="32"}. Verwalten Sie aktive und inaktive Verzweigungen, indem Sie eine Verzweigung nur mit dem Wert "Cloud Console"oder der Cloud-CLI hinzufügen oder löschen. Bevor Sie einen Zweig löschen können, deaktivieren Sie den Zweig, der in der Liste Umgebungen als inactive verbleibt. Sie können die Verzweigung zu einem späteren Zeitpunkt reaktivieren oder Sie können den Zweig löschen in den Umgebungseinstellungen oder mithilfe der Cloud-CLI.

Wenn Sie zusätzliche aktive Umgebungen für die Entwicklung benötigen, senden Sie ein Support-Ticket.

So fügen Sie einen Zweig hinzu:

  1. Melden Sie sich bei Cloud Console an.

  2. Wählen Sie ein Projekt aus der Liste Alle Projekte aus.

  3. Wählen Sie eine Umgebung aus.

    note tip
    TIP
    Ihr neuer Zweig wird aus dieser Umgebung geklont. Wählen Sie eine übergeordnete Umgebung aus, die der Umgebung ähnelt, die Sie gerade erstellen.

  4. Klicken Sie auf Branch.

    Erstellen einer Verzweigung {width="150"}

  5. Geben Sie im Formular Verzweigung von … einen Verzweigungsnamen ein.

    Die Umgebung name unterscheidet sich nur dann von der Umgebung ID, wenn Sie Leerzeichen oder Großbuchstaben im Umgebungsnamen verwenden. Eine Umgebungs-ID besteht aus allen Kleinbuchstaben, Zahlen und zulässigen Symbolen. Großbuchstaben in einem Umgebungsnamen werden in der ID in Kleinbuchstaben umgewandelt; Leerzeichen in einem Umgebungsnamen werden in Bindestriche umgewandelt.

    Der Umgebungsname kann keine Zeichen enthalten, die für Ihre Linux-Shell oder reguläre Ausdrücke reserviert sind. Unzulässige Zeichen sind geschweifte Klammern ({ }), Klammern, Sternchen (*), spitze Klammern (>), Und-Zeichen (&), Prozent (%)) und anderen Zeichen.

  6. Wählen Sie einen Environment type aus.

  7. Klicken Sie auf Create Branch.

  8. Warten Sie, während die Umgebung bereitgestellt wird.

    Während der Bereitstellung lautet der Umgebungsstatus In Bearbeitung. Nach einer erfolgreichen Bereitstellung ändert sich der Status in ein grünes Häkchen für Erfolg.

Inaktive Verzweigung erstellen

Sie können keine inaktive Verzweigung über die Adobe Commerce Cloud-Konsole oder die CLI erstellen. Wenn Sie eine inaktive Verzweigung erstellen möchten, erstellen Sie sie im Git-Repository und pushen Sie mithilfe der Option environment.Parent im -Befehl.

git push -o "environment.Parent=<parent branch>" <origin> <branch>

Löschen einer Umgebung

Bevor Sie eine Umgebung löschen können, müssen Sie sie deaktivieren. Sobald eine Umgebung inaktiv ist, können Sie sie löschen.

So deaktivieren Sie eine Umgebung:

  1. Melden Sie sich bei Cloud Console an.

  2. Wählen Sie ein Projekt aus der Liste Alle Projekte aus.

  3. Wählen Sie die Umgebung aus der Liste der Navigationsleiste Umgebung aus.

  4. Klicken Sie auf das Konfigurationssymbol auf der rechten Seite der oberen Navigationsleiste, um die Umgebungseinstellungen zu öffnen.

  5. Scrollen Sie auf der Registerkarte General ​nach unten zum Abschnitt​ Deactivate environment, klicken Sie auf Deactivate environment and delete data und befolgen Sie die Anweisungen.

Umgebung synchronisieren

Das Synchronisieren einer Umgebung (oder Verzweigung) ist mit git pull origin <parent> identisch. Sie können aktualisierten Code aus einer übergeordneten Umgebung synchronisieren. Sie können diese Funktion über die Cloud Console für alle Starter- und Pro-Umgebungen verwenden.

Für Pro Plan können Sie von Staging und Produktion mit Ihrer master -Verzweigung synchronisieren. Bei dieser Synchronisierung wird nur Code abgerufen und gepusht, nicht Daten. Um Daten zu synchronisieren, speichern Sie die Datenbankdaten und pushen Sie sie in die Datenbank einer anderen Umgebung. Siehe Migration und Bereitstellung statischer Dateien und Daten.

So synchronisieren Sie eine Umgebung:

  1. Melden Sie sich bei Cloud Console an.

  2. Wählen Sie ein Projekt aus der Liste Alle Projekte aus.

  3. Klicken Sie in der Umgebungsliste auf den Namen des zu synchronisierenden Zweigs.

  4. Klicken Sie auf (Synchronisieren).

    Synchronisieren einer Umgebung {width="150"}

  5. Wählen Sie die zu synchronisierenden Elemente aus.

    • Ersetzen Sie die Daten (Daten und Dateien). Synchronisiert Änderungen in der Datenbank und den Inhaltsdateien aus der übergeordneten Verzweigung.
    • Merge—(code) synchronisiert aktualisierten Code aus der übergeordneten Verzweigung.

    Dadurch wird auch ein CLI-Befehl erstellt, den Sie kopieren und verwenden können.

  6. Klicken Sie auf Synchronisieren.

Zusammenführen mit der übergeordneten Umgebung

Das Zusammenführen einer Umgebung (oder eines Zweigs) entspricht git push origin. Sie werden zusammengeführt, um aktualisierten Code von einer Umgebung in die übergeordnete Umgebung zu pushen. Sie können diesen Code mit master zusammenführen. Sie können die Bereitstellung für Staging und Produktion mit dem Befehl merge durchführen.

So führen Sie die Zusammenführung mit der übergeordneten Umgebung durch:

  1. Melden Sie sich bei Cloud Console an.

  2. Wählen Sie ein Projekt aus der Liste Alle Projekte aus.

  3. Klicken Sie in der Umgebungsliste auf den Namen der zusammenzuführenden Verzweigung.

  4. Klicken Sie auf (Zusammenführen).

    Zusammenführen einer Umgebung {width="150"}

  5. Klicken Sie auf Zusammenführen und bestätigen Sie die Aktion.

Protokolle anzeigen

Mithilfe des Cloud Console können Sie verschiedene Protokolle für Umgebungen überprüfen, einschließlich Build, Bereitstellung und Bereitstellungsverlauf.

Für Starter können Sie Build- und Bereitstellungsprotokolle sowie den Bereitstellungsverlauf überprüfen. Zu diesen Umgebungen gehören die Verzweigung master (Produktion) und alle daraus erstellten Verzweigungen.

Für Pro können Sie die folgenden Protokolle in jeder Umgebung überprüfen:

  • Integration - Build- und Bereitstellungsverlauf
  • Staging: Erstellen Sie Protokolle und den Bereitstellungsverlauf. Verwenden Sie SSH, um sich beim Server anzumelden und Bereitstellungsprotokolle anzuzeigen.
  • Produktion - Erstellen Sie Protokolle und den Bereitstellungsverlauf. Verwenden Sie SSH, um sich beim Server anzumelden und Bereitstellungsprotokolle anzuzeigen.

So zeigen Sie Protokolle imCloud Console an:

  1. Melden Sie sich bei Cloud Console an.

  2. Wählen Sie ein Projekt aus der Liste Alle Projekte aus.

  3. Wählen Sie eine Umgebung aus.

    Die Umgebungsansicht bietet eine Aktivitätsliste , die die Ereignisse recent, einen Eintrag pro ausgeführter Aktion einschließlich Synchronisierungen, Zusammenführungen, Verzweigungen, Sicherungen und mehr anzeigt. Klicken Sie auf Alle , um den vollständigen Bereitstellungsverlauf anzuzeigen.

  4. Um das Build-Protokoll anzuzeigen, wählen Sie den Link Erfolg oder Fehler pro Bereitstellungsdatensatz im Konto aus.

TIP
Klicken Sie für eine Dropdown-Liste auf das Symbol Filtern nach und wählen Sie den Typ der anzuzeigenden Nachrichten aus.

Code aus einem privaten Git-Repository abrufen

Ihr Adobe Commerce-Projekt in der Cloud-Infrastruktur kann Code aus einem privaten Git-Repository enthalten. Beispielsweise können Sie Code für ein benutzerdefiniertes Modul oder Design in einem privaten Repo haben. Dazu müssen Sie den öffentlichen SSH-Schlüssel Ihres Projekts zu Ihrem privaten Git-Repository hinzufügen und Ihre Projekt-Datei composer.json aktualisieren.

Um Ihrem privaten GitHub-Repository einen Bereitstellungsschlüssel hinzuzufügen, müssen Sie Administrator dieses Repositorys sein. Mit GitHub können Sie einen Bereitstellungsschlüssel nur für ein Repository verwenden.

Wenn Sie es vorziehen, dass Ihr Projekt auf mehrere Repositorys zugreift, können Sie einen SSH-Schlüssel an ein automatisiertes Benutzerkonto anhängen. Da dieses Konto nicht von einem Benutzer verwendet wird, wird es als Machine user bezeichnet. Fügen Sie das Maschinenkonto als Mitarbeiter hinzu oder fügen Sie den Maschinenbenutzer einem Team mit Zugriff auf die Repositorys hinzu.

INFO
Adobe empfiehlt das Hinzufügen und Zusammenführen dieses Codes zu Ihren Projekt-Git-Repositorys. Wenn Sie die Verbindung nicht konfigurieren, treten möglicherweise Build-Probleme auf.

So suchen Sie Ihren öffentlichen SSH-Schlüssel:

  1. Melden Sie sich bei Cloud Console an.

  2. Wählen Sie ein Projekt aus der Liste Alle Projekte aus.

  3. Klicken Sie auf das Konfigurationssymbol auf der rechten Seite der oberen Navigationsleiste.

  4. Klicken Sie in Projekteinstellungen auf Deploy Key.

  5. Kopieren Sie den Bereitstellungsschlüssel zur Verwendung in einer der folgenden Git-basierten Methoden in die Zwischenablage:

GitHub

GitHub-Bereitstellungsschlüssel eingeben

Auf GitHub sind Bereitstellungsschlüssel standardmäßig schreibgeschützt.

So geben Sie Ihren öffentlichen Projektschlüssel als GitHub-Bereitstellungsschlüssel ein:

  1. Melden Sie sich bei Ihrem GitHub-Repository als Administrator an.

  2. Klicken Sie auf die Registerkarte Repository Settings .

    note note
    NOTE
    Wenn diese Option nicht angezeigt wird, sind Sie nicht als Repository-Administrator angemeldet und können diese Aufgabe nicht ausführen. Bitten Sie dazu Ihren GitHub-Repository-Administrator.

  3. Klicken Sie auf der Registerkarte Einstellungen im linken Navigationsbereich auf Deploy Keys.

  4. Klicken Sie auf Add deploy key.

  5. Folgen Sie den Anweisungen.

Verwenden Sie in composer.json das Format <user>@<host>:<.git</code> oder ssh://<user>@<host>:<port>/<path>.git bei Verwendung eines nicht standardmäßigen Anschlusses.

Bitbucket

Geben Sie den Bitbucket-Bereitstellungsschlüssel ein

So geben Sie Ihren öffentlichen Projektschlüssel als Bitbucket-Bereitstellungsschlüssel ein:

  1. Melden Sie sich bei Ihrem Bitbucket-Repository als Administrator an.

  2. Klicken Sie im linken Navigationsbereich auf Settings.

  3. Klicken Sie auf Allgemein > Deployment Keys.

  4. Klicken Sie auf Add Key.

  5. Folgen Sie den Anweisungen.

GitLab

Geben Sie Ihren GitLab-Bereitstellungsschlüssel ein

Hinzufügen des öffentlichen SSH-Schlüssels für Ihr Projekt als GitLab-Bereitstellungsschlüssel:

  1. Melden Sie sich bei Ihrem GitLab-Repository als Eigentümer an.

  2. Stellen Sie sicher, dass die Option Pipelines für Ihr Projekt aktiviert ist:

    1. Erweitern Sie in den Projekteinstellungen den Abschnitt Visibility, project, features, permissions .
    2. Klicken Sie bei Bedarf auf Pipelines , um die Option zu aktivieren.

  3. Fügen Sie Ihren öffentlichen SSH-Schlüssel zu den CI/CD-Einstellungen hinzu.

    1. Klicken Sie im linken Navigationsbereich auf Einstellungen > CI / CD.
    2. Klicken Sie auf Schlüssel bereitstellen erweitern , um den Schlüssel zu konfigurieren.
    3. Fügen Sie im Formular Schlüssel bereitstellen einen Schlüsselnamen für die Bereitstellung zum Feld Title hinzu und fügen Sie Ihren öffentlichen SSH-Schlüssel in das Feld Key ein.
    4. Klicken Sie auf Add Key , um die Konfiguration zu speichern.

Sichere Umgebungen und Zweige

Sie können über einen Webbrowser mit dem Wert "Cloud Console"von einem beliebigen Speicherort aus auf Ihr Projekt und Ihre Umgebungen zugreifen. Möglicherweise verfügen Sie über Sicherheitseinstellungen für Ihre Produktionsumgebung, Stores und Sites. In diesem Abschnitt erhalten Sie Informationen zum Sichern Ihrer Integrations- und Staging-Umgebungen für strikte Anforderungen an Entwickler, DBAs und mehr.

WARNING
VERWENDEN SIE NICHT die folgenden Methoden zum Schützen von Pro Staging- und Produktionsumgebungen. Dies verhindert das schnelle Zwischenspeichern. Verwenden Sie die Funktion Blocking , die im Fastly CDN für Adobe Commerce verfügbar ist.

So sichern Sie Umgebungen:

  1. Melden Sie sich bei Cloud Console an.

  2. Wählen Sie ein Projekt aus der Liste Alle Projekte aus.

  3. Wählen Sie eine Umgebung aus und klicken Sie in der Navigationsleiste auf das Konfigurationssymbol .

  4. Klicken Sie auf der Registerkarte "Umgebungseinstellungen Allgemein"auf ON für HTTP access control enabled, um den sicheren Zugriff zu aktivieren. Sie können zwischen Anmeldedaten oder IP-Adressen wählen, um nach Zugriff zu filtern.

  5. Um nach Anmeldeinformationen zu filtern, klicken Sie auf "Add Login", geben Sie einen Benutzernamen und ein Kennwort ein und klicken Sie auf "Add Login", um sie hinzuzufügen.

  6. Um nach IP-Adresse zu filtern, geben Sie die IP-Adressen in eine Liste mit deny oder allow ein. Beispiel:

    code language-text 
    123.456.789.111/29 allow
123.456.789.112/29 allow
234.123.567.111/29 allow
0.0.0.0/0 deny

  7. Klicken Sie auf Save. Dadurch wird die Umgebung erneut bereitgestellt, um die Sicherheit und Einstellungen zu aktualisieren. Adobe empfiehlt, die Umgebung nach Abschluss der Sicherheitseinstellungen zu testen.

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