DokumentationCommerceHandbuch zu Commerce mit Cloud Infrastructure

Verwalten von Zweigen mit der CLI

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

Erstellt für:

  • Entwickler

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.

IMPORTANT
Einige Git-Befehle können keine Aktion in Ihrem Adobe Commerce-Projekt zur Cloud-Infrastruktur durchführen. Sie können beispielsweise eine Verzweigung mithilfe eines Git-Befehls erstellen, eine neue Umgebung jedoch nicht erstellen und aktivieren. Sie müssen eine Umgebung mit dem Befehl 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:

  1. Melden Sie sich mit einem Dateisysteminhaber -Konto bei Ihrer lokalen Workstation an.

  2. Wechseln Sie zum Ordner "docroot"des Webservers oder virtuellen Hosts.

  3. Melden Sie sich mit der CLI magento-cloud an.

    code language-bash 
    magento-cloud login

  4. Geben Sie Ihre Projekte an.

    code language-bash 
    magento-cloud project:list

  5. Klonen Sie ein Projekt.

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

    Geben Sie bei Aufforderung einen Ordnernamen an.

  6. Wechseln Sie zum Ordner "magento2".

  7. 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 Befehl git branch dagegen nicht.

  8. Rufen Sie die Remote-Zweige ab.

    code language-bash 
    git fetch origin

  9. Aktualisierten Code abrufen.

    code language-bash 
    git pull origin <environment-ID>
TIP
Informationen zur Verwendung von Git-basierten Hosting-Diensten mit Adobe Commerce in der Cloud-Infrastruktur finden Sie unter Integrationen .

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.

  • Für Starter sollten Sie eine Verzweigung für staging erstellen und dann eine Entwicklungsverzweigung erstellen, die auf der Verzweigung staging basiert.
  • Erstellen Sie für Pro Entwicklungszweige basierend auf der Integration -Verzweigung.

So erstellen Sie einen Entwicklungszweig:

  1. Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis.

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

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

  3. Aktualisieren von Abhängigkeiten.

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

  4. [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:

  1. Ä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>

  2. 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.

WARNING
Sie können den Zweig 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:

  1. Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis.

  2. Rufen Sie Aktualisierungen vom Remote-Server ab.

    code language-bash 
    git fetch

  3. 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>

  4. Beantworten Sie die Anweisungen zum Löschen der lokalen Umgebung und der entsprechenden Remote-Umgebung.

    code language-terminal 
    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-terminal 
    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 ist.

    code language-terminal 
    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
Verwenden Sie den Befehl 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.

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