升級 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 指令。根據預設,Portal 會安裝在以下位置:
    • /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

如果您在 /opt/apigee/apigee-drupal/wwwroot 以外的目錄中安裝 Drupal,請務必先變更至該目錄再執行 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 核心和貢獻專案的可用次要更新。

  5. 重新套用對 .htaccessrobots.txtdefaults.settings.php (在 sites 目錄中) 所做的任何變更。
  6. 重新套用對 sites/all 目錄所做的變更。
  7. 將網站從維護模式中移除:
    drush vset --exact maintenance_mode 0
    drush cache-clear all

如果在更新期間遇到問題,該怎麼辦?

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