私有雲的邊緣 4.16.09 版
使用 setup-org 指令執行新手上路程序。您必須在管理伺服器節點上執行這個指令。
在新手上路流程中,指令碼會:
- 建立機構。
- 將指定使用者設為機構管理員。
- 這位使用者必須與系統管理員管理員使用者不同。也就是說,請勿將系統管理員管理員使用者做為機構管理員使用者。
- 您可以為機構管理員指定現有使用者,或是設定指令碼來建立新使用者。
- 根據預設,建立機構與 Pod 的關聯後,會將其與「閘道」Pod 建立關聯。
- 建立環境。
- 為環境建立虛擬主機。
- 將環境與所有訊息處理器建立關聯。
- 啟用數據分析功能。
用於新手上路的設定檔
將設定檔傳送至 setup-org 指令。叫用 setup-org 指令並指定 -f 選項,包括無聲設定檔的路徑:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
如要採用無訊息安裝,唯一的要求是「apigee」使用者必須存取或讀取設定檔。
以下為無聲設定檔範例。您可以視需要加以編輯:
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=adminPassword # 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 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 # 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 記錄,請參閱「設定虛擬主機」以瞭解詳情。 - 針對傳輸層安全標準 (TLS)/安全資料傳輸層 (SSL) 設定,請參閱 Keystore 和 Truststores 和為私人雲端設定 API 的傳輸層安全標準 (TLS) 存取權,進一步瞭解建立 JAR 檔案和設定傳輸層安全標準 (TLS)/安全資料傳輸層 (SSL) 設定的其他層面。
新手上路
- 在管理伺服器節點中安裝 apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision 安裝 - 在管理伺服器節點上執行指令:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
設定檔必須可供「apigee」使用者存取或讀取。
新手上路驗證
完成新手上路流程後,請在管理伺服器節點發出下列 CURL 指令,驗證系統的狀態。
- 請發出以下 CURL 指令,檢查管理伺服器上的使用者和機構狀態:
> curl -u <adminEmail>:<admin Passwd> http://localhost:8080/v1/users
> curl -u <adminEmail>:<admin Passwd> http://localhost:8080/v1/organizations
> - 如果您已經啟用 Analytics (分析),請使用下列指令:
> curl -u <adminEmail>:<admin Passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provision/axstatus - 您也可以在機器 2 執行下列指令,啟動 psql:
> psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
在命令提示字元中,輸入下列指令,查看機構的數據分析資料表:Apigee=# <商品名稱>\d)。
- 透過網路瀏覽器存取 Apigee Edge 使用者介面。請注意,安裝結束時您已記下管理控制台網址。
- 啟動您偏好的瀏覽器,然後輸入 Edge UI 的網址。如下所示,IP 位址是機器 1,或是您針對替代設定安裝使用者介面的任何機器:
http://192.168.56.111:9000/login
9000 是 UI 使用的通訊埠編號。如果您要直接在代管 Edge UI 的伺服器上啟動瀏覽器,可以使用以下格式的網址:
http://localhost:9000/login
注意:請確保通訊埠 9000 已開啟。 - 在控制台登入頁面上,指定 Apigee 系統管理員的使用者名稱/密碼。
注意:這是您在安裝期間設定的全域系統管理員密碼。此外,你也可以:
- 啟動您偏好的瀏覽器,然後輸入 Edge UI 的網址。如下所示,IP 位址是機器 1,或是您針對替代設定安裝使用者介面的任何機器:
- 註冊新的 Apigee 使用者帳戶,並使用新使用者憑證登入。
- 按一下「Sign In」,瀏覽器會重新導向至:
http://192.168.56.111:9000/platform/#/<orgname>/
並開啟資訊主頁,讓您設定之前建立的機構 (如果使用 Apigee 管理員憑證登入)。 - 如果您是 Edge 新手,您現在可以建立第一個 API Proxy。詳情請參閱「建構第一個 API Proxy」一文。
另請參閱範例章節,包括「範例清單」,以及模擬目標 REST 樣式的 API。您可以在 Mock Target API 的 API 建構實驗中使用這些 API。
- 按一下「Sign In」,瀏覽器會重新導向至: