Commerce-Version aktualisieren

Um (Services​ nur in Staging und Production Umgebungen zu installieren ​ zu aktualisieren senden Sie ein Adobe Commerce-Support-Ticket.

Geben Sie im Ticket die erforderlichen Service-Änderungen an, schließen Sie die aktualisierten .magento.app.yaml- und .magento/services.yaml-Dateien ein und notieren Sie sich die PHP-Zielversion.

PHP-Version, Composer-Updates, Erweiterungen und Umgebungseinstellungen sind Self-Service-Änderungen. Adobe muss möglicherweise den New Relic-Agenten aktualisieren, um die PHP-Versionskompatibilität zu gewährleisten. Siehe PHP-Einstellungen in Anwendungskonfiguration.

Bestätigen Sie den Upgrade Zeitplan durch den zweiteiligen Prozess von Adobe: Sie bestätigen zuerst das angeforderte Datum und die angeforderte Uhrzeit und senden es dann an den Support zur endgültigen Bestätigung an das Infrastruktur-Team.

Produktionsänderungen (nur Pro) erfordern mindestens zwei Werktage Vorankündigung, Wochenenden ausgeschlossen. Beispielsweise muss das Cloud-Infrastruktur-Team ein Upgrade vom Montag bis zum vorhergehenden Mittwoch bestätigen. Bei Spitzennachfrage ist mit zusätzlicher Vorlaufzeit zu rechnen. Um Verzögerungen zu vermeiden, beantworten Sie die ursprüngliche Anfrage mindestens 48 Stunden vor dem Fenster. Das Upgrade gilt erst als geplant, wenn Sie eine endgültige Bestätigung erhalten.

Validieren Sie das Upgrade in einer Staging- oder Integrationsumgebung, bevor Sie es in der Produktionsumgebung planen.

Probleme, die durch Drittanbietermodule, benutzerdefinierten Code oder die Kompatibilität mit Abhängigkeiten verursacht werden, treten häufig während der erneuten Bereitstellung auf, die auf ein Service-Upgrade folgt. Zur Validierung mehrerer Service-Upgrades auf einmal ist eine angemessene Reihenfolge Valley oder Redis, dann RabbitMQ, dann OpenSearch, dann MariaDB. Dies ist keine erforderliche Sequenz. Datenbank-Upgrades haben die größte Auswirkung auf den Betrieb und verdienen höchste Vorsicht.

Adobe übernimmt keine Garantie für die genaue Dauer eines Produktionswartungsfensters im Voraus, da der Zeitpunkt von der Umgebung und den beteiligten Services abhängt. Nutzen Sie bei der Planung des Produktionsfensters die Zeit, die für das Staging-Upgrade benötigt wird.

Stellen Sie die Umgebung erneut, nachdem Adobe das Service-Upgrade abgeschlossen hat, damit die Änderung wirksam wird, auch wenn sich die Version der Adobe Commerce-Anwendung nicht ändert.

Wenn das Upgrade OpenSearch umfasst, planen Sie auch eine vollständige Neuindizierung. Adobe kann keine Ausfallzeiten für ein Service-Upgrade garantieren. Planen Sie daher ein Wartungsfenster, in dem Zeit für die Neubereitstellung, Neuindizierung bei Bedarf und die Validierung der Storefront und des Administrators bleibt, bevor Sie die Site erneut öffnen.

Fügen Sie dem config Abschnitt die folgenden allow-plugins hinzu:

"config": {
   "allow-plugins": {
      "dealerdirect/phpcodesniffer-composer-installer": true,
      "laminas/laminas-dependency-plugin": true,
      "magento/*": true
   }
},

Fügen Sie dem Abschnitt require das folgende Plug-in hinzu:

"require": {
    "magento/composer-root-update-plugin": "^2.0.3"
},

Fügen Sie dem Abschnitt extra:component_paths die folgende Komponente hinzu:

"extra": {
   "component_paths": {
      "tinymce/tinymce": "lib/web/tiny_mce_5"
   },
},

Speichern Sie die Datei. Übernehmen oder übertragen Sie noch keine Änderungen an Ihre Verzweigung.

Fahren Sie mit dem Upgrade-Prozess fort.

Erstellen Sie eine lokale Sicherung der Remote-Datenbank.

magento-cloud db:dump

Sichern Sie Code und Medien.

php bin/magento setup:backup --code [--media]

Optional können Sie [--media] auslassen, wenn sich bereits eine große Anzahl von statischen Dateien in der Versionsverwaltung befinden.

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

Erstellen Sie einen Datenbank-Dump. Um einen Zielordner für den DB-Dump auszuwählen, verwenden Sie die Option --dump-directory .

vendor/bin/ece-tools db-dump

Der Dump-Vorgang erstellt eine dump-<timestamp>.sql.gz Archivdatei in Ihrem Remote-Projektverzeichnis. Siehe Datenbank sichern.

Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.

Legen Sie die Versionsbeschränkung für die Ziel-Upgrade-Version fest. Dieser Schritt ist nur erforderlich, wenn sich die Zielversion außerhalb der bestehenden Einschränkung befindet.

composer require-commerce "magento/magento-cloud-metapackage":">=CURRENT_VERSION <NEXT_VERSION" --no-update

Aktualisieren Sie Ihre composer.json mit der Commerce-Kernaktualisierungsversion.

composer require-commerce magento/product-enterprise-edition 2.4.8 --no-update

Wenn Sie B2B verwenden, aktualisieren Sie Ihre composer.json mit der unterstützten Version für Commerce.

composer require-commerce magento/extension-b2b 1.5.2 --no-update

Projektabhängigkeiten aktualisieren.

composer update

Überprüfen Sie die aktuell angewendeten Patches:

• Wenn im m2-hotfixes-Verzeichnis Patches installiert sind, ​ Sie ein Adobe Commerce-Support-Ticket ​, und prüfen Sie gemeinsam mit dem Adobe Commerce-Support, welche Patches weiterhin auf die neue Version angewendet werden können. Entfernen Sie die nicht zutreffenden Patches aus dem m2-hotfixes.

• Wenn [Quality Patches] in der .magento.env.yaml-Datei angewendet wurden, überprüfen Sie, ob diese weiterhin auf die neue Version angewendet werden können. Entfernen Sie die nicht zutreffenden Patches aus dem QUALITY_PATCHES Abschnitt der .magento.env.yaml.

Methode 1: Überprüfen Sie die entsprechenden Versionen in den Versionshinweisen zu Qualitäts-Patches

Methode 2: Anzeigen verfügbarer Patches und Status

Methode 3: Suchen nach Patches

Code-Änderungen hinzufügen, übertragen und per Push übertragen.

git add -A

git commit -m "Upgrade"

git push origin <branch-name>

git add -A ist erforderlich, um alle geänderten Dateien zur Versionsverwaltung hinzuzufügen, da Composer Basispakete marshallt. Sowohl composer install als auch composer update marshallen Dateien aus dem Basispaket (magento/magento2-base und magento/magento2-ee-base) in den Paketstamm.

Die Dateien, die Composer marshallt, gehören zur neuen Version von Adobe Commerce, um die veraltete Version derselben Dateien zu überschreiben. Derzeit ist das Marshalling in Adobe Commerce deaktiviert, sodass Sie die marshallten Dateien zur Quellcodeverwaltung hinzufügen müssen.

Warten Sie auf die Bereitstellung, um das Upgrade abzuschließen.

Überprüfen Sie das Upgrade in Ihrer Integrations-, Staging- oder Produktionsumgebung, indem Sie sich mit SSH anmelden und die Version überprüfen.

php bin/magento --version

Erstellen Sie eine Verzweigung auf Ihrer lokalen Workstation.

Deaktivieren Sie Ihre Erweiterungen nach Bedarf.

Laden Sie, sofern verfügbar, Erweiterungs-Upgrades herunter.

Installieren Sie das Upgrade, wie in der Dokumentation des Drittanbieters beschrieben.

Aktivieren und Testen der Erweiterung.

Fügen Sie die Code-Änderungen hinzu, übertragen Sie sie und übertragen Sie sie auf die Fernbedienung.

Push-Benachrichtigung und Testen in der Integrationsumgebung.

Um in einer Vorproduktionsumgebung zu testen, pushen Sie in die Staging-Umgebung.

Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.

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

magento-cloud ssh

Öffnen Sie die ./app/var/report/<error number>.

Überprüfen Sie die ​ und ermitteln Sie die Ursache des Problems.

Code-Änderungen hinzufügen, übertragen und per Push übertragen.

git add -A && git commit -m "Fixed deployment failure" && git push origin <branch-name>