Actualizar el núcleo de Drupal mediante Drush

Esta documentación está desactualizada. Ayuda a actualizarla.

Antes de comenzar

Se recomienda usar Composer para administrar las dependencias de Drupal; lee Usar Composer con Drupal para más información. Drush 9 ya no soporta la actualización de Drupal y delega el trabajo a Composer. Por lo tanto, se recomienda usar Composer para actualizar Drupal. Sin embargo, si has usado Drush durante mucho tiempo, todavía puedes usar Drush 8 (8.14 o superior) para actualizar Drupal 8.

P.D.: La introducción a estas instrucciones resume todas las opciones de actualización que puedes elegir.

Siempre vuelve a una copia de seguridad si encuentras un error fatal durante la actualización.

Actualizar el núcleo de Drupal 8

Pasos para actualizar el núcleo de Drupal 8 usando Drush 8.x. Drush es una consola para Drupal.

1. Haz una copia de seguridad de tus archivos y base de datos. Usando Drush, ingresa y ejecuta este comando.

drush archive-dump

Notas:

• Es fundamental hacer copias de seguridad antes de actualizar. Así, si algo inesperado ocurre durante o después de la actualización, puedes revertirla fácil y rápidamente.
• El comando «drush archive-dump» genera un archivo .tar.gz de los archivos y la base de datos. Es un comando obsoleto en Drush, planeado para ser removido. Solo cubre los archivos en el directorio /web.

 

2. Verifica si hay actualizaciones disponibles

drush pm-updatestatus

• Nota: alias para el comando ups
• Nota: este comando no es recomendable para sitios basados en Composer, usa composer show

 

3. Activa el modo de mantenimiento

drush state-set system.maintenance_mode 1

Nota: alias para el comando sset

4. Limpia la caché

drush cache-rebuild

Notas:

• Alias para el comando cr
• Este comando limpia las tablas cache_* en la base de datos de Drupal y luego reconstruye el contenedor del sitio

 

5. Elige una o varias de las opciones siguientes para ejecutar las actualizaciones. La opción que elijas dependerá del tipo de actualización que necesites. pm-update (alias: up) actualiza el código y aplica cualquier actualización pendiente de base de datos, igual que pm-updatecode + updatedb.

Opción: actualizar el núcleo de Drupal 8

drush pm-update drupal

Opción: actualizar el núcleo Drupal 8 a la rama de desarrollo, solo para pruebas y creación de parches (no para producción)

drush pm-update drupal-8.5.x-dev

Opción: actualizar un módulo específico

drush pm-update nombre_modulo

Opción: actualizar solo actualizaciones de seguridad

drush pm-update --security-only

 

6. Si es necesario, vuelve a aplicar cualquier cambio manual en archivos como .htaccess, composer.json o robots.txt. Drush no lo hace automáticamente.

7. Reaplica cualquier parche personalizado que hayas usado antes de la actualización (si no se ha fusionado ya).

          1. Son fáciles de encontrar con buenos mensajes de commit.

% git log --oneline --reverse core

ee2bf8dd Issue #18: Updated Drupal core from 8.3.4 to 8.3.5.

267e3ad0 Issue #27: Applied patch from https://www.drupal.org/project/drupal/issues/2174633#comment-12291691.

718ecba5 Issue #9: Applied patch from https://www.drupal.org/project/drupal/issues/2906229#comment-12496488.

 

          2. Para cada parche aplicado anteriormente desde la última actualización de núcleo, usa el comando git cherry-pick (o resuelve los conflictos si ocurren) en orden cronológico.

% git cherry-pick 267e3ad0

% git cherry-pick 718ecba5

 

8. Si usas Composer para manejar librerías PHP (por ejemplo, porque es requerido por algunos módulos adicionales), actualiza el directorio /vendor con este comando:

composer update drupal/core --with-dependencies

9. Actualiza la base de datos si se requieren actualizaciones pendientes

drush updatedb

Nota: alias para el comando updb

10. Verifica que tu sitio esté funcionando correctamente. Para esto:

• En Drupal, revisa la página de informe de estado
• Con un navegador, prueba tu sitio visitando páginas importantes

 

11. Desactiva el modo de mantenimiento

drush state-set system.maintenance_mode 0

12. Limpia la caché nuevamente

drush cache-rebuild

13. ¡Hecho! Has actualizado Drupal 8 exitosamente usando Drush :)