DokumentationCommerceTools

Nutzung

Last update: Wed Dec 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Experte
  • Admin
  • Entwickler

Das Quality Patches Tool liefert individuelle Patches, die von Adobe und der Magento Open Source-Community entwickelt wurden. Damit können Sie allgemeine Informationen zu allen einzelnen Patches, die für die installierte Version von Adobe Commerce verfügbar sind, anwenden, zurücksetzen und anzeigen. Sie können Patches auf Adobe Commerce-Projekte anwenden, unabhängig davon, wer den Patch entwickelt hat. Sie können beispielsweise einen von der Community entwickelten Patch auf Adobe Commerce-Projekte anwenden.

In diesem technischen Video erfahren Sie, wie Sie das Quality Patches Tool für Adobe Commerce verwenden.

INFO
Anweisungen Anwenden von Patches auf Ihre Adobe CommerceProjekte finden Sie unter „Anwenden einzelner Patches“. Siehe Quality Patches Tool: Suchen nach Patches um eine vollständige Liste der veröffentlichten Patches anzuzeigen.
WARNING
Es wird nicht empfohlen, die Quality Patches Tool zum Anwenden einer großen Anzahl von Patches zu verwenden, da dies die Komplexität Ihres Codes erhöht und die Aktualisierung auf eine neue Version erschwert.

Installieren von

INFO
Wenn es noch nicht installiert ist, müssen Sie Git oder Patch installieren, bevor Sie die Quality Patches Tool installieren. Fügen Sie das magento/quality-patches Composer-Paket zu Ihrer composer.json hinzu:
composer require magento/quality-patches

Anzeigen einzelner Patches

So zeigen Sie die Liste der einzelnen Patches an, die für Ihre Version von Adobe Commerce verfügbar sind:

./vendor/bin/magento-patches status

Es wird eine Ausgabe ähnlich der folgenden angezeigt:

ID
Titel
Typ
Status
Details
MAGECLOUD-5069
FPC wird während der Bereitstellung deaktiviert
optional
Nicht angewendet
Betroffene Komponenten:
- magento/module-page-cache
MCLOUD-5650
Bereitstellungskonfiguration nach dem Lesen aus der Datei speichern
optional
Nicht angewendet
Betroffene Komponenten:
- Magento/Framework
MCLOUD-5684
Paginierung funktioniert nicht - product_list_limit=all
optional
Nicht angewendet
Betroffene Komponenten: - magento/module-elasticsearch
MCLOUD-5837
Problem mit dem Lastenausgleich beheben
Veraltet
Angewendet
Empfohlener Austausch: MC-1
Betroffene Komponenten: - Magento/Framework
BUNDLE-2554
Fehler bei Zahlungsinformationen festlegen
optional
Nicht angewendet
Betroffene Komponenten:
- amzn/amazon-pay-module
MC-1
Behebt Problem 1
optional
Angewendet
Betroffene Komponenten:
- magento/module-cms
MC-2
Behebt Problem 2
optional
Nicht angewendet
Betroffene Komponenten:
- magento/module-cms
MC-3
Behebt Problem 3
optional
Nicht angewendet
Erforderliche Patches:
- MC-2
Betroffene Komponenten:
- magento/module-cms
MC-3-V2
Fehlerkorrektur für Problem 3 aktualisiert, ersetzt MC-3-Patch
optional
Nicht zutreffend
Betroffene Komponenten:
- magento/module-cms

Adobe Commerce 2.3.5.

Die Statustabelle enthält:

  • Typ:

    • Optional - Alle Patches aus dem Quality Patches Tool und dem Paket Handbuch für Commerce in Cloud-Infrastruktur > Patches anwenden sind für Adobe Commerce-Installationen optional.
    • Deprecated - Adobe hat den einzelnen Patch nicht mehr unterstützt. Wenn Sie das Pflaster aufgeklebt haben, empfehlen wir, es rückgängig zu machen. Der Wiederherstellungsvorgang entfernt auch den Patch aus der Statustabelle.

  • Status:

    • Applied - Das Patch wurde angewendet.
    • Not applied - Das Patch wurde nicht angewendet.
    • N/A - Der Status des Patches kann aufgrund von Konflikten nicht definiert werden.

  • Details:

    • Affected components - Die Liste der betroffenen Module.
    • Required patches - Die Liste der Patches, die angewendet werden müssen, damit ein angegebenes Patch ordnungsgemäß funktioniert (Abhängigkeiten).
    • Recommended replacement - Das Patch, das als Ersatz für einen veralteten Patch empfohlen wird.
