Actualizar la versión de Commerce

Para instalar o actualizar servicios solo en Staging y Production entornos, envía un ticket de soporte de Adobe Commerce.

En el ticket, especifique los cambios de servicio requeridos, incluya los archivos .magento.app.yaml y .magento/services.yaml actualizados y anote la versión de PHP de destino.

La versión de PHP, las actualizaciones de Compositor, las extensiones y la configuración del entorno son cambios de autoservicio. Es posible que Adobe tenga que actualizar el agente de New Relic para comprobar la compatibilidad con la versión de PHP. Ver configuración de PHP en Configuración de la aplicación.

Confirme la programación de actualización a través del proceso en dos partes de Adobe: primero confirme la fecha y la hora solicitadas y después el equipo de asistencia la envía al equipo de infraestructura para que la confirme definitivamente.

Los cambios de producción (solo Pro) requieren al menos dos días hábiles de antelación, excepto los fines de semana. Por ejemplo, el equipo de Infraestructura en la nube debe confirmar una actualización el lunes antes del miércoles anterior. Se espera un tiempo de espera adicional durante la demanda máxima. Para evitar demoras, responda a la solicitud inicial al menos 48 horas antes de la ventana. La actualización no se considera programada hasta que reciba la confirmación final.

Valide la actualización en un entorno de ensayo o integración antes de programarla en producción.

Los problemas causados por módulos de terceros, código personalizado o compatibilidad de dependencias a menudo aparecen durante la reimplementación que sigue a una actualización de servicio. Para validar varias actualizaciones de servicio de una en una, un pedido razonable es Valkey o Redis, luego RabbitMQ, luego OpenSearch y luego MariaDB. Esta secuencia no es obligatoria. Las actualizaciones de bases de datos tienen el mayor impacto operativo y merecen la mayor precaución.

Adobe no garantiza la duración exacta de una ventana de mantenimiento de producción con antelación, ya que el tiempo depende del entorno y los servicios implicados. Utilice el tiempo que tarda la actualización de ensayo como estimación práctica al planificar la ventana Producción.

Vuelva a implementar el entorno después de que Adobe complete la actualización del servicio para que el cambio surta efecto, incluso si la versión de la aplicación de Adobe Commerce no cambia.

Si la actualización incluye OpenSearch, planifique también una reindexación completa. Adobe no puede garantizar que no haya tiempo de inactividad durante una actualización de servicio, por lo que debe planificar una ventana de mantenimiento que permita volver a implementar, reindexar si es necesario y validar la tienda y el administrador antes de volver a abrir el sitio.

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 restricción de versión para la versión de actualización de destino. Este paso solo es necesario si la versión de destino está fuera de la restricción existente.

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

Actualice el archivo composer.json con la versión de actualización principal de Commerce.

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

Si utiliza B2B, actualice el archivo composer.json con la versión compatible para Commerce.

composer require-commerce magento/extension-b2b 1.5.2 --no-update

Actualizar dependencias del 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.

Para completar la actualización, espere a 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

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.

Para realizar pruebas en un entorno de preproducción, vaya al entorno de ensayo.

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>