Verwalten von Zweigen mit der CLI
Informationen zum Installieren 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 die Umgebungen für Ihre Projekte mit magento-cloud
-CLI-Befehlen verwalten. Informationen zur Umgebungsarchitektur finden Sie unter Starter Architecture oder Pro Architecture.
Informationen zum Verwalten der Verzweigungen und Umgebungen mit dem Cloud Console finden Sie unter Verwalten von Verzweigungen mit dem 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. Sie können die Befehle zwar aus einem beliebigen Verzeichnis ausführen, es wird jedoch empfohlen, sie in einem Projektverzeichnis auszuführen. Wenn Sie von einem Projektverzeichnis aus ausgeführt werden, können Sie den Parameter -p <project-ID>
auslassen. Siehe Cloud-CLI-Referenz.
Projekt klonen
Die folgenden Anweisungen verwenden eine Kombination aus magento-cloud
CLI-Befehlen und Git-Befehlen, um Ihr Projekt auf Ihrer lokalen Workstation zu klonen. Verwenden Sie den Befehl magento-cloud list
, um eine vollständige Liste der Befehle von magento-cloud
CLI anzuzeigen.
magento-cloud environment:branch <branch-name>
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
environment:
-
Melden Sie sich mit einem Dateisysteminhaber -Konto bei Ihrer lokalen Workstation an.
-
Wechseln Sie zum Ordner "docroot"des Webservers oder virtuellen Hosts.
-
Melden Sie sich mit der CLI
magento-cloud
an.code language-bash magento-cloud login
-
Geben Sie Ihre Projekte an.
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 Ordnernamen an.
-
Wechseln Sie zum Ordner "
magento2
". -
Liste der verfügbaren Umgebungen für das Projekt.
code language-bash magento-cloud environment:list
note important IMPORTANT Der Befehl magento-cloud environment:list
zeigt Umgebungshierarchien an, der Befehlgit branch
dagegen nicht. -
Rufen Sie die Remote-Zweige ab.
code language-bash git fetch origin
-
Aktualisierten Code abrufen.
code language-bash git pull origin <environment-ID>
Erstellen einer Verzweigung für die Entwicklung
Nachdem Sie Ihr Projekt geklont und die Konfiguration des Adobe Commerce-Administratorkontos aktualisiert haben, können Sie zur Entwicklung verzweigen. Wie bereits erwähnt, müssen Sie eine Umgebung mit dem Befehl magento-cloud environment:branch <branch-name>
oder dem Befehl Cloud Console erstellen, damit die Umgebung aktiv wird.
So erstellen Sie einen Entwicklungszweig:
-
Wechseln Sie auf Ihrer lokalen Workstation zum 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 Sie eine Sicherung der Umgebung.
Zusammenführen einer Verzweigung
Führen Sie nach Abschluss der Entwicklung diesen Zweig mit dem übergeordneten Element zusammen:
-
Änderungen an Zustimmungs- und Push-Code:
code language-bash git add -A && git commit -m "Add message here"
code language-bash git push origin <branch-name>
-
Mit der übergeordneten Umgebung zusammenführen:
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 mehr wiederhergestellt werden.
master
eines Projekts nicht löschen.Sie müssen ein Projekt-Administrator, ein Umgebungsadministrator oder Kontoinhaber sein, um diese Aufgabe durchführen zu können. Siehe Verwalten des Benutzerzugriffs auf Cloud-Projekte.
Wenn Sie eine Umgebung löschen, wird die Umgebung auf inactive gesetzt. Der Code ist weiterhin in der Git-Verzweigung verfügbar, enthält jedoch nicht mehr die Dienste 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 zum Projektverzeichnis.
-
Rufen Sie Aktualisierungen vom Remote-Server ab.
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>
-
Beantworten Sie die Anweisungen 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]
Durch Löschen der Umgebung wird sie in den Status inactive versetzt.
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 ist.
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.
magento-cloud environment:activate
, um eine inaktive Umgebung zu aktivieren.Interagieren mit Remote-Umgebungen
Nachdem Sie SSH-Schlüssel eingerichtet haben, können Sie eine Verbindung von Ihrem lokalen Arbeitsbereich zu einer Remote-Umgebung herstellen, mit Ihren Projektdiensten interagieren und Einstellungen ändern.