Commerce-Version aktualisieren

Kopie erstellen von config.local.php Datei und Benennen config.php.

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

Fügen Sie die Datei zu Ihrer Verzweigung hinzu und übertragen Sie sie.

Übertragen Sie die Datei in die Integrationsverzweigung.

Fahren Sie mit dem Upgrade-Prozess fort.

Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.

Sehen Sie sich Ihre Integrationsverzweigung an.

Öffnen Sie composer.json -Datei in einem Texteditor speichern.

Überprüfen Sie die autoload:psr-4 -Abschnitt für die Zend Plug-in Manager-Implementierung für Controller-Abhängigkeiten.

 "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 composer.json Datei:

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

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

• Aktualisieren Sie die Projektabhängigkeiten.

  code language-bash
  composer update

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

  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 anschließend in der Produktion.

Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.

Öffnen und bearbeiten Sie magento.app.yaml -Datei.

Aktualisieren Sie die PHP-Optionen.

type: php:8.3

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

Ändern Sie die hooks Eigenschaft build und deploy Befehle.

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. Übernehmen oder übertragen Sie noch keine Änderungen an die Remote-Umgebung.

Fahren Sie mit dem Upgrade-Prozess fort.

Folgendes hinzufügen allow-plugins in die config Bereich:

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

Fügen Sie das folgende Plug-in zur hinzu. require Bereich:

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

Fügen Sie die folgende Komponente zur hinzu extra:component_paths Bereich:

"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 auslassen [--media] Wenn Sie über eine große Anzahl von statischen Dateien verfügen, die sich bereits in der Versionsverwaltung befinden.

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

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

vendor/bin/ece-tools db-dump

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

Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.

Legen Sie die Upgrade-Version mithilfe der Syntax der Versionsbeschränkung.

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

Aktualisieren Sie das Projekt.

composer update

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. Beide composer install und composer update Marshallen von Dateien aus dem Basispaket (magento/magento2-base und magento/magento2-ee-base) in den Paketstamm geschrieben.

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 Quell-Code-Verwaltung hinzufügen müssen.

Warten Sie, bis die Bereitstellung abgeschlossen ist.

Ü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

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

ssh <SSH-URL> "<Command>"

So führen Sie beispielsweise für Pro Folgendes aus: scd-dump am integration Verzweigung:

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

Übertragen Sie die config.php Datei auf den lokalen Workstations mithilfe von rsync oder scp. Sie können diese Datei nur lokal zur Verzweigung hinzufügen.

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

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

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

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

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 Ihrer Integrationsumgebung.

Pushen Sie in die Staging-Umgebung, um sie in einer Vorproduktionsumgebung zu testen.

Wechseln Sie auf Ihrer lokalen Workstation in Ihr Projektverzeichnis.

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

magento-cloud ssh

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

Überprüfen der Protokolle 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>