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. En primer lugar, inicie sesión en el entorno remoto y borre manualmente el contenido del var directorio. A continuación, elimine el componente de composer.json y vuelva a implementar el entorno.

Para limpiar 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. Borre la var directorios.

    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. Extraiga el componente del composer.json archivo.

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

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

    code language-terminal
    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 el proceso de Commerce La aplicación está 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.

Obtenga más información sobre la restauración de un entorno sin copia de seguridad en Restaurar un entorno.

TIP
Para obtener ayuda con las implementaciones bloqueadas, utilice 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