步驟 10:部署 API Proxy

您已設定 Google Cloud 和 Apigee UI,並安裝及設定執行階段,現在可以瞭解這些項目如何搭配運作。

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

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

如要使用 API Proxy 精靈建立簡單的 API Proxy,請按照下列步驟操作:

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

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

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

    API 代理程式的詳細資料應如下所示:

  7. 點選「下一步」
  8. 在「政策」畫面中,選取「Pass through (no authorization)」(直接傳遞 (不授權)) 做為安全性選項。
  9. 點選「下一步」
  10. 在「Summary」(摘要) 畫面中,選取要部署 Proxy 的環境,然後按一下「Create and Deploy」(建立並部署)

    Hybrid 會產生 Proxy (有時稱為「Proxy 組合」):

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

    Apigee 會顯示「Proxies」(Proxy) 檢視畫面,其中列出 API Proxy。新的 Proxy 應會顯示綠色狀態指標,表示已部署完成。

2. 呼叫 API Proxy

當 UI 顯示 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

    例如:

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

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