Dokumentation Handbuch zu Commerce in Cloud Manager

Verwalten von Verzweigungen mit der CLI

Last update: Fri Jan 31 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Themen:
Cloud

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:

Melden Sie sich bei Ihrer lokalen Workstation mit einem Konto Dateisystemeigentümer an.
Wechseln Sie zum Verzeichnis Webserver oder virtueller Host docroot.

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

code language-bash
`magento-cloud login`

Auflisten der Projekte

code language-bash
`magento-cloud project:list`

Klonen Sie ein Projekt.

code language-bash
`magento-cloud project:get <project-ID>`

Geben Sie bei Aufforderung einen Verzeichnisnamen an.

Wechseln Sie in das Verzeichnis magento2 .

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

code language-bash
`magento-cloud environment:list`

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

Rufen Sie die Remote-Verzweigungen ab.

code language-bash
`git fetch origin`

Aktualisierten Code abrufen.

code language-bash
`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:

Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.

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

code language-bash
`magento-cloud branch <new-environment-name> integration`

Aktualisieren von Abhängigkeiten.

code language-bash
`composer --no-ansi --no-interaction install --no-progress --prefer-dist --optimize-autoloader`

[optional] Erstellen Sicherung der Umgebung.

Zusammenführen einer Verzweigung

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

Code-Änderungen übernehmen und übertragen:

code language-bash
`git add -A && git commit -m "Add message here"`

code language-bash
`git push origin <branch-name>`

Zusammenführen mit der übergeordneten Umgebung:

code language-bash
`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:

Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.

Aktualisierungen vom Remote-Server abrufen.

code language-bash
`git fetch`

Löschen Sie die Umgebungsverzweigung.

code language-bash
`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.

code language-bash
`magento-cloud environment:delete <environment-1-ID> <environment-2-ID>`

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

code language-none
`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.

code language-none
`Delete the remote Git branch too? [Y/n]`

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

Warten Sie, bis die Umgebung gelöscht wurde.

code language-none

code language-none
`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.`

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 .

Interaktion mit Remote-Umgebungen

Nachdem Sie SSH-Schlüssel eingerichtet haben, können Sie eine Verbindung zwischen Ihrem lokalen Arbeitsbereich und einer Remote-Umgebung herstellen mit Ihren Projekt-Services interagieren und Einstellungen ändern.

recommendation-more-help