與 Acquia 合作

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

Apigee 使用 Acquia 網站管理服務，代管開發人員服務入口網站的雲端版本。Acquia 專為搭配 Drupal 使用，可讓您在安全的環境中開發、測試及發布入口網站。

以下各節將說明如何使用 Acquia 開發及管理您的入口網站。

存取 Acquia Cloud 介面

設定 Acquia Cloud 帳戶後，您可以透過 Acquia Cloud 介面 (位於 https://cloud.acquia.com/) 存取入口網站。

首次登入時，系統會顯示「應用程式」頁面，如下圖所示。

「應用程式」頁面會顯示您可存取的所有應用程式，這些應用程式皆託管於 Acquia Cloud。應用程式是指您在 Acquia Cloud 中管理的軟體實體，例如以 Drupal 為基礎的入口網站。

以下各節說明如何使用 Acquia Cloud 介面管理入口網站內容。

如要進一步瞭解 Acquia Cloud 介面，請參閱 Acquia Cloud 說明文件中的「登入 Acquia Cloud 介面」和「使用 Acquia Cloud 管理應用程式」。

管理環境

前往 Acquia Cloud 介面，然後在「應用程式」頁面中，按一下與入口網站相關聯的「管理」，即可存取資訊主頁。

為了管理工作流程，我們提供三個環境，分別用於開發、測試和發布入口網站，如下表所示。您的入口網站會部署至各個環境，但可能會處於不同的狀態，並使用專屬的程式碼分支或標記、資料庫等等。請參閱「將程式碼部署至入口網站環境」。

環境 說明 預設網址
開發 開發新功能並自訂入口網站。 http://{application-name}xxxxxx.devcloud.acquia-sites.com/

其中 application-name 是應用程式名稱，xxxxxx 則是用於區分開發人員版和測試版的專屬字元字串。
階段 將最新程式碼推送至正式環境前，請先進行測試。 http://{application-name}yyyyyy.devcloud.acquia-sites.com/

其中 application-name 是應用程式名稱，yyyyyy 則是用於區分開發人員版和測試版的專屬字元字串。
正式發布階段 將入口網站發布至正式版 (線上)。 http://{application-name}.devcloud.acquia-sites.com/

其中 application-name 是應用程式的名稱。

注意：另請參閱「設定自訂網域」。

詳情請參閱 Acquia Cloud 說明文件中的「使用環境」一節。

開發入口網站

以下各節將說明如何開發入口網站。

此外，如要進一步瞭解如何自訂入口網站，請參閱下列各節。

您的目標

您可以

更多資訊

變更網站的外觀和風格

基本：使用入口網站上的「外觀」選單項目進行變更，例如修改標誌和網站顏色。

請參閱「自訂外觀」

進階：如要修改網站的完整外觀和風格，請擴充 Apigee 回應式主題。

請參閱「自訂主題」

變更網站功能的行為

基本：使用入口網站的管理員設定，變更/設定網站的運作方式。

請參閱 這份 Apigee 說明文件

進階：建立自訂模組，變更網站的任何行為。

請參閱 Drupal 說明文件中的「建立自訂模組」

Git 存放區總覽

Drupal 程式碼的 Git 存放區包含所有入口網站程式碼，並使用下列結構進行整理。

注意：請只修改 /sites/all 目錄中的內容。如果您修改 /sites/all 目錄以外的內容，升級至新版本時就會發生問題，且在將變更內容提交至 Git 時，可能會發生合併衝突。

Git 存放區中的資料夾

說明
/profiles/apigee

Apigee 維護的模組和主題，包括：

  • /profiles/apigee/modules/contrib：由 Apigee 維護的 Drupal 貢獻模組
  • /profiles/apigee/themes/contrib：由 Apigee 維護的 Drupal 貢獻主題
  • /profiles/apigee/modules/custom：Apigee 建立的自訂模組
  • /profiles/apigee/themes/custom：Apigee 建立的自訂主題

注意：請勿修改 /profiles/apigee 目錄中的內容，否則升級至新版本時會發生問題，並可能在將變更內容簽入 Git 時發生合併衝突。如要瞭解 Drupal 最佳做法，請參閱「絕不破解核心」。
/sites/all

自訂 Drupal 模組和主題。如要瞭解如何管理這個資料夾中的內容，請參閱「新增自訂模組和主題」和「覆寫 Drupal 設定檔模組和主題」。

注意：請只修改 /sites/all 目錄中的內容。

存取程式碼

如要存取 Git 中的程式碼存放區，您必須執行下列各節所述的任務：

另請參閱「如何存取 Drupal 7 開發人員入口網站的原始碼？」。

啟用 SSH 存取伺服器的權限

您必須先啟用 SSH 才能存取伺服器，然後才能使用 Git 管理 Drupal 程式碼。詳情請參閱 Acquia Cloud 說明文件中的「啟用 SSH 存取權」。

如要啟用 SSH 存取權：

  1. 前往 https://accounts.acquia.com 登入 Acquia 帳戶介面。
  2. 按一下「憑證」。
  3. 出現提示時，請重新輸入密碼以確認身分。
  4. 在「安全殼層金鑰」下方，按一下「新增安全殼層金鑰」。
  5. 輸入下列資訊：
    欄位 說明
    暱稱 SSH 金鑰的暱稱。暱稱可包含英數字元和底線。
    公開金鑰 公開金鑰。

    如要瞭解如何產生 SSH 公開金鑰，請參閱 Acquia Cloud 說明文件中的「產生 SSH 公開金鑰」一節。
  6. 按一下「新增金鑰」。

在 Git 中存取程式碼存放區

Git 存放區包含所有入口網站的程式碼。您可以新增程式碼或自訂現有程式碼，以便設定入口網站。如需更多資訊，請參閱 Acquia Cloud 說明文件中的「使用程式碼存放區」。

如要存取 Git 存放區中的程式碼存放區：

  1. 前往 https://cloud.acquia.com/ 登入 Acquia Cloud 介面。
  2. 在「應用程式」頁面上，按一下「管理」，查看入口網站的詳細資料。
  3. 按一下導覽列中的「應用程式資訊」。

  4. 複製「Application Information」對話方塊中的複製指令。
  5. 執行下列任一 Git 指令，將 Git 存放區複製到本機環境：

    如要複製 Git 存放區並建立新分支，請按照下列步驟操作：

    > git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

    如要從 master 分支版本複製 Git 存放區，請按照下列步驟操作：

    > git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

  6. 準備好使用應用程式視窗中的相關指令，將變更階段、修訂並推送至 Git 存放區時，請重複執行這些步驟。

    將分支提交至存放區後，Acquia Cloud 會更新執行該程式碼分支的環境。您可以將程式碼部署至入口網站環境，詳情請參閱下一節。

將程式碼部署至入口網站環境

如要在入口網站環境中部署、切換或還原程式碼、在不同環境之間移動程式碼，或進一步瞭解存放區結構和建議的工作流程，請參閱 Acquia Cloud 說明文件中的「使用 Aquia Cloud 上的網站」。將新程式碼部署至環境時，您必須執行 update.php 來進行必要的資料庫更新。

新增自訂模組和主題

您可以將自訂模組和主題新增至下表所列的資料夾，藉此擴充入口網站的功能。

注意：請只修改 /sites/all 目錄中的內容。如果您修改 /sites/all 目錄以外的內容，在將變更內容提交至 Git 時，可能會發生合併衝突。

模組/主題 Git 存放區中的資料夾 更多資訊 (Drupal 說明文件)
自訂模組 sites/all/modules/custom 建立自訂模組
自訂主題 sites/all/themes 自訂主題
Drupal 7 主題設定

在開發環境中新增自訂模組或主題後，您可以將其部署至測試環境進行測試，然後再部署至實際工作環境，如將程式碼部署至入口網站環境所述。

覆寫 Drupal 設定檔模組和主題

下列目錄中的模組和主題會覆寫 Apigee 在 /profiles/apigee 中維護及發布的 Drupal 設定檔模組和主題。請參閱「Git 存放區總覽」。

舉例來說，您可能會在下列情況下，覆寫 Apigee Drupal 發行版本中的模組：

  • 您想使用特定模組的不同版本。
  • 您希望在下次預定發布的 Apigee 版本前，實作安全性更新。
模組/主題 Git 存放區中的資料夾 更多資訊 (Drupal 說明文件)
Drupal 貢獻模組 sites/all/modules/contrib

注意：儲存在 /sites/all/modules 下任何位置的模組會覆寫 Apigee Drupal 發布模組。

 提供的模組

注意：這個目錄中的 Drupal 貢獻模組會覆寫 Apigee 在 /profiles/apigee/modules 中維護及發布的等效模組。如果您想使用 Apigee 維護的 Drupal 設定檔模組，請移除您新增至這個資料夾的所有重複模組。
Drupal 貢獻主題 sites/all/themes 貢獻主題

注意：這個目錄中的 Drupal 主題會覆寫 Apigee 在 /profiles/apigee/themes 中維護及發布的等同模組。如要使用 Apigee 維護的設定檔主題，請移除您新增至此資料夾的所有重複模組。

啟用安全資料傳輸層 (SSL)

如要透過 HTTPS 安全存取網站，您必須啟用 SSL。

如何啟用安全資料傳輸層 (SSL)：

  1. 向憑證授權單位 (CA) 或 SSL 憑證供應商取得 SSL 憑證。 請參閱「啟用 SSL」。
  2. 在 Acquia Cloud 介面的 SSL 頁面上傳 SSL 憑證。請參閱「管理 SSL 憑證」。

保護正式環境

首次建立應用程式時，您可以自由管理實際工作環境，並從開發和試驗環境中套用變更。發布內容後，建議您鎖定正式環境，以免內容遭到未經授權或意外更新。詳情請參閱 Acquia Cloud 說明文件中的「使用正式版模式保護實際運作中的應用程式」。

如要保護實際工作環境：

  1. 前往 https://cloud.acquia.com/ 登入 Acquia Cloud 介面。
  2. 在「應用程式」頁面上，按一下「管理」，即可查看入口網站的詳細資料。
  3. 按一下「Prod」即可查看正式環境詳細資料。
  4. 按一下導覽列中的「正式版模式」。
  5. 按一下「啟用」，即可啟用正式版模式。

將模組和主題更新套用至入口網站

Apigee 會定期自動將入口網站中的模組和主題更新至最新版本。更新作業只會在開發環境中進行，並標記為需要遷移至其他入口網站環境。

如果您的網站並非 Apigee Acquia 帳單機構的一部分 (例如從其他代管服務供應商遷移至您自己的機構的新網站)，則必須允許 Apigee 存取您的 Git 存放區，才能接收自動 DevPortal 更新推送。如需瞭解詳情，請與 Apigee 支援團隊聯絡。

如果您新增了任何自訂模組或主題，則必須手動更新。

下表概述將模組和主題更新套用至入口網站的必要步驟。

模組/主題 說明
Apigee Edge 模組

Apigee 只會自動將更新套用至 Dev 環境。

測試更新後，請按照「將程式碼部署至入口網站環境」一文的說明，將更新從「開發」遷移至「階段」，再遷移至「實際工作」環境。
Apigee 響應式主題

Apigee 只會自動將更新套用至「Dev」環境。

測試更新後，請按照「將程式碼部署至入口網站環境」一文的說明，將更新從「開發」遷移至「階段」，再遷移至「實際工作」環境。
Drupal 核心和貢獻模組

Apigee 只會自動將更新套用至「Dev」環境。

測試更新後，請按照「將程式碼部署至入口網站環境」一文的說明，將更新從「開發」遷移至「階段」，再遷移至「實際工作」環境。
自訂模組和主題

如果您已在入口網站中新增自訂模組和主題，請按照「新增自訂模組和主題」一節的說明，手動安裝更新。

請手動或使用 Drush 將最新版本下載到本機目錄。接著，將更新內容排程、提交，然後推送至 Git 存放區。測試更新後，請按照「將程式碼部署至入口網站環境」一文的說明，將更新從「開發」遷移至「階段」，再遷移至「實際工作」環境。

遷移自訂功能

如果您在入口網站中新增自訂程式碼或設定，就必須維護並將這些項目從開發環境遷移至測試環境，再遷移至生產環境。

如果是 Git 存放區中的程式碼，您可以使用「將程式碼部署至入口網站環境」一文所述的程序，將程式碼從開發遷移至測試，再遷移至生產環境。

如果您已建立任何自訂設定，請使用下列其中一種方法進行遷移：

方法 說明
將設定匯出至程式碼 許多常見的設定都能使用功能模組「匯出」至程式碼。例如檢視畫面、面板、圖片快取等。
實作 hook_update_N() 函式 Drupal 會使用 hook_update_N() 函式管理資料庫和設定變更。

如果您有自訂模組，可以執行下列操作：

  • 將 hook_update_N() 函式新增至模組的 .install 檔案，以便處理變更。
  • 並將這些變更與程式碼一併部署。
  • 執行 update.php，以便在測試和實際工作環境中遷移變更。

設定自訂網域

如管理環境所述，入口網站環境的預設網域名稱結尾皆為 acquia-sites.com。建議您提供自訂網域名稱，以便個人化並更清楚地傳達網站的用途。例如，以下是常見的替代做法：

https://developers.mycompany.com

如要設定自訂網域：

  1. 將網域新增至入口網站環境。請參閱 Acquia Cloud 說明文件中的「管理網域」。
  2. 請將網域名稱的 DNS 記錄項目指向公開 IP 位址 (而非 acquia-sites.com 網域)，藉此透過 DNS 供應商設定自訂網域。請參閱 Acquia Cloud 說明文件中的「將 DNS 記錄指向公開 IP 位址」。

    注意：請勿將網域名稱的 CNAME 項目設為 acquia-sites.com 網域。這麼做可能會導致入口網站的延遲問題或停機時間。

使用 Acquia Insight 監控入口網站

Acquia Insight 是一套工具，可監控網站成效、安全性和搜尋引擎最佳化，協助您改善入口網站。詳情請參閱 Acquia Insight。

備份入口網站

下表列出可用來備份入口網站元件的選項。

構成要素 備份詳細資料 進一步瞭解 Acquia Cloud 說明文件
程式碼
  • 程式碼由版本控制系統維護，每次提交時都會加上標記。
  • 隨時可以同步處理或還原特定標記。
資料庫
  • 系統會執行每日備份作業，並保留三天。
  • 安排自動備份和隨選備份。
  • 系統每小時會擷取所有資料的內部災難快照。
檔案 執行手動備份或安排 Cron 工作。
完整應用程式 使用 Drush 手動備份。
.
Drupal 檔案系統 使用下列任一選項執行手動備份：
  • 使用 FTP 用戶端或指令列工具 (rsync 和 scp) 複製檔案。
  • 使用 Drush 建立壓縮封存檔。

注意：Acquia Cloud 不支援備份和遷移模組。詳情請參閱「Acquia Cloud 不支援備份和遷移模組」。

查看活動通知

您可以查看活動通知，追蹤入口網站發生的重要動作，例如在環境之間安裝或複製程式碼、資料庫更新和備份、伺服器變更等等。詳情請參閱 Acquia Cloud 說明文件中的「查看活動通知」。

如要查看通知清單，請按照下列步驟操作：

  1. 前往 https://cloud.acquia.com/ 登入 Acquia Cloud 介面。
  2. 在「應用程式」頁面上，按一下「管理」，即可查看入口網站的詳細資料。
  3. 按一下導覽列右上角的鈴鐺圖示，即可查看最新通知。

  4. 按一下通知旁的箭頭，即可查看活動的詳細資訊。

訂閱狀態更新

您可以前往 status.apigee.com 訂閱 Apigee 發布和狀態更新。按一下「訂閱最新消息」，然後在系統提示時輸入聯絡資訊 (例如電子郵件地址)，再按一下「訂閱」。在電子郵件通知管理頁面中，確認已選取「開發人員入口網站」，視需要切換其他通知設定，然後按一下「更新偏好設定」。

您可以訂閱 Acquia 狀態更新，接收平台發生的任何服務中斷、緊急維護或安全性更新的通知。如要訂閱 Acquia Cloud 更新，請按照下列步驟操作：

  1. 前往 Acquia 狀態頁面。
  2. 按一下「訂閱最新消息」。
  3. 選取要用來接收更新的通訊方式 (電子郵件、簡訊等)。
  4. 在「通知」頁面上，選取要接收狀態更新的產品。例如 Acquia Cloud Enterprise。
  5. 按一下「更新偏好設定」。