建議採取的後續步驟

本頁內容適用於 ApigeeApigee Hybrid

查看 Apigee Edge 說明文件。

這個步驟的內容

請按照下列步驟建立及部署測試 API Proxy。最後,請向 API Proxy 傳送 HTTP 要求,測試 API Proxy。

建立及部署 API Proxy

Apigee 的佈建程序不會自動為您建立及部署 API Proxy。您必須手動建立及部署 Proxy。

Cloud 控制台中的 Apigee UI

如要建立及部署第一個 Proxy:

  1. 在 Google Cloud 控制台中,前往「Proxy development」(Proxy 開發) >「API proxies」(API Proxy) 頁面。

    前往 API Proxy

  2. 請務必從「Google Cloud」窗格的專案挑選器中選取機構名稱。機構名稱與 Google Cloud 專案名稱相同。
  3. 按一下「+ 建立」

    「建立 Proxy」頁面隨即開啟。

  4. 在「Proxy template」方塊中,選取「Reverse proxy (most common)」
  5. 在「步驟 1:Proxy 詳細資料」中,使用下列值設定 Proxy:
    參數名稱
    Proxy 名稱 hello-world
    基本路徑 /hello-world
    目標 (現有 API) mocktarget.apigee.net
  6. 點選「下一步」
  7. 在「步驟 2:部署 (選用)」中:
    • 部署環境:選用。使用核取方塊選取要部署 Proxy 的一或多個環境。如果不想在這個時間點部署 Proxy,請將「Deployment environments」(部署環境) 欄位留空。您之後隨時可以部署 Proxy。
    • 服務帳戶:選用。將服務帳戶附加至部署作業,即可讓 Proxy 存取 Google Cloud服務,如服務帳戶的角色和權限中所指定。
  8. 按一下「建立」。

    新的 API Proxy 會在所選環境中建立及部署。

  9. 新建立的 Proxy「摘要」頁面隨即開啟。 「狀態」下方顯示綠色勾號,表示已成功部署 Proxy。如果未部署 Proxy,請參閱「 部署 API Proxy」,然後按照步驟手動部署。
  10. 在左側導覽窗格中,依序選取「管理」>「環境」>「環境群組」
  11. 複製環境群組的主機名稱。您將在後續步驟中使用這個主機名稱呼叫 API 代理。

傳統版 Apigee

如要建立及部署第一個 Proxy:

  1. 登入 Apigee 使用者介面
  2. 請務必從使用者介面左上角的下拉式選單中選取機構名稱。機構名稱與 Google Cloud 專案名稱相同。
  3. 在主要檢視畫面中,按一下「API Proxy」
  4. 從「Select Environment」下拉式清單中,選取環境。
  5. 按一下「新建」
  6. 按一下「反向 Proxy (最常見)」
  7. 在「Proxy details」頁面中,使用下列值設定 Proxy:
    參數名稱
    名稱 hello-world
    基本路徑 /hello-world
    目標 (現有 API) https://mocktarget.apigee.net
  8. 點選「下一步」
  9. 在「Common policies」(通用政策) 頁面的「Security: Authorization」(安全性:授權) 下方,選取「Pass through (no authorization)」(直接傳遞 (不授權))
  10. 點選「下一步」
  11. 在「摘要」頁面的「選用部署」下方,選取要部署 Proxy 的環境。
  12. 按一下「建立並部署」

    新的 API Proxy 會在所選環境中建立及部署。

  13. 按一下「前往 Proxy 清單」。「狀態」下方顯示綠色勾號,表示 Proxy 已成功部署。如果未部署 Proxy,請參閱「 部署 API Proxy」,然後按照步驟手動部署。
  14. 在左側導覽窗格中,依序選取「管理」>「環境」>「群組」
  15. 按一下「在 Google Cloud 控制台中查看」
  16. 複製環境群組的主機名稱。您將在後續步驟中使用這個主機名稱呼叫 API 代理。
  17. 關閉 Google Cloud 控制台。

呼叫具有內部存取權的 Proxy

如果您在「 步驟 4:自訂存取路徑」中允許內部存取,請按照「 呼叫僅限內部存取的 API Proxy」一文中的操作說明進行。

呼叫可從外部存取的 Proxy

如果您在「 步驟 4:自訂存取轉送」中允許外部存取,請按照下列步驟操作:

  1. 為主機設定 DNS 項目。以下提供兩種方法:
    • 在註冊機構中,建立 A 記錄,將環境群組主機名稱指向精靈頁面「設定 DNS」下方顯示的 IP。舉例來說,如果主機名稱是 sales.example.com,IP 位址是 10.23.0.2,請將 sales.example.com 的記錄指向 10.23.0.2 位址。
    • 使用 Google Cloud DNS 將網址對應至 IP 位址。
  2. 在終端機視窗中傳送下列要求,測試 API 代理:
    curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \
      https://YOUR_INSTANCE_IP_OR_DNS/hello-world

    其中:

    • Host 標頭的值 (YOUR_ENV_GROUP_HOSTNAME) 是「環境」>「環境群組」頁面的主機名稱。

    成功的要求會傳回字串:Hello, Guest!。 如果要求未成功,請參閱「疑難排解」。

後續步驟