步驟 2：部署 API Proxy

您已設定 Google Cloud 和 Apigee UI，並安裝及設定執行階段，現在可以查看這些服務如何搭配運作了。

1. 使用 Apigee UI 建立新的 API Proxy

本節說明如何使用 API Proxy 精靈在 UI 中建立新的 API Proxy。

Cloud 控制台中的 Apigee

如要在 Cloud 控制台中使用 Apigee 建立新的 API Proxy，請按照下列步驟操作：

  1. 在瀏覽器中開啟 Cloud 控制台中的 Apigee UI。
  2. 在左上角的下拉式選單中選取機構。
  3. 在主畫面中，依序選取「Proxy development」>「API proxies」。
  4. 按一下「Create」。API Proxy 精靈就會啟動。
  5. 選取「Reverse proxy」 (最常見)。

    系統會顯示「Proxy details」檢視畫面。

  6. 按照下列設定設定 Proxy：
    • Proxy 名稱：輸入 myproxy。本節的其餘步驟假設這是您的 Proxy ID。
    • 基礎路徑：自動設為 /，後面加上 Proxy 名稱，在本例中為 /myproxy。Base path 是用於向 API 提出要求的網址的一部分。Edge 會使用網址比對並轉送傳入的要求，將其轉送至適當的 API Proxy。
    • (選用) 說明：輸入新 API Proxy 的說明，例如「使用簡易 Proxy 測試 Apigee 混合式服務」。
    • 目標 (現有 API)：輸入「https://mocktarget.apigee.net」。這會定義 Apigee 在對 API Proxy 提出要求時，要叫用的目標網址。mocktarget 服務由 Apigee 代管，並傳回簡單資料。不需要 API 金鑰或存取權杖。

    API Proxy 的詳細資料應如下所示：

    建立 Proxy 精靈中的 Proxy 詳細資料。

  7. 點選「下一步」。
  8. 在「政策」畫面中，選取「傳送 (不需授權)」做為安全選項。
  9. 點選「下一步」。
  10. 在「Deploy (optional)」下方，您可以選擇在「Deployment environments」欄位中，選取一或多個要部署 Proxy 的環境。如果您不想在此時部署 Proxy，請將「部署環境」欄位留空。您之後隨時可以部署 Proxy。
  11. 按一下「建立」。Apigee 會產生 Proxy (有時稱為「Proxy 套件」)。

Apigee 會顯示「Proxy summary」檢視畫面。如果您選擇部署 Proxy，部署專區會顯示修訂版本編號，首次部署時為 1。「狀態」欄會顯示已部署 Proxy 的環境，並顯示綠色狀態指標。

下方會顯示「Endpoints」部分：

  • Proxy 端點：您為 Proxy 設定的 basepath，在本例中為 /myproxy。
  • 目標端點：您為目標設定的基本路徑，在本例中為 https://mocktarget.apigee.net。

傳統版 Apigee

如要使用 Classic Apigee 建立新的 API Proxy，請按照下列步驟操作：

  1. 在瀏覽器中開啟 Apigee UI。
  2. 在左上角的下拉式選單中選取機構。
  3. 在主畫面中，依序選取「Develop」>「API Proxies」。
  4. 按一下「建立新 Proxy」，API Proxy 精靈就會啟動。
  5. 選取「Reverse proxy」 (最常見)。

    系統會顯示「Proxy details」檢視畫面。

  6. 按照下列設定設定 Proxy：
    • Proxy Name：輸入「myproxy」。本節的其餘步驟假設這是您的 Proxy ID。
    • Proxy Base Path：自動設為「/myproxy」。「Proxy Base Path」是用於向 API 提出要求的網址的一部分。Edge 會使用網址比對並轉送傳入的要求，將其轉送至適當的 API Proxy。
    • (選用) 說明：輸入新 API Proxy 的說明，例如「使用簡易 Proxy 測試 Apigee 混合式服務」。
    • 目標 (現有 API)：輸入「https://mocktarget.apigee.net」。這會定義 Apigee 在對 API Proxy 提出要求時，要叫用的目標網址。mocktarget 服務由 Apigee 代管，並傳回簡單資料。不需要 API 金鑰或存取權杖。

    API Proxy 的詳細資料應如下所示：

    「建立 Proxy」精靈中的 Proxy 詳細資料。

  7. 點選「下一步」。
  8. 在「政策」畫面中，選取「傳送 (不需授權)」做為安全選項。
  9. 點選「下一步」。
  10. 在「Summary」畫面中，選取要部署 Proxy 的環境，然後按一下「Create and Deploy」。

    Hybrid 會產生 Proxy (有時稱為「Proxy 套件」)：

    「Create Proxy」精靈的確認對話方塊。

  11. 按一下「前往 Proxy 清單」。

    Apigee 會顯示「Proxies」檢視畫面，列出 API Proxy 清單。新的 Proxy 應會顯示綠色狀態指標，表示已部署。

2. 呼叫 API Proxy

當使用者介面顯示 Proxy 已部署時，您可以嘗試使用 cURL 或所選的 REST 用戶端呼叫 Proxy。例如：

  1. 請確認 DOMAIN 環境變數已設為您在專案和組織設定 - 步驟 3：建立環境群組中，用於環境群組主機名稱的網域名稱。
    echo $DOMAIN

  2. 使用下列指令找出 Apigee 輸入閘道的外部 IP 位址和通訊埠：

    kubectl get svc -n apigee -l app=apigee-ingressgateway

    輸出內容應如下所示： 

    NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h
  3. 將外部 IP 和連接埠匯出至變數：
    export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS
export INGRESS_PORT=PORT_NUMBER
  4. 呼叫 API Proxy： 
    curl  -H Host:$DOMAIN --resolve \
  $DOMAIN:$INGRESS_PORT:$INGRESS_IP_ADDRESS  \
  https://$DOMAIN:$INGRESS_PORT/myproxy -k -v

    例如： 

    curl  -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k -v

如要進一步瞭解如何建構及部署 API Proxy，請參閱「建構第一個 Proxy 總覽」。