Actualizar Drupal

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 disponible una versión nueva de Drupal. Una versión nueva puede implicar un lanzamiento de función, parche, actualización de seguridad o algún otro tipo de actualización de Drupal. En el caso de una actualización de seguridad, te recomendamos actualizar la instalación de Drupal lo antes posible para asegurarte de que tu sitio siga siendo seguro.

Actualiza el núcleo de Drupal

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

Ten en cuenta lo siguiente:

  • Con este procedimiento, solo se actualiza la instalación de Drupal. No actualiza el software de Apigee que se envía como parte del portal. Si deseas obtener información para 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 en realidad cambia a una versión inferior 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 (Drupal Shell) desde el directorio raíz del sitio del portal. De forma predeterminada, el portal se instala en las siguientes ubicaciones:
    • /opt/apigee/apigee-drupal/wwwroot (Nginx)
    • /var/www/html (Apache)
    En el procedimiento que aparece a continuación, se supone que la instalación de un servidor Nginx se realizó 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 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 Cómo actualizar Drupal con Drush (Drupal.org).

Para actualizar la 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 hiciste modificaciones en archivos como .htaccess, robots.txt o defaults.settings.php (en el directorio sites), tendrás que volver a aplicar los cambios después de la actualización. También deberás volver a aplicar las personalizaciones que se hicieron en el directorio sites/all.

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

  5. Vuelve a aplicar cualquier cambio realizado en .htaccess, robots.txt o defaults.settings.php (en el directorio sites).
  6. Vuelve a aplicar cualquier cambio realizado en el directorio sites/all .
  7. Desactiva el modo de mantenimiento del sitio:
    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 Contribution y PHP. Sin embargo, debes mantenerte al día con los últimos módulos de Drupal entre las versiones de la 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 si almacenas esa versión 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 Cómo actualizar 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ó anteriormente en /sites/all/modules/contrib, quita el módulo de /sites/all/modules/contrib. Para obtener más información, consulta Cómo mover módulos y temas (Drupal.org).

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

Restablece el 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.