總覽與整合流程

本文提供詳細操作說明,協助您設定及配置 Apigee API 中心連接器,以便將 Apigee Edge for Private Cloud 安裝項目的 API 中繼資料和執行階段分析資料,轉移至 Google Cloud 的 API 中心。

Apigee Edge for Private Cloud 和 API 中心整合功能,可將內部部署的 Apigee 環境與 Google Cloud 的 API 中心連結。這項整合功能可讓重要的 API 中繼資料 (例如 API Proxy 定義、政策等) 和執行階段數據分析資料,從 Apigee for Private Cloud 安裝直接匯入 API 中心,集中且全面地呈現 API 情況。

總覽

這項整合功能的核心是讓 Apigee Private Cloud 使用者將 API 資訊加入 API Hub。也就是說,您可以運用 API 中心的功能,探索、管理及集中管理來自內部部署 Apigee 部署作業的 API。

重要元件

  • API Hub (Google Cloud):以雲端為基礎的中央平台,用於整合及管理 API 中繼資料和執行階段資料。
  • Apigee 中樞連接器:與 Apigee Edge for Private Cloud 環境一併安裝的新元件。這個連結器是主要代理程式,負責從 Apigee Edge for Private Cloud 擷取資料,並安全地發布至 Google Cloud。
  • 訊息處理器 (MP):現有的 Apigee 元件會重新設定為「雙重寫入」執行階段數據分析資料至共用的網路檔案系統 (NFS),供 Apigee API 中樞連接器使用。
  • 網路檔案系統 (NFS):共用儲存空間磁碟區,用於暫時儲存 MP 的分析資料,再由 Apigee API 中樞連接器處理及上傳。
  • Google Cloud Pub/Sub:Apigee API Hub for Private Cloud 連接器使用的訊息服務,可將 API 中繼資料和執行階段資料安全地串流至 API Hub。
  • Google Cloud 服務帳戶:用於安全地驗證及授權 Apigee API Hub for Private Cloud 連接器,與 Pub/Sub 和 API Hub 服務互動。

整合流程

整合作業會遵循結構化程序,確保資料傳輸和準確度:

  1. 初始設定和佈建:
    • 首先,請設定 Google Cloud 專案,並在其中佈建 API 中心。
    • 建立 Google Cloud 服務帳戶,然後建立「外掛程式執行個體」,向 API Hub 註冊 Apigee for Private Cloud 機構。這個步驟會提供設定所需的專屬 Pub/Sub 主題和外掛程式例項 ID。
  2. 安裝 Private Cloud 連接器的 Apigee API Hub:
    • Apigee API hub for Private Cloud 連接器 (RPM 套件) 會安裝在專用 VM 上,與 Apigee for Private Cloud 環境並存。這需要使用相容的 Apigee for Private Cloud 版本。
  3. 私人雲端連接器設定適用的 Apigee API 中心:
    • 連接器會使用在建立 API Hub 外掛程式時取得的詳細資料 (Pub/Sub 主題、外掛程式執行個體 ID、服務帳戶詳細資料) 進行設定。
    • 系統會建立 Google Cloud 服務 (透過服務帳戶金鑰) 和 Apigee Management Server (透過 Base64 編碼憑證) 的驗證。
    • 您也可以在這裡設定共用 NFS 的路徑。
  4. 訊息處理器 (MP) 設定:
    • Apigee 訊息處理器已更新,可為 Analytics 資料啟用「雙重寫入」機制。也就是說,系統會將分析記錄寫入傳統分析系統和指定的 NFS 共用資料夾。
  5. 資料流程:
    • API 中繼資料:Private Cloud 連接器的 Apigee API 中樞會從 Apigee 管理伺服器擷取 API 中繼資料,並發布至 Google Cloud 中指定的中繼資料 Pub/Sub 主題,然後將資料提供給 API 中樞。
    • 執行階段資料:訊息處理器會將分析資料寫入共用的 NFS。Apigee Hub 連接器會監控這個 NFS、處理執行階段資料,並將資料發布至 Google Cloud 中指定的執行階段資料 Pub/Sub 主題,以便匯入 API Hub。
  6. 監控與疑難排解:
    • Apigee API 中心提供私有雲連線器的本機狀態端點,可供您監控中繼資料和執行階段資料的上傳進度。
    • 詳細記錄可用於排解啟動、資料移轉或連線相關問題。

相互依賴關係:

  • Apigee API Hub for Private Cloud 連接器必須正確掛接 NFS,且本身和所有訊息處理器都能存取 NFS。
  • 必須為 NFS 設定雙重寫入功能,才能啟用執行階段資料收集功能。
  • 正確的 Google Cloud 服務帳戶角色和 API Hub 外掛程式執行個體詳細資料,是連接器驗證和資料發布功能的必要條件。

這項整合功能提供強大的機制,可將內部部署的 Apigee API 納入 API 中心提供的集中式管理和可視性,進而提升 API 治理和洞察力。