Uppgradera projektet för att använda ECE-Tools-paketet

Last update: Wed Apr 09 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Moln

Skapat för:

Administratör
Utvecklare

Adobe har ersatt paketen magento/magento-cloud-configuration och magento/ece-patches till förmån för paketet ece-tools, vilket förenklar många molnprocesser. Om du använder ett äldre Adobe Commerce i molninfrastrukturprojekt som inte innehåller ece-tools paketet måste du utföra en manuell uppgradering av projektet en gång.

WARNING

Om projektet innehåller ece-tools paketet kan du hoppa över följande uppgradering. Kontrollera genom att hämta versionen med hjälp av kommandot i php vendor/bin/ece-tools -V den lokala projektrotkatalogenCommerce.

Den här projektuppgraderingsprocessen kräver att du uppdaterar versionsbegränsningen magento/magento-cloud-metapackage composer.json i filen i rotkatalogen. Den här begränsningen gör det möjligt att uppdatera Adobe Commerce på metapaket för molninfrastruktur, inklusive att ta bort inaktuella paket, utan att uppgradera din nuvarande Adobe Commerce-version.

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.

Ta bort föråldrade paket

Innan du utför en uppgradering för att använda ece-tools paketet bör du kontrollera composer.lock filen för följande föråldrade paket:

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

Uppdatera metapaketet

Varje Adobe Commerce-version kräver olika begränsningar baserat på följande:

>=current_version <next_version

För current_versionanger du den Adobe Commerce-version som ska installeras.
För next_versionanger du nästa korrigeringsversion efter det värde som anges i current_version.

Om du vill installera Adobe Commerce 2.3.5-p2 anger du current_version till 2.3.5 och next_version till 2.3.6. Begränsningen ">=2.3.5 <2.3.6" installerar det senaste tillgängliga paketet för 2.3.5.

Du kan alltid hitta den senaste metapaketbegränsningen i mallenmagento-cloud.

I följande exempel placeras en begränsning för metapaketet Adobe Commerce om molninfrastruktur för alla versioner som är större än eller lika med den aktuella versionen 2.4.8 och lägre än nästa version 2.4.9:

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

Uppgradera projektet

För att uppgradera ditt projekt till att använda ece-tools paketet måste du uppdatera metapaketet och hooks-egenskaperna .magento.app.yaml , och utföra en Composer-uppdatering.

Så här uppgraderar du projektet till att använda ece-tools:

Uppdatera versionsbegränsningen magento/magento-cloud-metapackage i composer.json filen.

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

Uppdatera metapaketet.

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

Ändra hook-kommandona i magento.app.yaml filen.

code language-yaml

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

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

Sök efter och ta bort de borttagna paketen. De borttagna paketen kan förhindra en lyckad uppgradering.

code language-bash
`composer remove magento/magento-cloud-configuration`

code language-bash
`composer remove magento/ece-patches`

Du kan behöva uppdatera paketet ece-tools.

code language-bash
`composer update magento/ece-tools`

Lägg till och checka in kodändringarna. I det här exemplet har följande filer uppdaterats:

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

Skicka kodändringarna till fjärrservern och sammanfoga den här grenen med grenen integration .

code language-bash
`git push origin <branch-name>`

recommendation-more-help

7c2b03ac-000c-497d-aba3-2c6dc720a938