Actualizar Drupal

En una instalación de Edge para 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 significar una versión de función, un parche, una actualización de seguridad o cualquier otro tipo de actualización de Drupal. En el caso de una actualización de seguridad, te recomendamos que actualices tu instalación de Drupal lo antes posible para garantizar que tu sitio siga siendo seguro.

Actualiza el núcleo de Drupal

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

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.

  Si durante una actualización de la nube privada (por ejemplo, de 4.18.05 a 4.19.01), la utilidad de actualización de Apigee cambia a una versión anterior de Drupal, es posible que debas volver a ejecutar la utilidad de actualización de Drupal. Para obtener más información, consulta Vuelve a ejecutar la actualización de Drupal.

• Debes ejecutar los comandos de Drush (shell de Drupal) 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 de Nginx en la ubicación predeterminada anterior.

Determina tu versión actual de Drupal

Antes de iniciar la actualización de Drupal, puedes determinar tu versión actual de Drupal 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 sea /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 los comandos de Drush desde una línea de comandos para actualizar tu versión de Drupal. Consulta también Actualiza Drupal con Drush (Drupal.org).

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. Realiza 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 Crea una copia de seguridad del portal.

   Si modificaste 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 las personalizaciones 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-version

   Donde version es la versión deseada.

   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 secundarias disponibles para los proyectos principales y de contribución de Drupal.

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

Actualiza los módulos de contribución de PHP y Drupal

Cuando actualizas Drupal con las instrucciones anteriores de esta sección, también se actualizan los módulos que usa Drupal, como contrib y PHP. Sin embargo, debes mantenerte al día con los módulos de Drupal más recientes entre las versiones de nube privada.

Ten en cuenta que, si el módulo está en /profiles/apigee/modules/contrib, puedes reemplazarlo por una versión más reciente de ese módulo almacenando la versión más reciente en /sites/all/modules/contrib. Edge para nube privada usa la versión más reciente en /sites/all/modules/contrib en lugar de la versión anterior en /profiles/apigee/modules/contrib. Para obtener más información, consulta Actualiza módulos (Drupal.org).

Si instalas una versión nueva de la nube privada que incluye una versión más reciente del módulo que se almacenó antes en /sites/all/modules/contrib, quita el módulo de /sites/all/modules/contrib. Para obtener más información, consulta Mueve módulos y temas (Drupal.org).

¿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 el equipo de asistencia de Apigee Edge y proporciona los mensajes de error que se informaron durante la actualización.