Actualizar la versión de Commerce
Puede actualizar el código base de Adobe Commerce a una versión más reciente. Antes de actualizar el proyecto, revise los requisitos del sistema en la guía de Instalación para conocer los requisitos de la versión de software más reciente.
Según la configuración del proyecto, las tareas de actualización pueden incluir las siguientes:
- Actualice los servicios, como MariaDB (MySQL), OpenSearch, RabbitMQ y Redis, para comprobar la compatibilidad con las nuevas versiones de Adobe Commerce.
- Convertir un archivo de administración de configuración anterior.
- Actualice el archivo
.magento.app.yaml
con la nueva configuración para los vínculos y las variables de entorno. - Actualice las extensiones de terceros a la última versión compatible.
- Actualizar el archivo
.gitignore
.
Staging
y Production
entornos..magento.app.yaml
y services.yaml
archivos actualizados y especifique la versión de PHP en el ticket. Para ver los cambios de autoservicio en la versión, las extensiones o la configuración del entorno de PHP, consulte Configuración de PHP en Configuración de la aplicación.Actualizar desde versiones anteriores
Si está iniciando una actualización desde una versión de Commerce anterior a la 2.1, algunas restricciones en la base de código de Adobe Commerce pueden afectar su capacidad de actualizar a una versión específica de ECE-Tools o de actualizar a la siguiente versión de Commerce compatible. Utilice la siguiente tabla para determinar la mejor ruta:
Consulte las notas de la versión para 2002.0.9 y versiones posteriores de 2002.0.x.
ece-tools
, debe realizar una actualización única a su proyecto en la nube para eliminar los paquetes obsoletos. Si actualmente usa el paquete ece-tools
y necesita actualizarlo, consulte Actualizar el paquete ECE-Tools.Administración de configuración
Las versiones anteriores de Adobe Commerce, como 2.1.4 o posterior a 2.2.x o posterior, utilizaban un archivo config.local.php
para la administración de la configuración. La versión 2.2.0 y posteriores de Adobe Commerce usan el archivo config.php
, que funciona exactamente igual que el archivo config.local.php
, pero tiene diferentes opciones de configuración que incluyen una lista de los módulos habilitados y opciones de configuración adicionales.
Al actualizar desde una versión anterior, debe migrar el archivo config.local.php
para utilizar el archivo config.php
más reciente. Siga estos pasos para realizar una copia de seguridad del archivo de configuración y crear uno.
Para crear un archivo config.php
temporal:
-
Cree una copia de
config.local.php
archivo y asígnele el nombreconfig.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.
config.php
y generar un nuevo archivo completo. Solo puede eliminar este archivo para reemplazarlo esta vez. Después de generar un nuevo archivo completo de config.php
, no puede eliminar el archivo para generar uno nuevo. Consulte Administración de configuración e implementación de canalización.Verificar las dependencias del compositor de Zend Framework
Al actualizar a 2.3.x o posterior desde 2.2.x, compruebe que las dependencias de Zend Framework se hayan agregado a la propiedad autoload
del archivo composer.json
para admitir Laminas. Este complemento admite nuevos requisitos para el marco Zend, que ha migrado al proyecto Laminas. Ver Migración de Zend Framework al proyecto Laminas en Magento DevBlog.
Para comprobar la configuración de auto-load:psr-4
:
-
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.code language-json "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.
-
Archivos de configuración
Antes de actualizar la aplicación, debe actualizar los archivos de configuración del proyecto para tener en cuenta los cambios en los valores de configuración predeterminados de Adobe Commerce en la infraestructura en la nube o en la aplicación. Los valores predeterminados más recientes se encuentran en el repositorio de GitHub de Magento en la nube.
.magento.app.yaml
Revise siempre los valores contenidos en el archivo .magento.app.yaml para la versión instalada, ya que controla la forma en que la aplicación se genera e implementa en la infraestructura de la nube. El siguiente ejemplo es para la versión 2.4.7 y utiliza Composer 2.7.2. La propiedad build: flavor:
no se usa para Composer 2.x; consulte Instalación y uso de Composer 2.
Para actualizar el archivo .magento.app.yaml
:
-
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.
code language-yaml type: php:8.3 build: flavor: none dependencies: php: composer/composer: '2.7.2'
-
Modifique los comandos
build
ydeploy
de la propiedadhooks
.code language-yaml 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-
code language-yaml 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-
code language-yaml 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.
composer.json
Antes de actualizar, compruebe siempre que las dependencias del archivo composer.json
sean compatibles con la versión de Adobe Commerce.
Para actualizar el archivo composer.json
para la versión 2.4.4 y posterior de Adobe Commerce:
-
Agregar los(as) siguientes
allow-plugins
a la secciónconfig
:code language-json "config": { "allow-plugins": { "dealerdirect/phpcodesniffer-composer-installer": true, "laminas/laminas-dependency-plugin": true, "magento/*": true } },
-
Agregue el siguiente complemento a la sección
require
:code language-json "require": { "magento/composer-root-update-plugin": "^2.0.3" },
-
Agregue el siguiente componente a la sección
extra:component_paths
:code language-json "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.
Copia de seguridad del proyecto
Se recomienda crear una copia de seguridad del proyecto antes de una actualización. Siga estos pasos para realizar una copia de seguridad de los entornos de integración, ensayo y producción.
Para hacer una copia de seguridad de la base de datos y el código del entorno de integración:
-
Cree una copia de seguridad local de la base de datos remota.
code language-bash magento-cloud db:dump
note note NOTE El comando magento-cloud db:dump
ejecuta el comando mysqldump con el indicador--single-transaction
, lo que le permite hacer una copia de seguridad de la base de datos sin bloquear las tablas. -
Haga una copia de seguridad del código y los medios.
code language-bash 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.
Para hacer una copia de seguridad de la base de datos del entorno de ensayo o producción antes de implementar:
-
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
.code language-bash 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.
Actualización de aplicación
Revise la información de versiones de servicio para conocer los requisitos de la versión de software más reciente antes de actualizar la aplicación.
Para actualizar la versión de la aplicación:
-
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.
code language-bash composer require "magento/magento-cloud-metapackage":">=CURRENT_VERSION <NEXT_VERSION" --no-update
note note NOTE Debe usar la sintaxis de restricción de versión para actualizar correctamente el paquete ece-tools
. Puede encontrar la restricción de versión en el archivocomposer.json
para la versión de la plantilla de aplicación que está utilizando para la actualización. -
Actualice el 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 "Upgrade"
code language-bash 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. Tantocomposer install
comocomposer update
calculan las referencias de los archivos del paquete base (magento/magento2-base
ymagento/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.
code language-bash php bin/magento --version
Crear un archivo config.php
Como se menciona en Administración de configuración, después de actualizar, debe crear un archivo config.php
actualizado. Complete los cambios de configuración adicionales mediante el Administrador en su entorno de integración.
Para crear un archivo de configuración específico del sistema:
-
Desde el terminal, utilice un comando SSH para generar el archivo
/app/etc/config.php
para el entorno.code language-bash ssh <SSH-URL> "<Command>"
Por ejemplo, para Pro, para ejecutar
scd-dump
en la ramaintegration
:code language-bash 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 mediantersync
oscp
. Solo puede agregar este archivo a la rama localmente.code language-bash rsync <SSH-URL>:app/etc/config.php ./app/etc/config.php
-
Agregar, confirmar y enviar cambios de código.
code language-bash 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.
config.php
. Una vez agregado este archivo a su código, no debe eliminarlo. Si debe quitar o editar la configuración, edite el archivo manualmente.Actualización de extensiones
Revise las páginas de módulos y extensiones de terceros en Marketplace u otros sitios de la empresa y compruebe la compatibilidad con Adobe Commerce y Adobe Commerce en la infraestructura en la nube. Si debe actualizar cualquier extensión y módulo de terceros, Adobe recomienda trabajar en una nueva rama de integración con las extensiones deshabilitadas.
Para verificar y actualizar sus extensiones:
-
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.
El Adobe recomienda encarecidamente actualizar el entorno de producción antes de, incluidas las extensiones actualizadas en el proceso de lanzamiento del sitio.
Solución de problemas de actualización
Si la actualización falla, recibe un mensaje de error en el explorador que indica que no puede acceder a la tienda o al panel Administración:
There has been an error processing your request
Exception printing is disabled by default for security reasons.
Error log record number: <error-number>
Para resolver el error:
-
En la estación de trabajo local, cambie al directorio del proyecto.
-
Utilice SSH para iniciar sesión en el entorno remoto.
code language-bash 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.
code language-bash git add -A && git commit -m "Fixed deployment failure" && git push origin <branch-name>