Recuperar de un error de componente

En este tema se explica cómo recuperar si un componente no se implementa correctamente. Algunos ejemplos típicos son componentes que tienen dependencias que su entorno remoto no cumple, como versiones de PHP incompatibles.

Puede recuperarse de una implementación fallida de cualquiera de las siguientes maneras:

Limpiar, quitar y volver a implementar

Para realizar una limpieza desde la implementación anterior, identifique el componente que se añadió o actualizó y, a continuación, elimínelo. Primero, inicie sesión en el entorno remoto y borre manualmente el contenido del directorio var. A continuación, quite el componente del archivo composer.json y vuelva a implementar el entorno.

Para limpiar los var directorios:

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

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

    code language-bash
    magento-cloud ssh
    
  3. Borrar los directorios var.

    code language-shell
    rm -rf var/*
    
  4. Cerrar sesión.

Para quitar el componente:

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

  2. Borre la caché.

    code language-bash
    composer clear-cache
    
  3. Quitar el componente del archivo composer.json.

    code language-bash
    composer remove <component-name>:<version>
    

    Si se muestra el siguiente mensaje, no es necesario que haga nada más:

    code language-none
    Package "<name>:<version>" listed for update is not installed. Ignoring.
    
  4. Espere mientras se actualizan las dependencias.

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

    code language-bash
    git add -A
    
    code language-bash
    git commit -m "<message>"
    
    code language-bash
    git push origin <environment-ID>
    
WARNING
El proceso de implementación comienza cuando se realiza una combinación, inserción o sincronización del entorno, o cuando se déclencheur una reimplementación manual, durante la cual la aplicación Commerce se encuentra en modo de mantenimiento. Para un entorno de producción, Adobe recomienda completar este trabajo durante las horas de menor actividad para evitar interrupciones en el servicio.

Vea más información sobre cómo restaurar un entorno sin una copia de seguridad en Restaurar un entorno.

TIP
Para obtener ayuda con implementaciones bloqueadas, use el solucionador de problemas de implementación de Adobe Commerce en el Centro de ayuda de Commerce.
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26