Actualizar proyecto para utilizar el paquete ECE-Tools

El Adobe ha desaprobado los paquetes magento/magento-cloud-configuration y magento/ece-patches en favor del paquete ece-tools, lo que simplifica muchos procesos de la nube. Si usa un proyecto de infraestructura de Adobe Commerce en la nube más antiguo que no contiene el paquete ece-tools, debe realizar un único proceso de actualización manual del proyecto.

WARNING
Si el proyecto contiene el paquete ece-tools, puede omitir la siguiente actualización. Para comprobarlo, recupere la versión Commerce mediante el comando php vendor/bin/ece-tools -V en el directorio raíz del proyecto local.

Este proceso de actualización de proyecto requiere que actualice la restricción de versión magento/magento-cloud-metapackage en el archivo composer.json en el directorio raíz. Esta restricción permite actualizar Adobe Commerce en los metapaquetes de infraestructura en la nube (incluida la eliminación de paquetes obsoletos) sin actualizar la versión actual de Adobe Commerce.

TIP
Antes de comenzar una actualización o un proceso de aplicación de parches, cree una rama activa desde el entorno de integración y extraiga la nueva rama a su estación de trabajo local. La dedicación de una rama al proceso de actualización o de revisión ayuda a evitar interferencias con el trabajo en curso.

Eliminación de paquetes obsoletos

Antes de realizar una actualización para usar el paquete ece-tools, busque los siguientes paquetes obsoletos en el archivo composer.lock:

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

Actualización del metapaquete

Cada versión de Adobe Commerce requiere una restricción diferente en función de lo siguiente:

>=current_version <next_version
  • Para current_version, especifique la versión de Adobe Commerce que desea instalar.
  • Para next_version, especifique la siguiente versión del parche después del valor especificado en current_version.

Si desea instalar Adobe Commerce 2.3.5-p2, establezca current_version en 2.3.5 y next_version en 2.3.6. La restricción ">=2.3.5 <2.3.6" instala el último paquete disponible para 2.3.5.

Siempre puede encontrar la restricción de metapackage más reciente en la plantilla magento-cloud.

El siguiente ejemplo coloca una restricción para el metapaquete de infraestructura en la nube de Adobe Commerce en cualquier versión superior o igual a la versión actual 2.4.7 e inferior a la siguiente versión 2.4.8:

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

Actualizar el proyecto

Para actualizar el proyecto de modo que utilice el paquete ece-tools, debe actualizar las propiedades del metapaquete y los vínculos .magento.app.yaml, y realizar una actualización del Compositor.

Para actualizar el proyecto y usar ece-tools:

  1. Actualizar la restricción de versión magento/magento-cloud-metapackage en el archivo composer.json.

    code language-bash
    composer require "magento/magento-cloud-metapackage":">=2.4.7 <2.4.8" --no-update
    
  2. Actualice el metapaquete.

    code language-bash
    composer update magento/magento-cloud-metapackage
    
  3. Modifique los comandos de enlace en el archivo magento.app.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
    
  4. Busque y elimine paquetes obsoletos. Los paquetes obsoletos pueden impedir que la actualización se realice correctamente.

    code language-bash
    composer remove magento/magento-cloud-configuration
    
    code language-bash
    composer remove magento/ece-patches
    
  5. Puede que sea necesario actualizar el paquete ece-tools.

    code language-bash
    composer update magento/ece-tools
    
  6. Añada y confirme los cambios de código. En este ejemplo, se actualizaron los siguientes archivos:

    code language-none
    .magento.app.yaml
    composer.json
    composer.lock
    
  7. Inserte los cambios de código en el servidor remoto y combine esta rama con la rama integration.

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