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

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, lo más fácil y lo más recomendable Rollback sería que el comerciante, como parte de sus preparativos, hiciera lo siguiente:

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

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 /data/exports para contener 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.

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

Si un Rollback es obligatorio:

  1. Si las aplicaciones como MariaDB se actualizó como parte de esta actividad planificada, vuelva a instalar primero la aplicación en una versión anterior.
  2. Rollback la base de datos que utiliza la variable local Database Dumpy vuelva a importarlo en MariaDB.
  3. Rollback el código mediante Git a una versión de trabajo anterior.

Uso de Snapshots no es la forma recomendada para la actividad planificada/de actualización rollbacks/restores, ya que se tarda mucho más en recuperar los datos en comparación con un Database Dump, como se ha indicado anteriormente en el paso 2 del Si un Rollback es obligatorio sección.

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 local Database Dump, los datos ya se pueden recuperar en el nodo o servidor, por lo que se guarda mucho tiempo como solo un Database Import es obligatorio.

Escenario 2: restaurar una instantánea

Lectura: Restaurar una instantánea en 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. Restablecer el git Rama.

Después de realizar estos pasos:

  • La instalación de Adobe Commerce vuelve a su estado Vainilla (base de datos restaurada; configuración de implementación eliminada; directorios en var borrado).
  • Su git La rama 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 /app/etc/ El directorio no contiene el config.php archivo.

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

  1. SSH a su entorno.
  2. Elimine 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.

Lectura: Desinstalar 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 el git ramificación

Con git Para restablecer, 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. Uso --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).
    Selección de un hash de compromiso en la consola de Git
  4. Aplicar duro git restablecer: git reset --h <commit_hash>
  5. Insertar cambios en el servidor: git push --force <origin> <branch>

Después de realizar estos pasos, nuestra git la rama se restablece y toda la git changelog está claro. Los últimos git inserte los déclencheur en la implementación para aplicar todos los cambios y volver a instalar Adobe Commerce.

Escenario 4: sin instantánea, compilación dañada (sin SSH connection)

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

En esta situación, primero debe restaurar el estado de funcionamiento de la aplicación de Adobe Commerce mediante git restablezca y, a continuación, desinstale el software de Adobe Commerce (para borrar 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:

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 se ejecuta el setup:uninstall El comando falla con un error y no se puede completar. Podemos borrar la base de datos manualmente siguiendo estos pasos:

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

Después de restablecer la base de datos, hacer una git insertar en 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 redeploy.

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