DokumentationCommerceHandbuch zu Commerce mit Cloud Infrastructure

Wiederherstellen einer Umgebung

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Entwickler

Wenn Probleme in der Integrationsumgebung auftreten und keine gültige Sicherung vorhanden ist, versuchen Sie, Ihre Umgebung mit einer der folgenden Methoden wiederherzustellen:

  • Zurücksetzen oder Zurücksetzen des Codes in der Git-Verzweigung
  • Deinstallieren der Commerce-Anwendung
  • Neuerstellung erzwingen
  • Datenbank manuell zurücksetzen
TIP
Hilfe zu blockierten Bereitstellungen erhalten Sie mit der Fehlerbehebung bei der Adobe Commerce-Bereitstellung 🔗 im Commerce Help Center.

Git-Verzweigung zurücksetzen

Wenn Sie Ihre Git-Verzweigung zurücksetzen, wird der Code in der Vergangenheit wieder in einen stabilen Status versetzt.

So setzen Sie Ihren Zweig zurück:

  1. Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis.

  2. Überprüfen Sie den Git-Commitverlauf. 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 Ihren Zweig auf seinen ursprünglichen initialisierten Status zurückzusetzen, suchen Sie den ersten Commit, der Ihren Zweig erstellt hat. Sie können --reverse verwenden, um den Verlauf in umgekehrter chronologischer Reihenfolge anzuzeigen.

  4. Verwenden Sie die Option zum Zurücksetzen der Festplatte, um Ihren Zweig zurückzusetzen. 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 den Trigger einer Neuimplementierung, die Adobe Commerce erneut installiert.

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

Commerce deinstallieren

Durch das Deinstallieren der Commerce -Anwendung wird die Umgebung in den Originalzustand versetzt, indem die Datenbank wiederhergestellt, die Bereitstellungskonfiguration entfernt und die var/ -Unterverzeichnisse gelöscht werden. Durch diese Anleitung wird auch Ihre Git-Verzweigung in einen früheren stabilen Zustand zurückgesetzt. Wenn Sie keine kürzlich erstellte Sicherung haben, aber über SSH auf die Remote-Umgebung zugreifen können, führen Sie die folgenden Schritte aus, um Ihre Umgebung wiederherzustellen:

  • Konfigurationsverwaltung deaktivieren
  • Adobe Commerce deinstallieren
  • Git-Verzweigung zurücksetzen

Durch die Deinstallation der Adobe Commerce-Software wird die Datenbank gelöscht, die Bereitstellungskonfiguration entfernt und die Unterverzeichnisse var/ werden 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 Ihr app/etc/ -Verzeichnis nicht die Datei config.php enthält.

So deinstallieren Sie die Adobe Commerce-Software:

  1. Wechseln Sie auf Ihrer lokalen Workstation zum 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. Vergewissern Sie sich, 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 Unterverzeichnisse var/ .

    code language-bash 
    rm -rf var/*

  7. Melden Sie sich ab.

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

Neuerstellung erzwingen

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

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

Datenbank zurücksetzen

Wenn Sie versucht haben, Adobe Commerce zu deinstallieren, 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 zum 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. Legen Sie die main -Datenbank ab.

    code language-shell 
    drop database main;

  5. Erstellen Sie eine leere main -Datenbank.

    code language-shell 
    create database main;

  6. Löschen Sie die folgenden Konfigurationsdateien.

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

  7. Melden Sie sich ab und Trigger einer Neuimplementierung.

    code language-bash 
    magento-cloud environment:redeploy
WARNING
Der Bereitstellungsprozess beginnt, wenn Sie eine Zusammenführung, Push-Benachrichtigung oder Synchronisation Ihrer Umgebung durchführen oder wenn Sie eine manuelle Neuimplementierung Trigger haben, während der sich die Commerce -Anwendung im Wartungsmodus befindet. Für eine Produktionsumgebung empfiehlt Adobe, diese Arbeit außerhalb der Spitzenzeiten abzuschließen, um Dienstunterbrechungen zu vermeiden.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26