Upgrade der Commerce-Version

Erstellen Sie eine Kopie der Datei "config.local.php" und nennen Sie sie "config.php".

Fügen Sie diese Datei zum Ordner app/etc Ihres Projekts hinzu.

Fügen Sie die Datei hinzu und übertragen Sie sie in Ihre Verzweigung.

Schicken Sie die Datei an Ihre Integrationsverzweigung.

Fahren Sie mit dem Upgrade-Prozess fort.

Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis.

Sehen Sie sich Ihre Integrationsverzweigung an.

Öffnen Sie die Datei "composer.json" in einem Texteditor.

Überprüfen Sie den Abschnitt autoload:psr-4 für die Implementierung des Zend-Plug-in-Managers für die Abhängigkeit der Controller.

 "autoload": {
    "psr-4": {
       "Magento\\Framework\\": "lib/internal/Magento/Framework/",
       "Magento\\Setup\\": "setup/src/Magento/Setup/",
       "Magento\\": "app/code/Magento/",
       "Zend\\Mvc\\Controller\\": "setup/src/Zend/Mvc/Controller/"
    },
}

Wenn die Zend-Abhängigkeit fehlt, aktualisieren Sie die Datei "composer.json":

• Fügen Sie die folgende Zeile zum Abschnitt autoload:psr-4 hinzu.

  code language-json
  "Zend\\Mvc\\Controller\\": "setup/src/Zend/Mvc/Controller/"

• Aktualisieren Sie die Projektabhängigkeiten.

  code language-bash
  composer update

• Hinzufügen, Übertragen und Push-Code-Änderungen.

  code language-bash
  git add -A

  code language-bash
  git commit -m "Add Zend plugin manager implementation for controllers dependency for Laminas support"

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

• Zusammenführen von Änderungen in der Staging-Umgebung und dann in der Produktion.

Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis.

Öffnen und bearbeiten Sie die Datei "magento.app.yaml".

Aktualisieren Sie die PHP-Optionen.

type: php:8.3

build:
    flavor: none
dependencies:
    php:
        composer/composer: '2.7.2'

Ändern Sie die Befehle hooks property build und deploy.

hooks:
    # We run build hooks before your application has been packaged.
    build: |
        set -e
        composer install
        php ./vendor/bin/ece-tools run scenario/build/generate.xml
        php ./vendor/bin/ece-tools run scenario/build/transfer.xml
    # We run deploy hook after your application has been deployed and started.
    deploy: |
        php ./vendor/bin/ece-tools run scenario/deploy.xml
    # We run post deploy hook to clean and warm the cache. Available with ECE-Tools 2002.0.10.
    post_deploy: |
        php ./vendor/bin/ece-tools run scenario/post-deploy.xml

Fügen Sie die folgenden Umgebungsvariablen am Ende der Datei hinzu.

Für Adobe Commerce 2.2.x bis 2.3.x-

variables:
    env:
        CONFIG__DEFAULT__PAYPAL_ONBOARDING__MIDDLEMAN_DOMAIN: 'payment-broker.magento.com'
        CONFIG__STORES__DEFAULT__PAYMENT__BRAINTREE__CHANNEL: 'Magento_Enterprise_Cloud_BT'
        CONFIG__STORES__DEFAULT__PAYPAL__NOTATION_CODE: 'Magento_Enterprise_Cloud'

Für Adobe Commerce 2.4.x-

variables:
    env:
        CONFIG__DEFAULT__PAYPAL_ONBOARDING__MIDDLEMAN_DOMAIN: 'payment-broker.magento.com'
        CONFIG__STORES__DEFAULT__PAYPAL__NOTATION_CODE: 'Magento_Enterprise_Cloud'

Speichern Sie die Datei. Übertragen oder pushen Sie noch keine Änderungen in die Remote-Umgebung.

Fahren Sie mit dem Upgrade-Prozess fort.

Fügen Sie dem Abschnitt config den 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 die folgende Komponente zum Abschnitt extra:component_paths hinzu:

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

Speichern Sie die Datei. Übertragen oder pushen Sie noch keine Änderungen in Ihren Zweig.

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 Sie eine große Anzahl statischer Dateien haben, die sich bereits in der Quell-Code-Verwaltung befinden.

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

Erstellen Sie einen Datenbank-Dump. Verwenden Sie die Option --dump-directory , um ein Zielverzeichnis für den DB-Dump auszuwählen.

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 zum Projektverzeichnis.

Legen Sie die Upgrade-Version mit der Syntax der Versionsbegrenzung fest.

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

Aktualisieren Sie das Projekt.

composer update

Überprüfen Sie die derzeit angewendeten Patches:

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

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

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

Methode 2: Verfügbare Patches und Status anzeigen

Methode 3: Suche nach Patches

Hinzufügen, Übertragen und Push-Code-Änderungen.

git add -A

git commit -m "Upgrade"

git push origin <branch-name>

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

Die Dateien, die Composer marschiert, gehören zur neuen Version von Adobe Commerce, um die veraltete Version dieser Dateien zu überschreiben. Derzeit ist das Marshalling in Adobe Commerce deaktiviert. Daher müssen Sie die marshaled -Dateien zur Quell-Code-Verwaltung hinzufügen.

Warten Sie, bis die Bereitstellung abgeschlossen ist.

Überprüfen Sie das Upgrade in Ihrer Integration-, Staging- oder Produktionsumgebung, indem Sie SSH verwenden, um sich anzumelden und die Version zu überprüfen.

php bin/magento --version

Verwenden Sie vom Terminal einen SSH-Befehl, um die Datei /app/etc/config.php für die Umgebung zu generieren.

ssh <SSH-URL> "<Command>"

Beispiel: Führen Sie für Pro den scd-dump -Vorgang für die Verzweigung integration aus:

ssh <project-id-integration>@ssh.us.magentosite.cloud "php vendor/bin/ece-tools config:dump"

Übertragen Sie die config.php -Datei mit rsync oder scp auf Ihre lokalen Workstations. Sie können diese Datei nur lokal zum Zweig hinzufügen.

rsync <SSH-URL>:app/etc/config.php ./app/etc/config.php

Hinzufügen, Übertragen und Push-Code-Änderungen.

git add app/etc/config.php && git commit -m "Add system-specific configuration" && git push origin master

Dadurch wird eine aktualisierte /app/etc/config.php -Datei mit einer Modulliste und Konfigurationseinstellungen generiert.

Erstellen Sie eine Verzweigung auf Ihrer lokalen Workstation.

Deaktivieren Sie Ihre Erweiterungen nach Bedarf.

Sofern verfügbar, laden Sie Erweiterungs-Upgrades herunter.

Installieren Sie das Upgrade wie in der Dokumentation von Drittanbietern beschrieben.

Aktivieren und testen Sie die Erweiterung.

Fügen Sie die Codeänderungen hinzu, übertragen Sie sie und übertragen Sie sie auf die Remote-Umgebung.

Senden Sie Push-Benachrichtigungen an Ihre Integrationsumgebung und testen Sie sie.

Push in die Staging-Umgebung, um sie in einer Produktionsumgebung zu testen.

Wechseln Sie auf Ihrer lokalen Workstation zum Projektverzeichnis.

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

magento-cloud ssh

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

Überprüfen Sie die Protokolle und ermitteln Sie die Quelle des Problems.

Hinzufügen, Übertragen und Push-Code-Änderungen.

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