DocumentatieCommerceUpgradehandleiding

Een upgrade uitvoeren

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ervaren
  • Beheerder
  • Ontwikkelaar

U kunt op-gebouw plaatsingen van de toepassing van Adobe Commerce van de bevellijn bevorderen als u de software door installeerde:

  • Het pakket Composer-metagegevens downloaden met de opdracht composer create-project .
  • Het gecomprimeerde archief installeren.
NOTE

De volgende instructies tonen u hoe te om te bevorderen gebruikend Composer pakketmanager. Adobe Commerce 2.4.2 introduceerde ondersteuning voor Composer 2. Als u probeert om van <2.4.1 te bevorderen, moet u eerst aan een versie bevorderen die met Composer 2 (bijvoorbeeld, 2.4.2) compatibel is gebruikend Composer 1 vóór bevordering aan Composer 2 voor >2.4.2 verbeteringen. Bovendien moet u a gesteunde versievan PHP in werking stellen.

WARNING
De procedure voor de modernisering van Adobe Commerce is gewijzigd. U moet een nieuwe versie van het magento/composer-root-update-plugin pakket installeren (zie eerste vereisten). Bovendien zijn de opdrachten voor de upgrade gewijzigd van composer require magento/<package_name> in composer require-commerce magento/<package_name> .

Voordat u begint

U moet de verbeteringseerste vereistenvoltooien om uw milieu voor te bereiden alvorens het verbeteringsproces te beginnen.

Pakketten beheren

NOTE
Zie de voorbeelden aan het einde van deze sectie voor hulp bij het opgeven van verschillende releaseniveaus. Bijvoorbeeld kwaliteitspatches en beveiligingspatches. Neem contact op met Adobe Commerce Support als u deze pakketten niet kunt vinden in Composer.

  1. Schakel over naar de onderhoudsmodus om toegang tot uw winkel tijdens het upgradeproces te voorkomen.

    code language-bash 
    bin/magento maintenance:enable

    Zie toelaten of onderhoudswijzevoor extra opties onbruikbaar maken. Naar keuze, kunt u a pagina van de de wijze van het douaneonderhoudtot stand brengen.

  2. De aanvang van het verbeteringsproces terwijl de asynchrone processen, zoals de consumenten van de berichtrij, lopen kan gegevenscorruptie veroorzaken. Schakel alle snijtaken uit om gegevensbeschadiging te voorkomen.

    Adobe Commerce op wolkeninfrastructuur:

    code language-bash 
    ./vendor/bin/ece-tools cron:disable

    Magento Open Source:

    code language-bash 
    bin/magento cron:remove

  3. Start handmatig alle gebruikers in de wachtrij met berichten om ervoor te zorgen dat alle berichten worden verbruikt.

    code language-bash 
    bin/magento cron:run --group=consumers

    Wacht tot de uitsnijdtaak is voltooid. U kunt de status van de taak met een procesviewer of door de opdracht ps aux | grep 'bin/magento queue' meerdere keren uit te voeren totdat alle processen zijn voltooid.

  4. Maak een back-up van het composer.json -bestand.

    code language-bash 
    cp composer.json composer.json.bak

  5. Voeg specifieke pakketten toe of verwijder deze op basis van uw behoeften.

    Als u bijvoorbeeld een upgrade uitvoert van de Magento Open Source naar Adobe Commerce, verwijdert u het pakket Magento Open Source.

    code language-bash 
    composer remove magento/product-community-edition --no-update

    U kunt voorbeeldgegevens ook bijwerken.

    code language-bash 
    composer require <sample data module-1>:<version> ... <sample data module-n>:<version> --no-update

    • Adobe Commerce:

      code language-bash 
      composer require magento/module-bundle-sample-data:100.4.* magento/module-widget-sample-data:100.4.* magento/module-theme-sample-data:100.4.* magento/module-catalog-sample-data:100.4.* magento/module-customer-sample-data:100.4.* magento/module-cms-sample-data:100.4.*  magento/module-catalog-rule-sample-data:100.4.* magento/module-sales-rule-sample-data:100.4.* magento/module-review-sample-data:100.4.* magento/module-tax-sample-data:100.4.* magento/module-sales-sample-data:100.4.* magento/module-grouped-product-sample-data:100.4.* magento/module-downloadable-sample-data:100.4.* magento/module-msrp-sample-data:100.4.* magento/module-configurable-sample-data:100.4.* magento/module-product-links-sample-data:100.4.* magento/module-wishlist-sample-data:100.4.* magento/module-swatches-sample-data:100.4.* magento/sample-data-media:100.4.* magento/module-offline-shipping-sample-data:100.4.* magento/module-gift-card-sample-data:100.4.* magento/module-customer-balance-sample-data:100.4.* magento/module-target-rule-sample-data:100.4.* magento/module-gift-registry-sample-data:100.4.* magento/module-multiple-wishlist-sample-data:100.4.* --no-update

    • Magento Open Source:

      code language-bash 
      composer require magento/module-bundle-sample-data:100.4.* magento/module-widget-sample-data:100.4.* magento/module-theme-sample-data:100.4.* magento/module-catalog-sample-data:100.4.* magento/module-customer-sample-data:100.4.* magento/module-cms-sample-data:100.4.*  magento/module-catalog-rule-sample-data:100.4.* magento/module-sales-rule-sample-data:100.4.* magento/module-review-sample-data:100.4.* magento/module-tax-sample-data:100.4.* magento/module-sales-sample-data:100.4.* magento/module-grouped-product-sample-data:100.4.* magento/module-downloadable-sample-data:100.4.* magento/module-msrp-sample-data:100.4.* magento/module-configurable-sample-data:100.4.* magento/module-product-links-sample-data:100.4.* magento/module-wishlist-sample-data:100.4.* magento/module-swatches-sample-data:100.4.* magento/sample-data-media:100.4.* magento/module-offline-shipping-sample-data:100.4.* --no-update

  6. Voer een upgrade uit op uw instantie met behulp van de volgende opdrachtsyntaxis composer require-commerce :

    code language-bash 
    composer require-commerce magento/<product> <version> --no-update [--interactive-root-conflicts] [--force-root-updates] [--help]

    Opdrachtopties zijn:

    • <product> — (Vereist) Het pakket dat moet worden bijgewerkt. Voor installaties op locatie moet deze waarde product-community-edition of product-enterprise-edition zijn.

    • <version> — (Vereist) De versie van Adobe Commerce waarnaar u een upgrade uitvoert. Bijvoorbeeld 2.4.3 .

    • --no-update — (Vereist) maakt de automatische update van de gebiedsdelen onbruikbaar.

    • --interactive-root-conflicts — (Optioneel) Hiermee kunt u op interactieve wijze verouderde waarden uit eerdere versies of aangepaste waarden die niet overeenkomen met de versie waarnaar u de upgrade uitvoert, weergeven en bijwerken.

    • --force-root-updates — (Optioneel) Hiermee worden alle conflicterende aangepaste waarden genegeerd met de verwachte Commerce-waarden.

    • --help — (Optioneel) Hiermee worden gebruiksgegevens over de plug-in weergegeven.

    Als --interactive-root-conflicts noch --force-root-updates zijn opgegeven, behoudt de opdracht de bestaande waarden in conflict en wordt een waarschuwingsbericht weergegeven. Meer over de stop leren, verwijs naar ReADME van het Gebruik van de Insteekmodule.

  7. Werk de gebiedsdelen bij.

    code language-bash 
    composer update

