機構與環境維護

本節涵蓋各種管理作業，例如在 Apigee Edge for Private Cloud 安裝中建立、管理及移除 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 公開的網域和 Edge 路由器通訊埠，以及應用程式用來存取 API Proxy 的網址。虛擬主機也會定義 API Proxy 是透過 HTTP 通訊協定存取，還是透過加密的 HTTPS 通訊協定存取。

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

• 您在 API 代理程式中參照虛擬主機時使用的名稱。
• 虛擬主機的路由器通訊埠。這些連接埠通常從 9001 開始，每新增一個虛擬主機，連接埠就會遞增 1。
• 虛擬主機的主機別名。通常是虛擬主機的 DNS 名稱。

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

如果虛擬主機有 DNS 項目

舉例來說，如果您在連接埠 9001 上建立主機別名為 myapis.apigee.net 的虛擬主機，則透過該虛擬主機對 API 執行 curl 要求時，可使用下列格式：

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

如果虛擬主機沒有 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