透過指令列部署 Proxy

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。 資訊

本主題說明如何從指令列部署 Proxy。Apigee Edge 提供兩種 提供的選項。首先是使用 Apigee Edge 部署工具 以 Python 編寫而成另一種則是設定並執行殼層指令碼。

當您直接與 Proxy 來源合作時，使用指令列部署技術 檔案。您離線工作的原因有很多。建議使用 或者您正在開發需要 Java 編碼的政策，而 主要是在 IDE 運作本節介紹的技術可讓您上傳 將來源檔案部署至所選的 API 服務環境。

如果您主要透過管理 UI 作業，請參閱在使用者介面中部署 Proxy。

您目前查看的是 Apigee Edge 說明文件。
參閱 Apigee X 說明文件。 資訊

執行 Apigee Edge Python 部署工具

Apigee Edge Python 部署工具可與 Edge Management API 搭配使用，以匯入及部署 API Proxy 執行要求。這項工具在 GitHub 上的 API 平台範例發布作業中提供。詳情請見 使用範例 API Proxy。

使用 Apigee Edge Python 工具，透過單一簡單的方式匯入 (上傳) 及部署 API 上傳資料集之後，您可以運用 AutoML 自動完成部分資料準備工作

部署工具必須在 API 平台發行時從基本目錄執行 樣本分佈，其中基本目錄是 setup 的父項目錄 和 tools 目錄

在下列指令中，將 Proxy 名稱、您的 Edge 使用者名稱和密碼，以及 Edge 以及包含 API Proxy 的 "apiproxy" 目錄：

python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /

例如：

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /

這個指令會壓縮檔案、透過 Apigee Edge 推送至貴機構，然後進行部署 複製到指定環境

部署工具會自動探索 API 目前的修訂版本 Proxy、取消部署現有的修訂版本，以及部署漸進式 API 修訂版本 Proxy 上。

成功後，您會看見下列格式的輸出內容：

Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml
Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml
Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml
Imported new proxy version 1
Environment: test
  Revision: 1 BasePath = /
  State: deployed

根據預設，工具會將 API Proxy 上傳至 https://api.enterprise.apigee.com。 對應及部署在雲端中的 Edge您也可以使用這項工具將 API Proxy 上傳到 指定 -h 標記的內部部署版本 Edge：

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080

在這個範例中，您要指定 Edge 管理伺服器的 IP 位址。如果您為 管理伺服器的 DNS 記錄，您可以使用下列格式指定網址：

https://ms_URL:8080

指令的標記完整清單如下：

  • -n：API Proxy 的名稱。
  • -u：您在 Apigee 機構中帳戶的使用者名稱與密碼 邊緣
  • -o：擁有帳戶的機構名稱。
  • -e：應部署 API Proxy 的環境 (test 或 prod)。
  • -d：包含 API Proxy 檔案的目錄路徑。您的 API Proxy 檔案必須儲存在名為「apiproxy」的目錄中。這個值是 內含「apiproxy」的目錄而非直接導向 「apiproxy」目錄本身
  • -p：做為模式比對的 URI 路徑，用來將傳入訊息轉送至這個 API Proxy 部署作業在多數情況下，您應將這個值設為「/」，除非您有進階操作 部署和轉送需求已定義用於 API Proxy 轉送的主要路徑 API Proxy 的 ProxyEndpoint 設定檔。
  • -h：邊緣網址。預設值為 https://api.enterprise.apigee.com。 對應及部署在雲端中的 Edge如果是地端部署部署作業，請使用 Edge 網址 管理伺服器和通訊埠 8080，如下所示： 
    https://ms_URL:8080

    或者，使用管理伺服器的 IP 位址，例如 https://192.168.11.111:8080。

設定及執行部署殼層 指令碼

最簡單的方法是執行 API Proxy 範例提供的部署指令碼。貝殼 會包裝 Apigee Edge Python 部署工具

從 /simplyProxy 目錄執行：

$ sh deploy.sh

畫面上會顯示下列訊息：

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]:

輸入密碼，然後按 ENTER 鍵。

系統隨即會顯示以下內容：

Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com

您會看到以下訊息：

Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]:

就必須修改 /setup/setenv.sh 檔案中的 平台樣本分佈情形如需相關操作說明，請參閱 README 或 Apigee Edge API。

成功後，部署工具會將檔案寫入 /apiproxy, 匯入項目底下 部署至 Apigee Edge 上的套件，然後將 API Proxy 部署至「test」 環境。

現在可以叫用您的 API Proxy 了。