DocumentaciónCommerceKB de Commerce

Restablecer el entorno en Adobe Commerce en la infraestructura en la nube

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Este artículo muestra diferentes escenarios de reversión de un entorno en Adobe Commerce en una infraestructura en la nube.

Elija el más apropiado para su caso:

Escenario 1: actividad planificada

Con una implementación o actualización planificada, el Rollback más fácil y recomendado sería que el comerciante, como parte de sus preparativos, hiciera lo siguiente:

NOTE
¡Pruebe siempre primero estos pasos en su Staging Environment!

Cinco días antes de las actividades de actualización/implementación:

  1. Comprobar el tamaño de la base de datos actual.
  2. Compruebe que tiene suficiente espacio en disco en /data/exports para guardar un Database Dump. Si no tiene suficiente espacio en disco, elimine los datos no deseados o cree un caso de asistencia y solicite que se expanda el disco.

El día de los cambios:

  1. Coloque el sitio web en Maintenance Mode.

    Obtenga más información sobre Habilitar o deshabilitar Maintenance Mode en nuestra guía del usuario y Maintenance Mode opciones para la actualización en nuestra guía de actualización.
  2. Tome un(a) Database Dump local.

Si se requiere Rollback:

  1. Si aplicaciones como MariaDB se actualizaron como parte de esta actividad planificada, primero debe reinstalar la aplicación a una versión anterior.
  2. Rollback la base de datos con el Database Dump local y vuelva a importarla en MariaDB.
  3. Rollback cambió el código a través de Git a una versión de trabajo anterior.

No se recomienda usar Snapshots para la actividad rollbacks/restores de actualización o planeada, ya que se tarda mucho más en recuperar los datos en comparación con un Database Dump local, como se ha indicado anteriormente en el paso 2 de la sección Si se requiere un Rollback.

Snapshots no se mantienen en el nodo o servidor, se mantienen en un bloque de almacenamiento independiente y, como esos datos deben transmitirse desde el almacenamiento del bloque a través de la red a un nuevo disco, lleva tiempo en el proceso. A continuación, ese nuevo disco se monta en el nodo listo para recuperarlo o importarlo en el disco original conectado al nodo o servidor.

Cuando compara esto con la importación de un(a) Database Dump local(a), los datos ya se pueden recuperar en el nodo/servidor, por lo que se guarda mucho tiempo, ya que solo se requiere un(a) Database Import.

Escenario 2: restaurar una instantánea

Lea: Restaure una instantánea de Adobe Commerce en la infraestructura en la nube en nuestra documentación para desarrolladores.

NOTE
La creación de una instantánea debe ser nuestro primer paso después de acceder a Adobe Commerce en la cuenta de infraestructura de la nube y antes de aplicar cambios importantes. Es una práctica recomendada y muy recomendable.

Lectura: Crear una instantánea en nuestra documentación para desarrolladores.

Escenario 3: sin instantánea, compilación estable (conexión SSH disponible)

Esta sección muestra cómo restablecer un entorno cuando no se ha creado una instantánea, pero se puede acceder al entorno a través de SSH.

Estos son los pasos:

  1. Deshabilite la administración de configuración.
  2. Desinstale el software de Adobe Commerce.
  3. Restablezca la rama git.

Después de realizar estos pasos:

  • Su instalación de Adobe Commerce vuelve a su estado Vainilla (base de datos restaurada; configuración de implementación eliminada; directorios bajo var borrados).
  • La rama git se restableció al estado deseado en el pasado.

Lea los pasos detallados a continuación.

Paso 0 (requisito previo): Elimine config.php para deshabilitar la administración de la configuración

Es necesario deshabilitar la administración de configuración para que no aplique automáticamente las opciones de configuración anteriores durante la implementación.

Para deshabilitar la administración de configuración, asegúrese de que el directorio /app/etc/ no contenga el archivo config.php.

Para quitar el archivo de configuración, siga estos pasos:

  1. SSH a su entorno.
  2. Quitar el archivo de configuración: rm app/etc/config.php

