如要加入機構,您必須建立新手上路設定檔,然後傳送該檔案
變更為 setup-org
指令。每個步驟都會在
後續追蹤。
如要瞭解如何使用 Management API 新增機構,請參閱 建立機構 虛擬環境和虛擬主機
建立新手上路設定檔
本節提供範例設定檔,讓您透過以下支援機構加入的機構:
setup-org
。
複製下列範例,並視需要為貴機構進行編輯:
IP1=192.168.1.1 # Specify the IP or DNS name of the Management Server. MSIP="$IP1" # Specify the Edge sys admin credentials. ADMIN_EMAIL="admin@email.com" APIGEE_ADMINPW=admin_password # If omitted, you are prompted for it. # Specify organization name. ORG_NAME=myorg # lowercase only, no spaces, underscores, or periods. # Specify the organization administrator user. # Either specify an existing user, or specify the information # necessary to create a new user. # Do not use the sys admin as the organization administrator. # # Create a new user for the organization administrator. NEW_USER="y" # New user information if NEW_USER="y". USER_NAME=new@user.com FIRST_NAME=new LAST_NAME=user # Org admin password must be at least 8 characters long and contain one uppercase # letter, one lowercase letter, and one digit or special character USER_PWD="newUserPword" ORG_ADMIN=new@user.com # # Or, specify an existing user as the organization admin, # omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD. # NEW_USER="n" # ORG_ADMIN=existing@user.com # Specify environment name. ENV_NAME=prod # lowercase only # Specify virtual host information. VHOST_PORT=9001 VHOST_NAME=default # If you have a DNS entry for the virtual host. VHOST_ALIAS=myorg-test.apigee.net # If you do not have a DNS entry for the virtual host, # specify the IP and port of each router as a space-separated list: # VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001" # Optionally configure TLS/SSL for virtual host. # VHOST_SSL=y # Set to "y" to enable TLS/SSL on the virtual host. # KEYSTORE_JAR= # JAR file containing the cert and private key. # KEYSTORE_NAME= # Name of the keystore. # KEYSTORE_ALIAS= # The key alias. # KEY_PASSWORD= # The key password, if it has one. # Specify the analytics group. # AXGROUP=axgroup-001 # Default name is axgroup-001.
注意事項:
VHOST_ALIAS
,如果您 已有 DNS 記錄可用於存取虛擬主機,請指定主機 別名或通訊埠,例如「myapi.example.com」。如果你沒有 DNS 記錄中,您可以使用路由器的 IP 位址。
如要進一步瞭解如何設定虛擬主機,請參閱設定 您必須設定虛擬主機
- 如需 TLS/SSL 設定,請參閱 Keystores 和 Truststores 及設定 私有雲 API 的 TLS 存取權,進一步瞭解如何建立 JAR 檔案。 以及設定 TLS/SSL 的其他層面
- 如要進一步瞭解如何設定虛擬主機,請參閱設定虛擬主機的 TLS 存取權 私有雲的 API
- 您無法建立兩個名稱相同的機構。這樣一來,第二個建立 失敗。
執行設定機構
建立新手上路設定檔後,請將該檔案傳送至 setup-org
執行新手上路程序的指令碼。您必須在管理伺服器上執行指令碼
節點。
加入機構時,setup-org
指令碼會執行以下操作:
- 建立新機構。
- 建立環境。
- 為環境建立虛擬主機。
- 將指定的使用者設為機構管理員。請注意:
- 您可以使用現有使用者,或是為機構管理員建立新使用者。
- 機構管理員不得與系統管理員相同。
- 將機構與「閘道」建立關聯。(這是預設值,無法 changed.)
- 將環境與所有訊息處理器建立關聯。
- 啟用數據分析。
如要執行 setup-org
:
- 在 Management Server 節點上安裝
apigee-provision
:/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
- 在 Management Server 節點上執行
setup-org
指令碼,並指向位於 您在「建立新手上路設定」一節中建立的設定檔 檔案:/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
設定檔必須可由「apigee」讀取內容。
- 確認您已成功加入機構。其中一種做法是記錄
在瀏覽器中要求以下網址:
http://IP_address:9000/login
其中 IP_address 是已安裝 Edge 之伺服器的 IP 位址 第一種是使用無代碼解決方案 AutoML 透過使用者介面建立機器學習模型
如需其他驗證步驟,請參閱「驗證新手上路程序」。
- 建立第一個 Proxy!
驗證新手上路程序
新手上路程序完成後,請發出下列資訊來驗證系統狀態
Management Server 節點上的 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/org_name/deployments
- 執行下列指令來查看數據分析:
curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
- 在節點 2 上執行下列指令,查看 PostgreSQL 資料庫狀態
(如安裝拓撲所示):
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
在命令提示字元中輸入下列指令,即可查看您專案的數據分析資料表 機構:
\d analytics."org_name.env_name.fact"
使用下列指令退出 psql:
\q
- 使用網路瀏覽器存取 Apigee Edge UI。別忘了,您已經記下了
。
- 啟動偏好的瀏覽器,然後輸入 Edge UI 網址。這個 API 看起來與
後面,節點 1 的 IP 位址 (如
安裝拓撲) 或
您可存取
安裝適用於其他設定的使用者介面:
http://192.168.56.111:9000/login
9000 是 UI 使用的通訊埠號碼。
如果要直接在代管 Edge UI 的伺服器上啟動瀏覽器, 可以使用以下形式的網址:
http://localhost:9000/login
- 在控制台登入頁面中,指定 Apigee 系統管理員的使用者名稱/密碼。
- 啟動偏好的瀏覽器,然後輸入 Edge UI 網址。這個 API 看起來與
後面,節點 1 的 IP 位址 (如
安裝拓撲) 或
您可存取
安裝適用於其他設定的使用者介面:
- 註冊新的 Apigee 使用者帳戶,然後使用新的使用者憑證登入。每月中的特定幾天
在控制台登入頁面中,按一下 [登入] 按鈕。
瀏覽器重新導向至
http://192.168.56.111:9000/platform/#/org_name/
並開啟資訊主頁,讓您設定所建立的機構 (假設您為 而非使用 Apigee 管理員憑證
建立第一個 Proxy
在您加入新機構並確認新手上路流程後 您現在可以建立第一個 Proxy。詳情請參閱「建構第一個 API Proxy」。
其他可能有用的資源包括: