DokumentationHandelAnvändarhandbok om Commerce i molnet

[Endast PaaS]{class="badge informative" title="Gäller endast Adobe Commerce i molnprojekt (Adobe-hanterad PaaS-infrastruktur) och lokala projekt."}

Uppgradera Commerce

Last update: Tue Jul 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Administratör
  • Utvecklare

Du kan uppgradera Adobe Commerce kodbas till en nyare version. Innan du uppgraderar ditt projekt bör du läsa Systemkraven i installationshandboken för att få information om de senaste programvaruversionskraven.

Beroende på din projektkonfiguration kan din uppgradering innehålla följande:

  • Uppdatera filen .magento/services.yaml med nya versioner för MariaDB (MySQL), OpenSearch, RabbitMQ och Redis för kompatibilitet med nya Adobe Commerce-versioner.
  • Uppdatera filen .magento.app.yaml med nya inställningar för kopplingar och miljövariabler.
  • Uppgradera tillägg från tredje part till den senaste version som stöds.
TIP
Innan du påbörjar en uppgradering eller en korrigeringsprocess skapar du en aktiv gren i integreringsmiljön och checkar ut den nya grenen till din lokala arbetsstation. Genom att dedikera en gren till uppgraderingen eller korrigeringsprocessen undviker du störningar i pågående arbete.
recommendation-more-help

  • För Pro-projekt måste du skicka en Adobe Commerce Support-biljett om du bara vill installera eller uppdatera tjänster i Staging- och Production-miljöer.

  • Ange vilka tjänständringar som krävs, inkludera dina uppdaterade .magento.app.yaml- och services.yaml-filer och ange PHP-versionen i biljetten. Om du vill göra ändringar i PHP-version, tillägg eller miljöinställningar för självbetjäning läser du PHP-inställningar i Programkonfiguration.

  • För ändringar i en aktiv produktionsmiljö (endast Pro) krävs minst 48 timmars varsel. Detta ger molninfrastruktursteamet tillräckligt med tid för att samla in resurser och genomföra en säker uppgradering. Anmälningsperioden börjar när infrastrukturteamet godkänner begäran och schemalägger uppgraderingen, exklusive helger. Om du t.ex. vill att uppgraderingarna ska vara klara på måndag måste du få en bekräftelse på den schemalagda uppgraderingen senast på onsdagen. Under perioder med hög efterfrågan kan det ta längre tid att behandla din begäran.

style
shade-box

Konfigurationsfiler

Innan du uppgraderar programmet måste du uppdatera dina projektkonfigurationsfiler så att de tar hänsyn till ändringar av standardkonfigurationsinställningarna för Adobe Commerce i molninfrastrukturen eller för programmet. De senaste standardvärdena finns i GitHub-databasen magento-cloud.

composer.json

Kontrollera alltid att beroendena i filen composer.json är kompatibla med Adobe Commerce-versionen innan du uppgraderar.

Så här uppdaterar du filen composer.json för Adobe Commerce version 2.4.4 och senare**:

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

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

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

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

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

    code language-json 
    "extra": {
   "component_paths": {
      "tinymce/tinymce": "lib/web/tiny_mce_5"
   },
},

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

  5. Fortsätt med uppgraderingsprocessen.

Säkerhetskopiering av projekt

Vi rekommenderar att du skapar en säkerhetskopia av ditt projekt före en uppgradering. Gör så här för att säkerhetskopiera integrerings-, mellanlagrings- och produktionsmiljöer.

Så här säkerhetskopierar du databasen och koden för integreringsmiljön:

  1. Skapa en lokal säkerhetskopia av fjärrdatabasen.

    code language-bash 
    magento-cloud db:dump
    note note
    NOTE
    Kommandot magento-cloud db:dump kör kommandot mysqldump med flaggan --single-transaction som gör att du kan säkerhetskopiera databasen utan att låsa tabellerna.

  2. Säkerhetskopiera kod och media.

    code language-bash 
    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.

Så här säkerhetskopierar du databasen för förproduktionsmiljö eller produktionsmiljö innan du distribuerar:

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

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

    code language-bash 
    vendor/bin/ece-tools db-dump

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

Programuppgradering

Granska informationen om tjänstversionerna för de senaste programversionskraven innan du uppgraderar ditt program.

Så här uppgraderar du programversionen:

  1. Byt till din projektkatalog på din lokala arbetsstation.

  2. Ange version-begränsningen för måluppgraderingsversionen. Det här steget är bara nödvändigt om målversionen ligger utanför den befintliga begränsningen.

    code language-bash 
    composer require-commerce "magento/magento-cloud-metapackage":">=CURRENT_VERSION <NEXT_VERSION" --no-update
    note note
    NOTE
    Du måste använda syntaxen för versionsbegränsning för att kunna uppdatera paketet ece-tools. Du hittar versionsbegränsningen i filen composer.json för den version av programmallen som du använder för uppgraderingen.

  3. Uppdatera din composer.json-fil med Commerce viktigaste uppgraderingsversion.

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

  4. Om du använder B2B ska du uppdatera din composer.json-fil med den version som stöds för Commerce.

    code language-bash 
    composer require-commerce magento/extension-b2b 1.5.2 --no-update

  5. Uppdatera projektberoenden.

    code language-bash 
    composer update

  6. 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

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

    code language-bash 
    git add -A
    code language-bash 
    git commit -m "Upgrade"
    code language-bash 
    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.

  8. Vänta tills distributionen är klar.

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

    code language-bash 
    php bin/magento --version

Uppgradera tillägg

Granska tillägg- och modulsidor från tredje part på Marketplace eller andra företagswebbplatser och verifiera stödet för Adobe Commerce och Adobe Commerce i molninfrastrukturen. Om du måste uppgradera tillägg och moduler från tredje part rekommenderar Adobe att du arbetar i en ny integreringsgren med dina tillägg inaktiverade.

Så här verifierar och uppgraderar du dina tillägg:

  1. Skapa en gren på din lokala arbetsstation.

  2. Inaktivera tilläggen efter behov.

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

  4. Installera uppgraderingen enligt dokumentationen från tredje part.

  5. Aktivera och testa tillägget.

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

  7. Kör till och testa i er integreringsmiljö.

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

Adobe rekommenderar starkt att du uppgraderar din produktionsmiljö före, inklusive de uppgraderade tilläggen när du startar webbplatsen.

NOTE
När du uppgraderar din programversion uppdateras uppgraderingsprocessen automatiskt till den senaste versionen av modulen Snabbt CDN .

Felsök uppgraderingen

Om uppgraderingen misslyckades får du ett felmeddelande i webbläsaren om att du inte kan komma åt butiken eller administrationspanelen:

There has been an error processing your request
Exception printing is disabled by default for security reasons.
  Error log record number: <error-number>

Så här löser du felet:

  1. Byt till din projektkatalog på din lokala arbetsstation.

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

    code language-bash 
    magento-cloud ssh

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

  4. Granska loggarna och ta reda på orsaken till problemet.

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

    code language-bash 
    git add -A && git commit -m "Fixed deployment failure" && git push origin <branch-name>
7c2b03ac-000c-497d-aba3-2c6dc720a938