Actualizar la versión de Commerce

Cree una copia de config.local.php archivo y asígnele el nombre config.php.

Agregue este archivo a la carpeta app/etc de su proyecto.

Añada y confirme el archivo en su rama.

Inserte el archivo en la rama de integración.

Continúe con el proceso de actualización.

En la estación de trabajo local, cambie al directorio del proyecto.

Consulte la rama de integración.

Abra el archivo composer.json en un editor de texto.

Consulte la sección autoload:psr-4 para ver la implementación de Zend plugin manager para la dependencia de los controladores.

 "autoload": {
    "psr-4": {
       "Magento\\Framework\\": "lib/internal/Magento/Framework/",
       "Magento\\Setup\\": "setup/src/Magento/Setup/",
       "Magento\\": "app/code/Magento/",
       "Zend\\Mvc\\Controller\\": "setup/src/Zend/Mvc/Controller/"
    },
}

Si falta la dependencia Zend, actualice el archivo composer.json:

• Agregue la línea siguiente a la sección autoload:psr-4.

  code language-json
  "Zend\\Mvc\\Controller\\": "setup/src/Zend/Mvc/Controller/"

• Actualice las dependencias del proyecto.

  code language-bash
  composer update

• Agregar, confirmar y enviar cambios de código.

  code language-bash
  git add -A

  code language-bash
  git commit -m "Add Zend plugin manager implementation for controllers dependency for Laminas support"

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

• Combine los cambios en el entorno de ensayo y, a continuación, en Producción.

En la estación de trabajo local, cambie al directorio del proyecto.

Abra y edite el archivo magento.app.yaml.

Actualice las opciones de PHP.

type: php:8.3

build:
    flavor: none
dependencies:
    php:
        composer/composer: '2.7.2'

Modifique los comandos build y deploy de la propiedad hooks.

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

Agregue las siguientes variables de entorno al final del archivo.

Para Adobe Commerce 2.2.x a 2.3.x-

variables:
    env:
        CONFIG__DEFAULT__PAYPAL_ONBOARDING__MIDDLEMAN_DOMAIN: 'payment-broker.magento.com'
        CONFIG__STORES__DEFAULT__PAYMENT__BRAINTREE__CHANNEL: 'Magento_Enterprise_Cloud_BT'
        CONFIG__STORES__DEFAULT__PAYPAL__NOTATION_CODE: 'Magento_Enterprise_Cloud'

Para Adobe Commerce 2.4.x-

variables:
    env:
        CONFIG__DEFAULT__PAYPAL_ONBOARDING__MIDDLEMAN_DOMAIN: 'payment-broker.magento.com'
        CONFIG__STORES__DEFAULT__PAYPAL__NOTATION_CODE: 'Magento_Enterprise_Cloud'

Guarde el archivo. No confirme ni inserte cambios en el entorno remoto aún.

Continúe con el proceso de actualización.

Agregar los(as) siguientes allow-plugins a la sección config:

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

Agregue el siguiente complemento a la sección require:

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

Agregue el siguiente componente a la sección extra:component_paths:

"extra": {
   "component_paths": {
      "tinymce/tinymce": "lib/web/tiny_mce_5"
   },
},

Guarde el archivo. Aún no confirme ni inserte cambios en la rama.

Continúe con el proceso de actualización.

Cree una copia de seguridad local de la base de datos remota.

magento-cloud db:dump

Haga una copia de seguridad del código y los medios.

php bin/magento setup:backup --code [--media]

Opcionalmente, puede omitir [--media] si tiene un gran número de archivos estáticos que ya están en el control de código fuente.

Utilice SSH para iniciar sesión en el entorno remoto.

Crear un volcado de base de datos. Para elegir un directorio de destino para el volcado de la base de datos, utilice la opción --dump-directory.

vendor/bin/ece-tools db-dump

La operación de volcado crea un archivo de dump-<timestamp>.sql.gz en el directorio del proyecto remoto. Consulte Copia de seguridad de la base de datos.

En la estación de trabajo local, cambie al directorio del proyecto.

Establezca la versión de actualización con la sintaxis de restricción de versión.

composer require "magento/magento-cloud-metapackage":">=CURRENT_VERSION <NEXT_VERSION" --no-update

Actualice el proyecto.

composer update

Revise los parches que se aplican actualmente:

• Si hay parches instalados en el directorio m2-hotfixes, envíe un ticket de soporte de Adobe Commerce y trabaje con el soporte técnico de Adobe Commerce para comprobar qué parches se pueden seguir aplicando a la nueva versión. Quite los parches no aplicables del directorio m2-hotfixes.

• Si hay [Parches de calidad] aplicados en el archivo .magento.env.yaml, compruebe si aún se pueden aplicar a la nueva versión. Quite los parches no aplicables de la sección QUALITY_PATCHES del archivo .magento.env.yaml.

Método 1: Compruebe las versiones aplicables en las notas de la versión de parches de calidad

Método 2: Ver parches y estado disponibles

Método 3: Buscar parches

Agregar, confirmar y enviar cambios de código.

git add -A

git commit -m "Upgrade"

git push origin <branch-name>

git add -A es necesario para agregar todos los archivos modificados al control de código fuente debido a la forma en que Composer calcula los paquetes base. Tanto composer install como composer update calculan las referencias de los archivos del paquete base (magento/magento2-base y magento/magento2-ee-base) en la raíz del paquete.

Los archivos a los que Composer calcula las referencias pertenecen a la nueva versión de Adobe Commerce, para sobrescribir la versión obsoleta de esos mismos archivos. En la actualidad, el cálculo de referencias está deshabilitado en Adobe Commerce, por lo que debe agregar los archivos para calcular referencias al control de código fuente.

Espere a que se complete la implementación.

Compruebe la actualización en el entorno de integración, ensayo o producción utilizando SSH para iniciar sesión y comprobar la versión.

php bin/magento --version

Desde el terminal, utilice un comando SSH para generar el archivo /app/etc/config.php para el entorno.

ssh <SSH-URL> "<Command>"

Por ejemplo, para Pro, para ejecutar scd-dump en la rama integration:

ssh <project-id-integration>@ssh.us.magentosite.cloud "php vendor/bin/ece-tools config:dump"

Transfiera el archivo config.php a las estaciones de trabajo locales mediante rsync o scp. Solo puede agregar este archivo a la rama localmente.

rsync <SSH-URL>:app/etc/config.php ./app/etc/config.php

Agregar, confirmar y enviar cambios de código.

git add app/etc/config.php && git commit -m "Add system-specific configuration" && git push origin master

Esto genera un archivo /app/etc/config.php actualizado con una lista de módulos y opciones de configuración.

Cree una rama en la estación de trabajo local.

Deshabilite las extensiones según sea necesario.

Cuando esté disponible, descargue las actualizaciones de extensión.

Instale la actualización según lo documentado por la documentación de terceros.

Habilite y pruebe la extensión de.

Agregue, confirme e inserte los cambios de código en el control remoto.

Envíe a y pruebe en su entorno de integración.

Insertar en el entorno de ensayo para realizar pruebas en un entorno de preproducción.

En la estación de trabajo local, cambie al directorio del proyecto.

Utilice SSH para iniciar sesión en el entorno remoto.

magento-cloud ssh

Abra el archivo ./app/var/report/<error number>.

Examine los registros y determine el origen del problema.

Agregar, confirmar y enviar cambios de código.

git add -A && git commit -m "Fixed deployment failure" && git push origin <branch-name>