DocumentatieCommerceHandleiding Commerce on Cloud Infrastructure

Upgradeproject voor gebruik van het pakket ECE-Tools

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beheerder
  • Ontwikkelaar

Adobe heeft de pakketten magento/magento-cloud-configuration en magento/ece-patches vervangen door het pakket ece-tools , dat veel cloudprocessen vereenvoudigt. Als u een oudere Adobe Commerce op het project van de wolkeninfrastructuur gebruikt dat niet het ece-tools pakket bevat, dan moet u een eenmalig, manueel verbetering proces aan uw project uitvoeren.

WARNING
Als uw project het ece-tools -pakket bevat, kunt u de volgende upgrade overslaan. Als u wilt controleren, haalt u de Commerce -versie op met de opdracht php vendor/bin/ece-tools -V in de lokale hoofdmap van het project.

Voor dit upgradeproces van het project moet u de versiebeperking magento/magento-cloud-metapackage bijwerken in het composer.json -bestand in de hoofdmap. Met deze beperking kunnen updates voor Adobe Commerce worden uitgevoerd op metapakketten voor cloudinfrastructuur, zoals het verwijderen van verouderde pakketten, zonder dat de huidige Adobe Commerce-versie wordt bijgewerkt.

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.

Vervangen pakketten verwijderen

Voordat u een upgrade uitvoert voor het gebruik van het ece-tools -pakket, controleert u het composer.lock -bestand op de volgende verouderde pakketten:

  • magento/magento-cloud-configuration
  • magento/ece-patches

Het pakket metapakketten bijwerken

Voor elke Adobe Commerce-versie is een andere beperking vereist op basis van het volgende:

>=current_version <next_version
  • Geef bij current_version de Adobe Commerce-versie op die u wilt installeren.
  • Geef bij next_version de volgende patchversie op na de waarde die is opgegeven in current_version .

Als u Adobe Commerce 2.3.5-p2 wilt installeren, stelt u current_version in op 2.3.5 en next_version op 2.3.6 . Met de restrictie ">=2.3.5 <2.3.6" wordt het meest recente beschikbare pakket voor 2.3.5 geïnstalleerd.

U kunt de recentste metapakketbeperking in het magento-cloud malplaatjealtijd vinden.

In het volgende voorbeeld wordt een beperking voor het Adobe Commerce-pakket voor de infrastructuur van de cloud geplaatst in elke versie die hoger is dan of gelijk is aan de huidige versie 2.4.7 en lager is dan de volgende versie 2.4.8:

"require": {
    "magento/magento-cloud-metapackage": ">=2.4.7 <2.4.8"
},

Het project upgraden

Als u uw project wilt upgraden voor gebruik van het ece-tools -pakket, moet u het metapakket en de .magento.app.yaml hooks-eigenschappen bijwerken en een Composer-update uitvoeren.

om project te bevorderen om knoop-hulpmiddelen te gebruiken:

  1. Werk de magento/magento-cloud-metapackage version-restrictie in het composer.json -bestand bij.

    code language-bash 
    composer require "magento/magento-cloud-metapackage":">=2.4.7 <2.4.8" --no-update

  2. Werk het metapakket bij.

    code language-bash 
    composer update magento/magento-cloud-metapackage

  3. Wijzig de haakbevelen in het magento.app.yaml dossier.

    code language-yaml 
    hooks:
    # We run build hooks before your application has been packaged.
    build: |
        set -e
        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

  4. Controle voor en verwijder de afgekeurde pakketten. De vervangen pakketten kunnen een geslaagde upgrade verhinderen.

    code language-bash 
    composer remove magento/magento-cloud-configuration
    code language-bash 
    composer remove magento/ece-patches

  5. Het kan nodig zijn om het ece-tools -pakket bij te werken.

    code language-bash 
    composer update magento/ece-tools

  6. Voeg de codewijzigingen toe en wijs deze toe. In dit voorbeeld zijn de volgende bestanden bijgewerkt:

    code language-none 
    .magento.app.yaml
composer.json
composer.lock

  7. Duw de codeveranderingen in de verre server en voeg deze tak met de integration tak samen.

    code language-bash 
    git push origin <branch-name>
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26