您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info
自 2020 年 5 月 31 日起，Apigee 將不再贊助以 Drupal 7 為基礎的開發人員入口網站 (D7P) 代管服務。在此之前，自 2019 年 5 月 31 日起，客戶必須自行佈建任何新的 Drupal 入口網站。
異動內容
我們在 2019 年 4 月宣布推出 Apigee 整合式開發人員入口網站的 開發人員團隊和目標對象。我們在 2019 年 5 月宣布 以 Drupal 8 為基礎的入口網站 (D8P)已準備好正式上線，這項服務可提供新的客戶管理入口網站，取代 Apigee 管理的整合式入口網站，並包含新的 SmartDocs。我們在宣布 D8P 的同時，也宣布 D7P 將在 12 個月後停止代管，私有雲 D7P 的安裝和升級指令碼也會在 20.06 版中移除。
為什麼 Apigee 贊助的 Drupal 7 版開發人員入口網站主機服務會終止？
Apigee 贊助的 D7P 代管服務將於 2020 年 5 月結束，原因如下：
- Apigee 的 整合式入口網站為客戶提供了更吸引人的選擇，不僅提供進階功能，還能降低總擁有成本。
- Drupal 8 是希望繼續使用 Drupal 的使用者可選擇的路徑。雖然從 D7P 遷移至 D8P 的作業不容易，但對於偏好自行管理的開發人員入口網站的客戶而言，D8P 提供了更理想的發展途徑。
我需要採取哪些行動？
Apigee D7P 客戶應評估可用的替代方案，並與偏好的代管服務供應商 (例如 Pantheon 或 Acquia) 建立直接關係，或考慮其他代管選項。
有哪些選項可供考慮？
使用 D7P 的 Cloud 客戶有三個選項：
- 改用 Apigee 的整合式入口網站。
- 遷移至 Drupal 8。
- 繼續使用 Drupal 7，並在 2020 年 5 月 31 日前負起代管責任。
私有雲客戶可選擇以下兩種做法：
- 遷移至 Drupal 8。
- 目前請繼續使用 Drupal 7。
下文將詳細說明每個選項。
選項 1：改用 Apigee 整合式入口網站
誰應考量這項功能？
API 供應商已使用 Drupal 7，且只需進行少量自訂，或是偏好以設定為導向且總擁有成本較低的多合一解決方案。
直接整合至 Apigee Edge 的開發人員入口網站，包含功能強大的 API 目錄，以及以 Markdown 為基礎的內容管理系統，並提供完善的目標對象管理工具。如要判斷整合式入口網站是否適合您的 API 計畫，請與 Apigee 帳戶代表聯絡。
如需有關如何規劃及執行 Drupal 7 入口網站素材資源遷移至整合式入口網站的操作說明，請參閱「將 Drupal 7 入口網站遷移至整合式入口網站」。
做法 2：遷移至 Drupal 8
誰應考量這項功能？
API 供應商，他們善用 Drupal 7 的功能，並提供高度自訂功能，以及專屬的開發人員體驗。
由於 Drupal 7 和 Drupal 8 之間存在重大差異 (例如網頁轉譯引擎)，因此重新建立類似的自訂項目可能需要相當程度的自訂工作。如果您預計需要與 Drupal 8 專家合作，Apigee 帳戶代表可以為您推薦 Drupal 開發合作夥伴。雖然 Apigee 不提供 D8P 的代管服務，但 Pantheon 和 Acquia 有為 Apigee 客戶代管 D8P 的經驗。
選項 3：繼續使用 Drupal 7
誰應考量這項功能？
API 供應商已在使用 Drupal 7，只是希望有更多時間做出決定。
Drupal 7 專案已發布 2021 年長期支援 (LTS) 的時間表。這項代管服務的公告不會影響 Drupal 7 與 Apigee Edge 整合的模組支援服務。不過，請注意，任何希望繼續使用 Drupal 7 的雲端客戶，必須在 2020 年 5 月 31 日前，直接向其代管服務供應商負責帳戶。
如何匯出資料 (雲端客戶)？
如要匯出 Drupal 資料，請參閱 Pantheon 或 Acquia 匯出程序。
如果我沒有採取必要行動，會發生什麼事？
2020 年 5 月 31 日後，您和客戶將無法使用 D7P。您將無法在 D7P 上進行管理或開發，且客戶也無法登入 D7P 入口網站。所有 Apigee 代管的 D7P 入口網站將於 2020 年 5 月 31 日後停用。
如需進一步資訊或協助，可以與誰聯絡？
如要進一步瞭解 D7P 停止代管服務的相關資訊，請在 Apigee 支援服務入口中登錄支援單，主旨行請填寫「Drupal 7 開發人員入口網站 - 代管服務」。
是否有任何工具或支援資源可協助將 D7P 遷移至 D8P？
雖然 Apigee 不會直接支援 Drupal，但您的 Apigee 帳戶代表可以為您安排與 Drupal 專家聯絡，協助您進行遷移和自訂開發作業。
是否有任何工具或支援資源可協助將 D7P 遷移至整合式入口網站？
如需有關如何規劃及執行 Drupal 7 入口網站素材資源遷移至整合式入口網站的操作說明，請參閱「將 Drupal 7 入口網站遷移至整合式入口網站」。
雖然沒有可用工具可從 Drupal 遷移至 Apigee 管理的入口網站，但 Apigee 可能可以協助您進行遷移。最適合的候選項目是未投入大量資金進行可能無法順利轉移的自訂開發作業，例如特定工作流程或核准工具。如需更多資訊，請與您的 Apigee 客戶經理聯絡。
SmartDocs 有哪些變更？
以下各節將說明 Drupal 8 中新 SmartDocs 與 Drupal 7 的差異。
新版 SmartDocs 功能與以 Drupal 7 為基礎的版本有何差異？
您可能熟悉與 Drupal 7 開發人員入口網站搭配使用的 SmartDocs。請參閱「使用 SmartDocs 為 API 撰寫說明文件」。
Drupal 8 中的 SmartDocs 提供許多 API 參考說明文件中常見的功能，現在可直接從 OpenAPI 規格執行。詳情請參閱「記錄 API」。
SmartDocs 是否支援 OpenAPI 規範 3.0.x？
Drupal 8 入口網站提供的新 SmartDocs 支援 OpenAPI 規格 3.0.x。日後將提供更完善的規格新功能支援。
SmartDocs 支援哪些類型的驗證？
SmartDocs 中的「Try this API」面板可搭配未加密的端點或使用基本、API 金鑰或 OAuth 驗證的安全端點，這取決於 OpenAPI 規範中定義的安全性方法。OAuth 支援以下流程：授權碼、隱含、密碼和用戶端憑證。
SmartDocs 是否是唯一的 API 說明文件選項？
SmartDocs 是 Apigee 針對 OpenAPI 規格驅動的 API 說明文件所提供的現成解決方案，但 Apigee 也認為提供多種選擇是件好事。針對 Drupal 8 入口網站，API 目錄模組支援其他轉譯解決方案，例如 Swagger UI 欄位格式設定器。