Uppgradera Commerce

Skapa en kopia av filen config.local.php och ge den namnet config.php.

Lägg till den här filen i mappen app/etc i ditt projekt.

Lägg till och implementera filen på din gren.

Skicka filen till din integrationsgren.

Fortsätt med uppgraderingsprocessen.

Byt till din projektkatalog på din lokala arbetsstation.

Ta en titt på er integreringsgren.

Öppna filen composer.json i en textredigerare.

Kontrollera avsnittet autoload:psr-4 för Zend plugin-hanterarimplementering för styrenheternas beroende.

 "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/"
    },
}

Om Zend-beroendet saknas uppdaterar du filen composer.json:

• Lägg till följande rad i avsnittet autoload:psr-4.

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

• Uppdatera projektberoenden.

  code language-bash
  composer update

• Lägg till, implementera och push-ändra kod.

  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>

• Sammanfoga ändringarna i mellanlagringsmiljön och sedan till Produktion.

Byt till din projektkatalog på din lokala arbetsstation.

Öppna och redigera filen magento.app.yaml.

Uppdatera PHP-alternativen.

type: php:8.3

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

Ändra kommandona för hooks-egenskapen build och 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

Lägg till följande miljövariabler i slutet av filen.

För Adobe Commerce 2.2.x till 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'

Spara filen. Verkställ eller skicka inga ändringar till fjärrmiljön än.

Fortsätt med uppgraderingsprocessen.

Lägg till följande allow-plugins i avsnittet config:

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

Lägg till följande plugin-program i avsnittet require:

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

Lägg till följande komponent i avsnittet extra:component_paths:

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

Spara filen. Verkställ eller skicka inte ändringar till din gren än.

Fortsätt med uppgraderingsprocessen.

Skapa en lokal säkerhetskopia av fjärrdatabasen.

magento-cloud db:dump

Säkerhetskopiera kod och media.

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

Du kan också utelämna [--media] om du har ett stort antal statiska filer som redan finns i källkontrollen.

Använd SSH för att logga in i fjärrmiljön.

Skapa en databasdump. Om du vill välja en målkatalog för DB-dumpen använder du alternativet --dump-directory.

vendor/bin/ece-tools db-dump

Dumpningsåtgärden skapar en dump-<timestamp>.sql.gz-arkivfil i fjärrprojektkatalogen. Se Säkerhetskopiera databas.

Byt till din projektkatalog på din lokala arbetsstation.

Ange uppgraderingsversionen med syntaxen för versionsbegränsning.

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

Uppdatera projektet.

composer update

Granska de korrigeringar som används för närvarande:

• Om det finns korrigeringsfiler installerade i katalogen m2-hotfixes skickar du en Adobe Commerce Support-anmälan och arbetar med Adobe Commerce Support för att kontrollera vilka korrigeringsfiler som fortfarande kan användas i den nya versionen. Ta bort den eller de icke tillämpliga korrigeringarna från katalogen m2-hotfixes.

• Om [kvalitetsuppdateringar] används i filen .magento.env.yaml kontrollerar du om de fortfarande kan användas i den nya versionen. Ta bort den eller de korrigeringar som inte är tillämpliga från QUALITY_PATCHES-avsnittet i .magento.env.yaml-filen.

Metod 1: Verifiera tillämpliga versioner i versionsinformationen för kvalitetspatchar

Metod 2: Visa tillgängliga korrigeringar och status

Metod 3: Sök efter korrigeringsfiler

Lägg till, implementera och push-ändra kod.

git add -A

git commit -m "Upgrade"

git push origin <branch-name>

git add -A krävs för att lägga till alla ändrade filer i källkontrollen på grund av hur Composer konverterar baspaket. Både composer install och composer update konverterar filer från baspaketet (magento/magento2-base och magento/magento2-ee-base) till paketroten.

De filer som Composer konverterar tillhör den nya versionen av Adobe Commerce, som skriver över den gamla versionen av samma filer. För närvarande är konvertering inaktiverat i Adobe Commerce, så du måste lägga till de konverterade filerna i källkontrollen.

Vänta tills distributionen är klar.

Verifiera uppgraderingen i integrerings-, mellanlagrings- eller produktionsmiljön genom att använda SSH för att logga in och kontrollera versionen.

php bin/magento --version

Använd ett SSH-kommando från terminalen för att generera filen /app/etc/config.php för miljön.

ssh <SSH-URL> "<Command>"

Om du till exempel vill köra scd-dump på grenen integration i Pro:

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

Överför filen config.php till dina lokala arbetsstationer med rsync eller scp. Du kan bara lägga till den här filen lokalt i grenen.

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

Lägg till, implementera och push-ändra kod.

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

Detta genererar en uppdaterad /app/etc/config.php-fil med en modullista och konfigurationsinställningar.

Skapa en gren på din lokala arbetsstation.

Inaktivera tilläggen efter behov.

Ladda ned tilläggsuppgraderingar när de blir tillgängliga.

Installera uppgraderingen enligt dokumentationen från tredje part.

Aktivera och testa tillägget.

Lägg till, implementera och skicka kodändringarna till fjärrkontrollen.

Kör till och testa i er integreringsmiljö.

Kör till mellanlagringsmiljön för att testa i en förproduktionsmiljö.

Byt till din projektkatalog på din lokala arbetsstation.

Använd SSH för att logga in i fjärrmiljön.

magento-cloud ssh

Öppna filen ./app/var/report/<error number>.

Granska loggarna och ta reda på orsaken till problemet.

Lägg till, implementera och push-ändra kod.

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