在 Apigee 開發人員服務入口網站的 Edge for Private Cloud 安裝 (或簡稱為入口網站) 中,您可能會收到已推出新版本的 Drupal 通知。新版本可能是指 Drupal 功能版本、修補程式、安全性更新或其他類型的 Drupal 更新。如果遇到安全性更新,建議盡快升級 Drupal 安裝項目,確保網站安全無虞。
升級 Drupal 核心
以下程序說明如何將 Drupal 7.x.y 的 Private Cloud 安裝更新為其他子版本 (例如 Drupal 7.54 至 7.59)。
請注意以下事項:
-
這個程序只會更新您安裝 Drupal,不會更新隨著入口網站一併傳送的 Apigee 軟體。如要瞭解如何升級 Apigee 入口網站軟體,請參閱升級入口網站。
如果在 Private Cloud 升級期間 (例如從 4.18.05 升級至 4.19.01),Apigee 更新公用程式實際上會降級您的 Drupal 版本,您可能需要重新執行 Drupal 升級公用程式。詳情請參閱「重新執行 Drupal 升級作業」一文。
- 您必須從入口網站網站的根目錄執行 Drush (Drupal Shell) 指令。根據預設,入口網站安裝位置為:
/opt/apigee/apigee-drupal/wwwroot
(Nginx)/var/www/html
(阿帕契)
判斷目前的 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 版本。另請參閱使用 Drush 更新 Drupal (Drupal.org)。
如何更新 Drupal 安裝項目:
- 變更為
/opt/apigee/apigee-drupal/wwwroot
目錄或您安裝入口網站的目錄。 - 完整備份所有檔案、目錄和資料庫。將備份儲存在 Drupal 安裝以外的位置。如需完整操作說明,請參閱備份入口網站。
如果您修改了檔案,例如
.htaccess
、robots.txt
或defaults.settings.php
(位於sites
目錄),必須在更新後重新套用變更。另外,您也需要重新套用sites/all
目錄中所做的所有自訂設定。 - 讓網站進入維護模式:
drush vset --exact maintenance_mode 1
drush cache-clear all
- 使用下列指令安裝所需的 Drupal 版本:
drush pm-update drupal-version
其中 version 是所需版本。
或者,您也可以執行
drush pm-update drupal
來更新至最新的 Drupal 核心版本。您可以執行drush pm-updatestatus
來列出 Drupal 核心和 contrib 專案的可用次要更新項目。 - 重新套用
.htaccess
、robots.txt
或defaults.settings.php
(位於sites
目錄中) 的所有變更。 - 重新套用對
sites/all
目錄所做的任何變更。 - 讓網站退出維護模式:
drush vset --exact maintenance_mode 0
drush cache-clear all
升級 PHP 和 Drupal contrib 模組
按照本節中的上述操作說明昇級 Drupal 時,Drupal 和 PHP 等 Drupal 使用的模組也會升級。但您應確保 Private Cloud 發布之間的最新 Drupal 模組。
請注意,如果模組位於 /profiles/apigee/modules/contrib
,您可以將新版本儲存在 /sites/all/modules/contrib
中,替換成該模組的新版本。Edge for Private Cloud 使用 /sites/all/modules/contrib
中的較新版本,而非 /profiles/apigee/modules/contrib
中的舊版。詳情請參閱更新模組 (Drupal.org) 相關文章。
如果您安裝的新 Private Cloud 版本包含先前儲存在 /sites/all/modules/contrib
中的模組的較新版本,請從 /sites/all/modules/contrib
中移除該模組。詳情請參閱「移動模組和主題 (Drupal.org)」。
如果在更新期間遇到問題,該怎麼辦?
使用您建立的備份檔案將網站還原成先前的狀態。請與 Apigee Edge 支援團隊聯絡,並提供更新期間回報的所有錯誤訊息。