Actualizar Drupal

Edge para la nube privada v4.18.05

En una instalación de Edge para la nube privada del portal de servicios para desarrolladores de Apigee (o simplemente, el portal), es posible que recibas una notificación de que hay una versión nueva de Drupal disponible. Una versión nueva puede ser una versión de función, un parche, una actualización de seguridad o algún otro tipo de actualización de Drupal. En el caso de una actualización de seguridad, debes actualizar tu instalación de Drupal lo antes posible para asegurarte de que tu sitio siga siendo seguro.

En el siguiente procedimiento, se describe cómo actualizar una instalación de Drupal 7.x.y de la nube privada a otra versión menor (por ejemplo, de Drupal 7.54 a 7.56).

Ten en cuenta lo siguiente:

  • Este procedimiento solo actualiza tu instalación de Drupal. No actualiza el software de Apigee que se envía como parte del portal. Para obtener información sobre cómo actualizar el software del portal de Apigee, consulta Actualiza el portal.

  • Debes ejecutar los comandos de Drush desde el directorio raíz del sitio del portal. De forma predeterminada, el portal se instala en la siguiente ubicación:
    • /opt/apigee/apigee-drupal/wwwroot (Nginx)
    • /var/www/html (Apache)
    En el siguiente procedimiento, se supone que se instaló un servidor Nginx en la ubicación predeterminada anterior.

Cómo determinar tu versión actual de Drupal

Antes de iniciar la actualización de Drupal, puedes determinar la versión actual ejecutando el siguiente comando desde la carpeta de instalación de Drupal. De forma predeterminada, Drupal se instala en /opt/apigee/apigee-drupal/wwwroot:

cd /opt/apigee/apigee-drupal/wwwroot
drush status | grep 'Drupal version'

Deberías ver un resultado como el siguiente:

Drupal version          :  7.54

Si instalaste Drupal en un directorio que no es /opt/apigee/apigee-drupal/wwwroot, asegúrate de cambiar a ese directorio antes de ejecutar el comando drush.

Actualiza la versión de Drupal

En esta sección, se describe cómo usar Drush (Drupal Shell) desde una línea de comandos para actualizar tu versión de Drupal. Consulta también Cómo actualizar Drupal con Drush en la documentación de Drupal.

Para actualizar tu instalación de Drupal, sigue estos pasos:

  1. Cambia al directorio /opt/apigee/apigee-drupal/wwwroot o al directorio en el que instalaste el portal.
  2. Crea una copia de seguridad completa de todos los archivos, directorios y bases de datos. Guarda la copia de seguridad en una ubicación fuera de la instalación de Drupal. Para obtener instrucciones completas, consulta Cómo crear una copia de seguridad del portal.

    Si realizaste modificaciones en archivos como .htaccess, robots.txt o defaults.settings.php (en el directorio sites), deberás volver a aplicar los cambios después de la actualización. También deberás volver a aplicar cualquier personalización que hayas realizado en el directorio sites/all.

  3. Coloca tu sitio en modo de mantenimiento:
    drush vset --exact maintenance_mode 1
    drush cache-clear all
  4. Instala la versión deseada de Drupal con el siguiente comando:
    drush pm-update drupal-7.56

    Como alternativa, puedes ejecutar drush pm-update drupal para actualizar a la versión más reciente del núcleo de Drupal. Puedes ejecutar drush pm-updatestatus para enumerar las actualizaciones menores disponibles para el núcleo de Drupal y los proyectos de contribuciones.

  5. Vuelve a aplicar los cambios realizados en .htaccess, robots.txt o defaults.settings.php (en el directorio sites).
  6. Vuelve a aplicar los cambios realizados en el directorio sites/all .
  7. Quita el sitio del modo de mantenimiento:
    drush vset --exact maintenance_mode 0
    drush cache-clear all

¿Qué sucede si tengo un problema durante la actualización?

Restablece tu sitio a su estado anterior con los archivos de copia de seguridad que creaste. Comunícate con tu representante de asistencia de Apigee y proporciona los mensajes de error que se informaron durante la actualización.