DokumentationHandbuch zu Commerce in Cloud Manager

Wiederherstellen einer Umgebung

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

Erstellt für:

  • Entwickler

Wenn in der Integrationsumgebung Probleme auftreten und Sie keine gültige Sicherung haben oder die Umgebung auf ein leeres Blatt zurücksetzen möchten, können Sie Ihre Umgebung mit einer der folgenden Methoden wiederherstellen/zurücksetzen:

  • Zurücksetzen oder Zurücksetzen des Codes in der Git-Verzweigung
  • Commerce deinstallieren
  • Erzwingen einer erneuten Bereitstellung
  • Manuelles Zurücksetzen der Datenbank
TIP
Hilfe bei blockierten Bereitstellungen erhalten Sie mit der Fehlerbehebung bei der Adobe Commerce-Bereitstellung im Commerce-Hilfezentrum.

Zurücksetzen der Git-Verzweigung

Durch Zurücksetzen der Git-Verzweigung wird der Code in der Vergangenheit in einen stabilen Status zurückgesetzt.

So setzen Sie Ihre Verzweigung zurück:

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

  2. Überprüfen Sie den Verlauf des Git-Commits. Verwenden Sie --oneline, um abgekürzte Commits in einer Zeile anzuzeigen:

    code language-bash 
    git log --oneline

    Beispielantwort:

    code language-none 
    6bf9f45 (HEAD -> master, magento/master, magento/develop, magento/HEAD, develop) Create composer.lock
34d7434 2.4.6 upgrade
b69803c Update composer.lock
c1bca24 Add sample data
ec604c3 Update magento/ece-tools
...

  3. Wählen Sie einen Commit-Hash, der den letzten bekannten stabilen Status Ihres Codes darstellt.

    Um Ihre Verzweigung auf den ursprünglichen initialisierten Status zurückzusetzen, suchen Sie nach dem ersten Commit, mit dem Ihre Verzweigung erstellt wurde. Sie können --reverse verwenden, um den Verlauf in umgekehrter chronologischer Reihenfolge anzuzeigen.

  4. Verwenden Sie die Option zum Zurücksetzen der Verzweigung. Seien Sie vorsichtig mit diesem Befehl, da er alle Änderungen seit dem ausgewählten Commit verwirft.

    code language-bash 
    git reset --hard <commit>

  5. Übertragen Sie Ihre Änderungen in eine Trigger-A-Bereitstellung, wodurch Adobe Commerce neu installiert wird.

    code language-bash 
    git push --force <origin> <branch>

Commerce deinstallieren

Durch die Deinstallation der Commerce-Anwendung kehrt Ihre Umgebung in den Originalzustand zurück, indem Sie die Datenbank wiederherstellen, die Bereitstellungskonfiguration entfernen und die var/ Unterverzeichnisse löschen. In dieser Anleitung wird auch die Git-Verzweigung auf einen früheren stabilen Status zurückgesetzt. Wenn Sie nicht über eine aktuelle Sicherung verfügen, aber auf die Remote-Umgebung über SSH zugreifen können, führen Sie die folgenden Schritte aus, um Ihre Umgebung wiederherzustellen:

  • Deaktivieren der Konfigurationsverwaltung
  • Adobe Commerce deinstallieren
  • Zurücksetzen der Git-Verzweigung

Durch die Deinstallation der Adobe Commerce-Software wird die Datenbank gelöscht, die Bereitstellungskonfiguration entfernt und die var/-Unterverzeichnisse gelöscht. Es ist wichtig, die Konfigurationsverwaltung zu deaktivieren, damit die vorherigen Konfigurationseinstellungen bei der nächsten Bereitstellung nicht automatisch angewendet werden. Stellen Sie sicher, dass das app/etc/-Verzeichnis nicht die config.php-Datei enthält.

Deinstallieren der Adobe Commerce-Software:

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

  2. Verwenden Sie SSH, um sich bei der Remote-Umgebung anzumelden.

    code language-bash 
    magento-cloud ssh

  3. Entfernen Sie die Konfigurationsdatei.

    • Für Adobe Commerce 2.2 und höher:

      code language-bash 
      rm app/etc/config.php

    • Für Adobe Commerce 2.1:

      code language-bash 
      rm app/etc/config.local.php

  4. Deinstallieren Sie die Adobe Commerce-Anwendung.

    code language-bash 
    php bin/magento setup:uninstall -n

  5. Bestätigen Sie, dass Adobe Commerce erfolgreich deinstalliert wurde.

    Die folgende Meldung wird angezeigt, um eine erfolgreiche Deinstallation zu bestätigen:

    code language-none 
    [SUCCESS]: Magento uninstallation complete.

  6. Löschen Sie die var/ Unterverzeichnisse.

    code language-bash 
    rm -rf var/*

  7. Abmelden.

TIP
Optional ist es eine gute Praxis, Caches zu bereinigen.
code language-bash 
magento-cloud project:clear-build-cache

Erzwingen einer erneuten Bereitstellung

Wenn Sie versucht haben, Adobe Commerce zu deinstallieren und Ihre Bereitstellung weiterhin fehlschlägt, können Sie versuchen, manuell eine erneute Bereitstellung zu erzwingen.

git commit --allow-empty -m "<message>" && git push <origin> <branch>

Datenbank zurücksetzen

Wenn Sie versucht haben, Adobe Commerce zu deinstallieren, und der Befehl fehlgeschlagen ist oder nicht abgeschlossen werden konnte, können Sie die Datenbank manuell zurücksetzen.

Zurücksetzen der Datenbank:

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

  2. Verwenden Sie SSH, um sich bei der Remote-Umgebung anzumelden.

    code language-bash 
    magento-cloud ssh

  3. Stellen Sie eine Verbindung zur Datenbank her.

    code language-bash 
    mysql -h database.internal

  4. main ablegen.

    code language-shell 
    drop database main;

  5. Erstellen Sie eine leere main.

    code language-shell 
    create database main;

  6. Löschen Sie die folgenden Konfigurationsdateien.

    • config.php
    • config.php.bak
    • env.php
    • env.php.bak

  7. Trigger Melden Sie sich ab und führen Sie eine erneute Bereitstellung durch.

    code language-bash 
    magento-cloud environment:redeploy
WARNING
Trigger Der Bereitstellungsprozess beginnt, wenn Sie eine Zusammenführung, einen Push oder eine Synchronisierung Ihrer Umgebung durchführen oder eine manuelle erneute Bereitstellung durchführen, während der sich die Commerce-Anwendung im Wartungsmodus befindet. Für eine Produktionsumgebung empfiehlt Adobe, diese Arbeiten außerhalb der Spitzenzeiten durchzuführen, um Service-Unterbrechungen zu vermeiden.
recommendation-more-help