機構與環境維護

本節說明各種管理作業，例如建立、管理及移除 Apigee Edge 中的私有雲安裝中的 Apigee 機構、環境和虛擬主機。

如需機構、環境和虛擬主機的簡介，請參閱「關於地球、區域、Pod、機構、環境和虛擬主機」。

檢查使用者、機構和環境的狀態

在地端部署安裝 Edge Private Cloud 時，管理伺服器扮演相當重要的角色。您可以發出下列 curl 指令，在管理伺服器上檢查使用者、機構與部署狀態：

curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments

系統應在所有呼叫中顯示 200 HTTP 狀態。如果這些失敗，請執行下列操作：

  1. 請檢查 /opt/apigee/var/log/apigee/management-server 的管理伺服器記錄檔是否有任何錯誤。
  2. 請對管理伺服器發出呼叫，確認其是否正常運作。
  3. 從 ELB 中移除伺服器，然後重新啟動管理伺服器： 
    /opt/apigee/bin/apigee-service management-server restart

關於使用設定檔

以下顯示的指令會採用設定檔做為輸入。舉例來說，您可以將設定檔傳送至 setup-org 指令，定義機構的所有屬性，包括環境和虛擬主機。

如需完整的設定檔以及設定檔內可設定屬性的相關資訊，請參閱在機構上加入。

關於設定虛擬主機

Edge 上的虛擬主機會定義公開 API Proxy 的網域和邊緣路由器通訊埠，以及應用程式用來存取 API Proxy 的網址。虛擬主機也會定義要透過 HTTP 通訊協定或加密 HTTPS 通訊協定存取 API Proxy。

使用下列指令碼和 API 呼叫建立虛擬主機。建立虛擬主機時，必須指定下列資訊：

  • 您在 API Proxy 中用來參照該虛擬主機的名稱。
  • 虛擬主機路由器上的通訊埠。一般來說，這些通訊埠是從 9001 開始，並針對每個新的虛擬主機各增加一個。
  • 虛擬主機的主機別名。通常是虛擬主機的 DNS 名稱。

    在判斷處理要求的 API Proxy 時，Edge Router 會將傳入要求的主機標頭與主機別名清單進行比較。透過虛擬主機提出要求時，請指定與虛擬主機的主機別名相符的網域名稱，或指定路由器的 IP 位址和包含主機別名的主機標頭。

舉例來說，如果您在通訊埠 9001 上建立了具有 myapis.apigee.net 的主機別名，然後透過該虛擬主機向 API 執行 curl 要求，即可使用下列其中一種形式：

  • 如有 myapis.apigee.net 的 DNS 項目： 
    curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
  • 如果您沒有 myapis.apigee.net 的 DNS 項目： 
    curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'

    在第二種表單中，您將路由器的 IP 位址，並在主機標頭中傳遞主機別名。

如果沒有虛擬主機的 DNS 項目，相關選項

如果您沒有 DNS 項目，可以選擇將主機別名設為路由器的 IP 位址和虛擬主機的通訊埠，做為 routerIP:port。例如：

192.168.1.31:9001

接著，您將使用下列格式建立 curl 指令：

curl http://routerIP:9001/proxy-base-path/resource-path

我們建議使用這個選項，因為它可以和 Edge UI 搭配運作。

如果您有多個路由器，請為各個路由器新增主機別名，並指定各個路由器的 IP 位址和虛擬主機的通訊埠。

或者，您也可以將主機別名設為值，例如 temp.hostalias.com。接著，就必須在每次要求時傳遞 Host 標頭：

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

或是在 /etc/hosts 檔案中新增主機別名。例如，在 /etc/hosts 中新增這一行：

192.168.1.31   temp.hostalias.com

接著，您可以提出要求，就像擁有 DNS 項目一樣：

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path