升级 Drupal

适用于私有云的 Edge v4.18.05

在 Apigee 开发者服务门户(以下简称“门户”)的 Edge for Private Cloud 安装版本中,您可能会收到有关有新版 Drupal 可用的消息。新版本可以是指 Drupal 功能版本、补丁、安全更新或其他类型的 Drupal 更新。如果发生安全更新,您需要尽快升级安装的 Drupal,以确保您的网站始终安全无虞。

以下过程介绍了如何将私有云安装的 Drupal 7.x.y 更新为另一个次要版本(例如将 Drupal 7.54 更新为 7.56)。

请注意以下事项:

  • 此过程仅更新您安装的 Drupal。它不会更新随门户一起提供的 Apigee 软件。如需了解如何升级 Apigee 门户软件,请参阅升级门户

  • 您必须从门户网站的根目录运行 Drush 命令。默认情况下,该门户的安装位置为:
    • /opt/apigee/apigee-drupal/wwwroot(Nginx)
    • /var/www/html (Apache)
    以下过程假定 Nginx 服务器安装在上述默认位置。

确定当前的 Drupal 版本

在开始 Drupal 更新之前,您可以从 Drupal 安装文件夹运行以下命令,确定当前的 Drupal 版本。默认情况下,Drupal 安装在 /opt/apigee/apigee-drupal/wwwroot 中:

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

您会在表单中看到输出:

Drupal version          :  7.54

如果 Drupal 安装在 /opt/apigee/apigee-drupal/wwwroot 以外的目录中,请确保在运行 drush 命令之前切换到该目录。

更新 Drupal 版本

本部分介绍如何从命令行使用 Drush (Drupal Shell) 更新 Drupal 版本。另请参阅 Drupal 文档中的使用 Drush 更新 Drupal

如需更新 Drupal 安装,请执行以下操作:

  1. 切换到 /opt/apigee/apigee-drupal/wwwroot 目录或您安装门户的目录。
  2. 完整备份所有文件、目录和数据库。将备份保存到 Drupal 安装以外的位置。如需查看完整说明,请参阅备份门户

    如果您对 .htaccessrobots.txtdefaults.settings.php(位于 sites 目录中)等文件进行了修改,则必须在更新后重新应用这些更改。您还需要重新应用在 sites/all 目录中进行的所有自定义。

  3. 将您的网站置于维护模式:
    drush vset --exact maintenance_mode 1
    drush cache-clear all
  4. 使用以下命令安装所需的 Drupal 版本:
    drush pm-update drupal-7.56

    或者,您也可以运行 drush pm-update drupal 来更新到最新的 Drupal 核心版本。您可以运行 drush pm-updatestatus 来列出 Drupal 核心和 contrib 项目的可用次要更新。

  5. 重新应用对 .htaccessrobots.txtdefaults.settings.php(位于 sites 目录中)所做的任何更改。
  6. 重新应用对 sites/all 目录所做的任何更改。
  7. 让您的网站退出维护模式:
    drush vset --exact maintenance_mode 0
    drush cache-clear all

如果我在更新过程中遇到问题,该怎么办?

使用您创建的备份文件将您的网站恢复到之前的状态。请与您的 Apigee 支持代表联系,并提供更新期间报告的所有错误消息。