DocumentatieCommerceHandleiding voor Commerce in de cloud

[Alleen PaaS]{class="badge informative" title="Is alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur) en op projecten in het veld."}

Commerce-versie upgraden

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

Gemaakt voor:

  • Beheerder
  • Ontwikkelaar

U kunt de Adobe Commerce-codebasis upgraden naar een nieuwere versie. Alvorens uw project te bevorderen, herzie de vereisten van het Systeemin de gids van de Installatie voor de recentste vereisten van de softwareversie.

Afhankelijk van uw projectconfiguratie, kunnen uw verbeteringstaken het volgende omvatten:

  • Werk het .magento/services.yaml -bestand bij met nieuwe versies voor MariaDB (MySQL), OpenSearch, RabbitMQ en Redis voor compatibiliteit met nieuwe Adobe Commerce-versies.
  • Werk het .magento.app.yaml dossier met nieuwe montages voor haken en omgevingsvariabelen bij.
  • Voer een upgrade uit van externe extensies naar de nieuwste ondersteunde versie.
TIP
Voordat u met een upgrade of een patchproces begint, maakt u een actieve vertakking vanuit de integratieomgeving en checkt u de nieuwe vertakking uit naar uw lokale werkstation. Als u een vertakking aan de upgrade of het patchproces toewijst, voorkomt u dat uw werk wordt gehinderd.
recommendation-more-help

  • Voor Pro projecten, moet u een kaartje van de Steun van Adobe Commercevoorleggen om dienstenin Staging en Production slechts milieu's te installeren of bij te werken.

  • Geef aan welke servicewijzigingen nodig zijn, neem de bijgewerkte .magento.app.yaml - en services.yaml -bestanden op en geef de PHP-versie op in het ticket. Voor zelfbedienings veranderingen in PHP versie, uitbreidingen, of milieu montages, zie PHP montagesin configuratie van de Toepassing.

  • Voor veranderingen in een levende milieu van de Productie (slechts Pro), wordt een minimum van 48 uurverklaring vereist. Hierdoor kan het infrastructuurteam van de cloud voldoende tijd krijgen om bronnen te bundelen en een veilige upgrade uit te voeren. De opzegtermijn begint wanneer het infrastructuurteam de aanvraag erkent en de upgrade plant, met uitzondering van weekends. Bijvoorbeeld, om de dienstverbeteringen te hebben op een maandag worden voltooid, moet een erkenning van de geplande verbetering tegen Woensdag worden ontvangen. Tijdens piekvraagperiodes, zou het meer tijd kunnen vergen om uw verzoek te verwerken.

style
shade-box

Configuratiebestanden

Voordat u de toepassing kunt upgraden, moet u de projectconfiguratiebestanden bijwerken om rekening te houden met wijzigingen in de standaardconfiguratie-instellingen voor Adobe Commerce op de cloudinfrastructuur of de toepassing. De recentste gebreken kunnen in de magento-cloud bewaarplaats GitHubworden gevonden.

composer.json

Controleer voordat u de upgrade uitvoert of de afhankelijkheden in het composer.json -bestand compatibel zijn met de Adobe Commerce-versie.

U kunt als volgt het composer.json -bestand voor Adobe Commerce versie 2.4.4 en hoger** bijwerken:

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

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

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

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

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

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

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

  5. Ga door met het upgradeproces.

Projectback-up

We raden u aan een back-up van uw project te maken voordat u de upgrade uitvoert. Gebruik de volgende stappen om een back-up te maken van uw integratie-, staging- en productieomgevingen.

aan file uw gegevensbestand van het integratiemilieu en code:

  1. Maak een lokale back-up van de externe database.

    code language-bash 
    magento-cloud db:dump
    note note
    NOTE
    Het magento-cloud db:dump bevel stelt het mysqldumpbevel met de --single-transaction vlag in werking, die u aan file uw gegevensbestand zonder de lijsten te sluiten toestaat.

  2. Maak een back-up van code en media.

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

aan file uw het Staging of milieu gegevensbestand van de Productie alvorens op te stellen:

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

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

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

Toepassingsupgrade

Herzie de informatie van de de dienstversiesvoor de recentste vereisten van de softwareversie alvorens uw toepassing te bevorderen.

om de toepassingsversie te bevorderen:

  1. Wijzig op uw lokale werkstation de projectmap.

  2. Plaats de versiebeperkingvoor de versie van de doelverbetering. Deze stap is alleen nodig als de doelversie zich buiten de bestaande beperking bevindt.

    code language-bash 
    composer require-commerce "magento/magento-cloud-metapackage":">=CURRENT_VERSION <NEXT_VERSION" --no-update
    note note
    NOTE
    U moet de syntaxis van de versiebeperking gebruiken om het ece-tools -pakket bij te werken. U kunt de versiebeperking in het composer.json dossier voor de versie van het toepassingsmalplaatjevinden u voor de verbetering gebruikt.

  3. Werk uw composer.json -bestand bij met de belangrijkste Commerce-upgradeversie.

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

  4. Als u B2B gebruikt, werk uw composer.json dossier met de gesteunde versievoor Commerce bij.

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

  5. Projectafhankelijkheden bijwerken.

    code language-bash 
    composer update

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

  7. Wijzigingen in code toevoegen, vastleggen en doorvoeren.

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

  8. Wacht tot de implementatie is voltooid.

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

    code language-bash 
    php bin/magento --version

Extensies upgraden

Bekijk de extensie- en modulepagina's van derden in Marketplace of andere bedrijfssites en controleer de ondersteuning voor Adobe Commerce en Adobe Commerce op cloudinfrastructuur. Als u extensies en modules van derden moet bijwerken, raadt Adobe aan te werken in een nieuwe integratietak met uw extensies uitgeschakeld.

om uw uitbreidingen te verifiëren en te bevorderen:

  1. Maak een vertakking op uw lokale werkstation.

  2. Schakel de extensies desgewenst uit.

  3. Indien beschikbaar, downloadextensies voor upgrades.

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

  5. Schakel de extensie in en test deze.

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

  7. Zet uw integratieomgeving aan en test deze.

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

Adobe adviseert sterk bevordering uw milieu van de Productie vóór met inbegrip van de promotieuitbreidingen in uw proces van de plaatslancering.

NOTE
Wanneer u uw toepassingsversie bevordert, werkt het verbeteringsproces aan de recentste versie van de Snelle CDN moduleautomatisch bij.

Upgrade problemen oplossen

Als de upgrade is mislukt, ontvangt u een foutbericht in de browser waarin wordt aangegeven dat u geen toegang hebt tot uw winkel of het deelvenster Beheer:

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

om de fout op te lossen:

  1. Wijzig op uw lokale werkstation de projectmap.

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

    code language-bash 
    magento-cloud ssh

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

  4. onderzoek de logboekenen bepaal de bron van de kwestie.

  5. Wijzigingen in code toevoegen, vastleggen en doorvoeren.

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