Más información sobre la Administración de configuración:

Paso 1: Desinstalar el software de Adobe Commerce con el comando setup:uninstall

Al desinstalar el software de Adobe Commerce, se borra y restaura la base de datos, se quita la configuración de implementación y se borran los directorios de var.

Lea: Desinstale el software de Adobe Commerce en nuestra documentación para desarrolladores.

Para desinstalar el software de Adobe Commerce, siga estos pasos:

  1. SSH a su entorno.
  2. Ejecutar setup:uninstall : bin/magento setup:uninstall
  3. Confirme la desinstalación.

El siguiente mensaje se muestra para confirmar que la desinstalación se ha realizado correctamente:

[SUCCESS]: Magento uninstallation complete.

Esto significa que hemos revertido nuestra instalación de Adobe Commerce (incluida DB) a su estado auténtico (Vainilla).

Paso 2: Restablecer la rama git

Con git restablecido, revertimos el código al estado deseado en el pasado.

  1. Clone el entorno en el entorno de desarrollo local. Puede copiar el comando en la consola de Cloud: copy_git_clone.png
  2. Acceda al historial de confirmaciones. Use --reverse para mostrar el historial en orden inverso para mayor comodidad: git log --reverse
  3. Seleccione el hash de compromiso en el que ha sido bueno. Para restablecer el código a su estado auténtico (Vainilla), busque la primera confirmación que creó su rama (entorno).
    Seleccionar un hash de confirmación en la consola de Git
  4. Aplicar restablecimiento git duro: git reset --h <commit_hash>
  5. Insertar cambios en el servidor: git push --force <origin> <branch>

Después de realizar estos pasos, la rama git se restablece y el registro de cambios git completo está borrado. La última git déclencheur la reimplementación para aplicar todos los cambios y volver a instalar Adobe Commerce.

Escenario 4: sin instantánea; compilación dañada (sin conexión de SSH)

Esta sección muestra cómo restablecer un entorno cuando se encuentra en un estado crítico: el procedimiento de implementación no puede generar correctamente una aplicación de trabajo, por lo que la conexión SSH no está disponible.

En este escenario, primero debe restaurar el estado de trabajo de la aplicación de Adobe Commerce mediante git reset, luego desinstale el software de Adobe Commerce (para soltar y restaurar la base de datos, quitar la configuración de implementación, etc.). En este escenario se siguen los mismos pasos que en el escenario 3, pero el orden de los pasos es diferente y hay un paso adicional: forzar la reimplementación. Estos son los pasos:

  1. Restablezca la rama git .
  2. Deshabilite la administración de configuración.
  3. Desinstale el software de Adobe Commerce.
  4. Forzar redespliegue.

Después de realizar estos pasos, obtendrá los mismos resultados que en el escenario 3.

Paso 4: Forzar el redespliegue

Realice una confirmación (puede ser una confirmación vacía, aunque no la recomendamos) y envíela al servidor para volver a implementarla en el déclencheur:

git commit --allow-empty -m "<message>" && git push <origin> <branch>

Si la instalación:desinstalación falla, restablecer la base de datos manualmente

Si al ejecutar el comando setup:uninstall se produce un error y no se puede completar, se puede borrar la base de datos manualmente siguiendo estos pasos:

  1. SSH a su entorno.
  2. Conéctese a MySQL DB: mysql -h database.internal (para entornos Pro, consulte: Configurar el servicio MySQL).
  3. Soltar la base de datos main: drop database main;
  4. Crear una base de datos main vacía: create database main;
  5. Eliminar los siguientes archivos de configuración: config.php, config.php, .bak,, env.php, env.php.bak

Después de restablecer la base de datos, inserte git el entorno para volver a implementar el déclencheur e instale Adobe Commerce en una base de datos recién creada. O ejecute el comando de reimplementación.

recommendation-more-help
8bd06ef0-b3d5-4137-b74e-d7b00485808a