Verwalten von Verzweigungen mit der CLI

Letzte Aktualisierung: 31. Januar 2025

Erstellt für:

  • Entwickler

Informationen zur Installation der magento-cloud CLI finden Sie in der Cloud CLI-Referenz. Nachdem Sie die magento-cloud CLI installiert und SSH-Schlüssel für den Remote-Zugriff auf Ihre Cloud-Infrastruktur eingerichtet haben, können Sie magento-cloud CLI-Befehle verwenden, um die Umgebungen für Ihre Projekte zu verwalten. Informationen zur Umgebungsarchitektur finden Sie unter Starter-Architektur oder Pro-Architektur.

Informationen zum Verwalten der Verzweigungen und Umgebungen mit der Cloud Console finden Sie unter Verwalten von Verzweigungen mit der Cloud Console.

CLI-Befehle verwenden

Die magento-cloud CLI-Befehle ähneln den Git-Befehlen. Sie können sie verwenden, um eine Verbindung zu Ihrem Projekt herzustellen und Ihre Umgebungen zu verwalten. Obwohl Sie die Befehle in jedem Verzeichnis ausführen können, wird empfohlen, sie in einem Projektverzeichnis auszuführen. Bei der Ausführung in einem Projektverzeichnis können Sie den -p <project-ID> Parameter weglassen. Siehe die Cloud-CLI-Referenz.

Klonen des Projekts

Die folgenden Anweisungen verwenden eine Kombination aus magento-cloud CLI- und Git-Befehlen, um Ihr Projekt auf Ihrer lokalen Workstation zu klonen. Um eine vollständige Liste der magento-cloud CLI-Befehle anzuzeigen, verwenden Sie den magento-cloud list.

IMPORTANT
Einige Git-Befehle können eine Aktion in Ihrem Adobe Commerce in einem Cloud-Infrastrukturprojekt nicht abschließen. Sie können beispielsweise eine Verzweigung mit einem Git-Befehl erstellen, aber keine neue Umgebung erstellen und aktivieren. Sie müssen mit dem Befehl magento-cloud environment:branch <branch-name> eine Umgebung erstellen, damit die Umgebung aktiv wird. Alternativ können Sie die Cloud Console verwenden, um aktive Umgebungen zu erstellen. Siehe Cloud-CLI-Referenz.

So klonen Sie ein Projekt master eine Umgebung:

  1. Melden Sie sich bei Ihrer lokalen Workstation mit einem Konto Dateisystemeigentümer an.

  2. Wechseln Sie zum Verzeichnis Webserver oder virtueller Host docroot.

  3. Melden Sie sich über die magento-cloud CLI an.

    magento-cloud login

  4. Auflisten der Projekte

    magento-cloud project:list

  5. Klonen Sie ein Projekt.

    magento-cloud project:get <project-ID>

    Geben Sie bei Aufforderung einen Verzeichnisnamen an.

  6. Wechseln Sie in das Verzeichnis magento2 .

  7. Auflisten der für das Projekt verfügbaren Umgebungen.

    magento-cloud environment:list
    IMPORTANT
    Der Befehl magento-cloud environment:list zeigt Umgebungshierarchien an, der Befehl git branch dagegen nicht.

  8. Rufen Sie die Remote-Verzweigungen ab.

    git fetch origin

  9. Aktualisierten Code abrufen.

    git pull origin <environment-ID>
TIP
Unter Integrationen finden Sie Informationen zur Verwendung von Git-basierten Hosting-Services mit Adobe Commerce in der Cloud-Infrastruktur.

Erstellen einer Verzweigung für die Entwicklung

Nachdem Sie Ihr Projekt geklont und die Konfiguration des Adobe Commerce-Administratorkontos aktualisiert haben, können Sie eine Verzweigung für die Entwicklung erstellen. Wie bereits erwähnt, müssen Sie eine Umgebung mit dem Befehl magento-cloud environment:branch <branch-name> oder dem Cloud Console erstellen, damit die Umgebung aktiv wird.

  • Erwägen zunächst eine Verzweigung für staging zu erstellen und dann eine Entwicklungsverzweigung basierend auf der staging Verzweigung zu erstellen.
  • Erstellen Sie für Pro Entwicklungsverzweigungen basierend auf der Integration.

So erstellen Sie eine:

  1. Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.

  2. Erstellen Sie eine Umgebung basierend auf der für Ihren Projekt-Workflow empfohlenen Verzweigung.

    magento-cloud branch <new-environment-name> integration

  3. Aktualisieren von Abhängigkeiten.

    composer --no-ansi --no-interaction install --no-progress --prefer-dist --optimize-autoloader

  4. [optional] Erstellen Sicherung der Umgebung.

Zusammenführen einer Verzweigung

Führen Sie nach Abschluss der Entwicklung diese Verzweigung mit dem übergeordneten Element zusammen:

  1. Code-Änderungen übernehmen und übertragen:

    git add -A && git commit -m "Add message here"

    git push origin <branch-name>

  2. Zusammenführen mit der übergeordneten Umgebung:

    magento-cloud environment:merge <environment-ID>

Löschen einer Umgebung

Löschen Sie eine Umgebung nur, wenn Sie sicher sind, dass Sie sie nicht mehr benötigen. Eine Umgebung kann nach dem Löschen nicht wiederhergestellt werden.

WARNING
Die master Verzweigung eines Projekts kann nicht gelöscht werden.

Sie müssen Projekt-Admin, Umgebungs-Admin oder Kontoinhaber sein, um diese Aufgabe auszuführen. Siehe Benutzerzugriff auf Cloud-Projekte verwalten.

Wenn Sie eine Umgebung löschen, wird für die Umgebung inaktiv festgelegt. Der Code ist weiterhin in der Git-Verzweigung verfügbar, enthält jedoch nicht mehr die Services oder die Datenbank. Um die Umgebung vollständig zu löschen, müssen Sie auch die entsprechende Remote-Git-Verzweigung löschen.

Löschen einer Umgebung:

  1. Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.

  2. Aktualisierungen vom Remote-Server abrufen.

    git fetch

  3. Löschen Sie die Umgebungsverzweigung.

    magento-cloud environment:delete <environment-ID>

    Optional können Sie mehrere Umgebungen gleichzeitig löschen, indem Sie dem Löschbefehl mehrere Umgebungs-IDs hinzufügen.

    magento-cloud environment:delete <environment-1-ID> <environment-2-ID>

  4. Reagieren Sie auf die Aufforderungen zum Löschen der lokalen Umgebung und der entsprechenden Remote-Umgebung.

    The environment <environment-ID> is currently active: deleting it will delete all associated data.
Are you sure you want to delete the environment <environment-ID>? [Y/n]

    Wenn Sie die Umgebung löschen, wird sie in einen Status.

    Delete the remote Git branch too? [Y/n]

    Durch Löschen der Remote-Git-Verzweigung wird die Umgebung aus dem Projekt entfernt.

  5. Warten Sie, bis die Umgebung gelöscht wurde.

    Deleting environment <environment-ID>
Waiting for the activity...
  Deleting environment <project-id>-<environment-ID>-xxxxxx

  [============================]  1 min (complete)
Activity ID succeeded
Deleted remote Git branch <environment-ID>
Run git fetch --prune to remove deleted branches from your local cache.
TIP
Um eine inaktive Umgebung zu aktivieren, verwenden Sie den Befehl magento-cloud environment:activate .