INFO
Nach dem Upgrade auf eine neue Version von Adobe Commerce müssen Sie Patches erneut anwenden, wenn die Patches nicht in der neuen Version enthalten sind. Siehe Erneutes Anwenden von Patches nach einem Upgrade.

Anwenden einzelner Patches apply-individual-patches

WARNING
Es empfiehlt sich, alle Patches in einer Staging- oder Entwicklungsumgebung zu testen, bevor sie in der Produktion bereitgestellt werden. Es wird außerdem empfohlen, eine Sicherungskopie der Daten zu erstellen, bevor Sie ein Patch anwenden. Siehe Sichern und Rollback des Dateisystems, der Medien und der Datenbank.

Um einen einzelnen Patch anzuwenden, führen Sie den folgenden Befehl aus, wobei MAGETWO-XXXX die in der Statustabelle angegebene Patch-ID ist:

./vendor/bin/magento-patches apply MAGETWO-XXXX

Sie können auch mehrere Patches gleichzeitig anwenden, indem Sie jede zusätzliche Patch-ID durch ein Leerzeichen trennen:

./vendor/bin/magento-patches apply MAGETWO-XXXX MAGETWO-YYYY

Sie müssen den Cache nach dem Anwenden von Patches bereinigen, um Änderungen in der Adobe Commerce-Anwendung sehen zu können:

./bin/magento cache:clean
INFO
Sie sollten eine Liste der angewendeten Patches an einem separaten Speicherort aufbewahren. Möglicherweise müssen Sie einige davon nach dem Upgrade auf eine neue Version von Adobe Commerce erneut anwenden. Siehe Erneutes Anwenden von Patches nach einem Upgrade.

Einzelne Patches zurücksetzen

WARNING
Es empfiehlt sich, alle Patches in einer Staging- oder Entwicklungsumgebung zu testen, bevor sie in der Produktion bereitgestellt werden. Es wird außerdem empfohlen, eine Sicherungskopie der Daten zu erstellen, bevor Sie ein Patch anwenden. Siehe Sichern und Rollback des Dateisystems, der Medien und der Datenbank.

Um einen einzelnen Patch wiederherzustellen, führen Sie den folgenden Befehl aus, wobei MAGETWO-XXXX die in der Statustabelle angegebene Patch-ID ist:

./vendor/bin/magento-patches revert MAGETWO-XXXX

Außerdem können Sie mehrere Patches gleichzeitig rückgängig machen, indem Sie jede zusätzliche Patch-ID durch ein Leerzeichen trennen:

./vendor/bin/magento-patches revert MAGETWO-XXXX MAGETWO-YYYY

So setzen Sie alle angewendeten Patches zurück:

./vendor/bin/magento-patches revert --all

Sie müssen den Cache nach dem Zurücksetzen von Patches bereinigen, um Änderungen in der Adobe Commerce-Anwendung sehen zu können:

./bin/magento cache:clean

Updates abrufen

Adobe Commerce veröffentlicht regelmäßig neue individuelle Patches. Sie müssen die Quality Patches Tool aktualisieren, um neue einzelne Patches zu erhalten:

composer update magento/quality-patches

Anzeigen der hinzugefügten Patches:

TIP
Neue Patches hinzufügen werden unten in der Tabelle angezeigt.
./vendor/bin/magento-patches status

Patches nach einem Upgrade erneut anwenden re-apply-patches-after-an-upgrade

Wenn Sie ein Upgrade auf eine neue Version von Adobe Commerce durchführen, müssen Sie die Patches erneut anwenden, wenn die Patches nicht in der neuen Version enthalten sind.

So wenden Sie Patches erneut an:

  1. Aktualisieren Sie die Quality Patches Tool:

    code language-bash 
    composer update magento/quality-patches.

  2. Öffnen Sie die Liste der zuvor angewendeten Patches, die unter Anwenden einzelner Patches“ empfohlen.

  3. Patches anwenden:

    code language-bash 
    ./vendor/bin/magento-patches apply MAGETWO-XXXX

    Es empfiehlt sich, Patches einzeln anzuwenden.

  4. Cache leeren:

    code language-bash 
    ./bin/magento cache:clean
    note info
    INFO
    Wenn Sie den status Befehl ausführen, werden die in der neuen Version enthaltenen Patches nicht mehr in der Tabelle der verfügbaren Patches angezeigt.

Protokollierung

Die Quality Patches Tool protokolliert alle Vorgänge in der <Magento_root>/var/log/patch.log.

recommendation-more-help
c2d96e17-5179-455c-ad3a-e1697bb4e8c3