升級 Drupal

Edge for Private Cloud 4.18.05 版

在 Apigee Developer Services 入口網站 (或簡稱「入口網站」) 的 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 安裝位置以外的地方。如需完整操作說明，請參閱「備份入口網站」。

    如果您修改了 .htaccess、robots.txt 或 defaults.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 核心和貢獻專案可用的次要更新。

  5. 重新套用對 .htaccess、robots.txt 或 defaults.settings.php (位於 sites 目錄中) 所做的任何變更。
  6. 重新套用對 sites/all 目錄所做的任何變更。
  7. 將網站移出維護模式：
    drush vset --exact maintenance_mode 0
     
    drush cache-clear all

如果更新時遇到問題，該怎麼辦？

使用建立的備份檔案，將網站還原至先前的狀態。請與 Apigee 支援代表聯絡，並提供更新期間回報的任何錯誤訊息。