步驟 2：部署 API Proxy

您已安裝及設定 Apigee Hybrid 執行階段和 Ingress 閘道，現在可以瞭解這些元件如何搭配運作。

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

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

  1. 在瀏覽器中開啟 Apigee 使用者介面。
  2. 在左上角的下拉式選單中選取機構。
  3. 在主畫面中選取「Proxy 開發」>「API Proxy」。
  4. 按一下「建立」，啟動 API Proxy 精靈。
  5. 選取「Reverse proxy」(最常見)。

    系統隨即會顯示「Proxy details」(Proxy 詳細資料) 檢視畫面。

  6. 透過下列設定設定 Proxy：
    • Proxy 名稱：輸入 myproxy。本節的其餘步驟會假設這是您 Proxy 的 ID。
    • 基本路徑：系統會自動設為 /，後面接著 Proxy 名稱，在本例中為 /myproxy。基本路徑是向 API 發出要求時所用網址的一部分。Apigee 會使用網址比對連入要求，並將要求轉送至適當的 API Proxy。
    • (選用) 說明：輸入新 API Proxy 的說明，例如「Testing Apigee hybrid with a simple proxy」。
    • 目標 (現有 API)：輸入「https://mocktarget.apigee.net」。這會定義 Apigee 在對 API Proxy 發出要求時叫用的目標網址。mocktarget 服務代管於 Apigee，並會傳回簡單資料。不需要 API 金鑰或存取權杖。

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

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

  7. 按一下「下一步」。
  8. 在「Deploy (optional)」(部署 (選用)) 下方，您可以在「Deployment environments」(部署環境) 欄位中，選取要部署 Proxy 的一或多個環境。 如果不想在這個時間點部署 Proxy，請將「部署環境」欄位留空。您隨時可以部署 Proxy。
  9. 按一下 [建立]。 Apigee 會產生 Proxy (有時也稱為「Proxy 組合」)。

Apigee 會顯示「Proxy summary」(Proxy 摘要) 檢視畫面。 如果您選擇部署 Proxy，則「部署」部分會顯示「修訂版本」編號，首次部署時為 1。「狀態」欄會顯示 Proxy 部署的環境，並以綠色狀態指標表示。

下方的「修訂版本」部分會顯示這個 Proxy 的所有修訂版本。按一下「端點摘要」欄中的任一「查看」項目，「端點」部分會顯示：

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

2. 呼叫 API Proxy

當 UI 顯示 Proxy 已部署完成，您可以使用 cURL 或所選的 REST 用戶端呼叫 Proxy。例如：

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

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

    kubectl get svc -n APIGEE_NAMESPACE -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 -v -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k -v
  5. 如果呼叫 Proxy 成功，會傳回 HTTP 200 回應碼和下列輸出內容。

    Hello, Guest!

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