Voorbeeld - beschikbare versies weergeven

De volledige lijst met beschikbare 2.4.x-versies weergeven:

Magento Open Source:

composer show magento/product-community-edition 2.4.* --available | grep -m 1 versions

Adobe Commerce:

composer show magento/product-enterprise-edition 2.4.* --available | grep -m 1 versions

Voorbeeld - Kwaliteitspatch

De flarden van de kwaliteit bevatten hoofdzakelijk functionele en veiligheidsmoeilijke situaties. Soms kunnen ze echter wel nieuwe, achterwaartse compatibele functies bevatten. Gebruik Composer om een kwaliteitspatch te downloaden.

Adobe Commerce:

composer require-commerce magento/product-enterprise-edition 2.4.6 --no-update

Magento Open Source:

composer require-commerce magento/product-community-edition 2.4.6 --no-update

Voorbeeld - Beveiligingspatch

Beveiligingspatches bevatten alleen beveiligingsoplossingen. Ze zijn ontworpen om het upgradeproces sneller en eenvoudiger te maken. Beveiligingspatches maken gebruik van de naamgevingsconventie van Composer 2.4.x-px .

Adobe Commerce:

composer require-commerce magento/product-enterprise-edition 2.4.6-p3 --no-update

Magento Open Source:

composer require-commerce magento/product-community-edition 2.4.6-p3 --no-update

Metagegevens bijwerken

  1. Werk de velden "name" , "version" en "description" in het composer.json -bestand naar wens bij.

    note note
    NOTE
    Het bijwerken van de metagegevens in het composer.json -bestand is volledig oppervlakkig, niet functioneel.

  2. Updates toepassen.

    code language-bash 
    composer update

  3. Wis de submappen var/ en generated/ :

    code language-bash 
    rm -rf var/cache/*
    code language-bash 
    rm -rf var/page_cache/*
    code language-bash 
    rm -rf generated/code/*
    note note
    NOTE
    Als u een geheim voorgeheugenopslag buiten het filesystem, zoals Redis of Geheugen gebruikt, moet u het geheime voorgeheugen ook daar manueel ontruimen.

  4. Werk het databaseschema en de gegevens bij.

    code language-bash 
    bin/magento setup:upgrade

  5. Onderhoudsmodus uitschakelen.

    code language-bash 
    bin/magento maintenance:disable

  6. (Facultatief) begin Varnish opnieuw.

    Als u Varnish gebruikt voor het in cache plaatsen van pagina's, begin het opnieuw:

    code language-bash 
    service varnish restart

Uw werk controleren

Als u wilt controleren of de upgrade is gelukt, opent u de URL van de winkel in een webbrowser. Als de upgrade is mislukt, wordt de winkel niet correct geladen.

Als de toepassing mislukt met een We're sorry, an error has occurred while generating this email. -fout:

  1. De eigendom van het het dossiersysteem van het terugstellen en toestemmingenals gebruiker met root voorrechten.

  2. Wis de volgende directory's:

    • var/cache/
    • var/page_cache/
    • generated/code/

  3. Controleer de winkel opnieuw in uw webbrowser.

recommendation-more-help
83a60e0e-8849-4685-a8cd-c129ecd795ea