Commerce-versie upgraden

Maak een kopie van het config.local.php -bestand en noem het config.php .

Voeg dit bestand toe aan de map app/etc van uw project.

Voeg het bestand toe en wijs het toe aan uw vertakking.

Verplaats het bestand naar de integratietak.

Ga door met het upgradeproces.

Wijzig op uw lokale werkstation de projectmap.

Ontdek je integratietak.

Open het composer.json -bestand in een teksteditor.

Controleer de sectie autoload:psr-4 voor de Zend plugin manager implementatie voor controlemechanismeafhankelijkheid.

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

Als de Zend-afhankelijkheid ontbreekt, werkt u het composer.json -bestand bij:

• Voeg de volgende regel toe aan de sectie autoload:psr-4 .

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

• Werk de projectgebiedsdelen bij.

  code language-bash
  composer update

• Wijzigingen in code toevoegen, vastleggen en doorvoeren.

  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>

• Voeg de wijzigingen in de Staging-omgeving en vervolgens in Production samen.

Wijzig op uw lokale werkstation de projectmap.

Open en bewerk het magento.app.yaml -bestand.

Werk de PHP-opties bij.

type: php:8.3

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

Wijzig de opdrachten hooks property build en 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

Voeg de volgende omgevingsvariabelen toe aan het einde van het bestand.

Voor Adobe Commerce 2.2.x tot en met 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'

Voor 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'

Sla het bestand op. Breng nog geen wijzigingen aan in de externe omgeving.

Ga door met het upgradeproces.

Voeg het volgende allow-plugins toe aan de sectie config :

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

Voeg de volgende plug-in toe aan de sectie require :

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

Voeg de volgende component toe aan de sectie extra:component_paths :

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

Sla het bestand op. Wijzig de vertakking nog niet en duw er nog niet op.

Ga door met het upgradeproces.

Maak een lokale back-up van de externe database.

magento-cloud db:dump

Maak een back-up van code en media.

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

U kunt [--media] ook weglaten als u een groot aantal statische bestanden hebt die al in bronbeheer staan.

Gebruik SSH om u aan te melden bij de externe omgeving.

Creeer a gegevensbestandstortplaats. Als u een doelmap voor de DB-dump wilt kiezen, gebruikt u de optie --dump-directory .

vendor/bin/ece-tools db-dump

Met de dump-bewerking maakt u een dump-<timestamp>.sql.gz archiefbestand in uw externe projectmap. Zie file gegevensbestand.

Wijzig op uw lokale werkstation de projectmap.

Plaats de verbeteringsversie gebruikend de syntaxis van de versiebeperking.

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

Werk het project bij.

composer update

Bekijk de patches die momenteel worden toegepast:

• Als er om het even welke die flarden in de m2-hotfixes folder worden geïnstalleerd zijn, voorlegt een kaartje van de Steun van Adobe Commerceen het werk met de Steun van Adobe Commerce om te verifiëren welke flarden nog op de nieuwe versie kunnen worden toegepast. Verwijder de niet-toepasselijke patch(es) uit de map m2-hotfixes .

• Als er om het even welke [ Patches van de Kwaliteit ] in het .magento.env.yaml dossier worden toegepast, verifieer of zij nog op de nieuwe versie kunnen worden toegepast. Verwijder de niet-toepasselijke patch(es) uit de sectie QUALITY_PATCHES van het .magento.env.yaml -bestand.

Methode 1: verifieer de toepasselijke versies in de de versienota's van de Patches van de Kwaliteit

Methode 2: de beschikbare flarden van de Mening en status

Methode 3: Onderzoek naar flarden

Wijzigingen in code toevoegen, vastleggen en doorvoeren.

git add -A

git commit -m "Upgrade"

git push origin <branch-name>

git add -A is vereist om alle gewijzigde bestanden toe te voegen aan bronbesturing vanwege de manier waarop Composer basispakketten marshals. Zowel composer install als composer update marshal dossiers van het basispakket (magento/magento2-base en magento/magento2-ee-base) in de pakketwortel.

De bestanden die Composer marshals hebben, horen bij de nieuwe versie van Adobe Commerce, om de verouderde versie van dezelfde bestanden te overschrijven. Op dit moment is het rangschikken in Adobe Commerce uitgeschakeld, dus u moet de gemarcheerde bestanden toevoegen aan bronbesturing.

Wacht tot de implementatie is voltooid.

Verifieer de verbetering in uw Integratie, het Staging, of milieu van de Productie door SSH te gebruiken om login en de versie te controleren.

php bin/magento --version

Gebruik vanaf de terminal een SSH-opdracht om het /app/etc/config.php -bestand voor de omgeving te genereren.

ssh <SSH-URL> "<Command>"

Als u bijvoorbeeld voor Pro de instructie scd-dump wilt uitvoeren op de integration -vertakking:

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

Breng het config.php -bestand via rsync of scp over naar uw lokale werkstations. U kunt dit bestand alleen lokaal aan de vertakking toevoegen.

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

Wijzigingen in code toevoegen, vastleggen en doorvoeren.

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

Hiermee wordt een bijgewerkt /app/etc/config.php -bestand gegenereerd met een lijst met modules en configuratie-instellingen.

Maak een vertakking op uw lokale werkstation.

Schakel de extensies desgewenst uit.

Indien beschikbaar, downloadextensies voor upgrades.

Installeer de upgrade zoals wordt beschreven in de documentatie van derden.

Schakel de extensie in en test deze.

Voeg de wijzigingen aan de externe code toe, wijs deze aan en duw erop.

Zet uw integratieomgeving aan en test deze.

Druk op de testomgeving om te testen in een pre-productieomgeving.

Wijzig op uw lokale werkstation de projectmap.

Gebruik SSH om u aan te melden bij de externe omgeving.

magento-cloud ssh

Open het ./app/var/report/<error number> -bestand.

onderzoek de logboekenen bepaal de bron van de kwestie.

Wijzigingen in code toevoegen, vastleggen en doorvoeren.

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