私有雲版本 4.17.01 版本
使用 setup-org 指令來執行新手上路程序。您必須在管理伺服器節點上執行指令。
在新手上路流程中,指令碼會如下:
- 建立機構。
- 將指定的使用者設為機構管理員。
- 該使用者必須與系統管理員使用者不同。也就是說,請勿將 sys 管理員使用者設為機構管理員使用者。
- 您可以為機構管理員指定現有的使用者,或是設定指令碼來建立新使用者。
- 根據預設,系統會將機構與 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.
注意事項:
- 如果已有用來存取虛擬主機的 DNS 記錄,請指定 VHOST_ALIAS 的 DNS 記錄,並指定主機別名,並視需要指定通訊埠,例如「myapi.example.com」。如果您沒有 DNS 記錄,可以使用路由器的 IP 位址。
如要進一步瞭解如何設定虛擬主機,請參閱「Edge Demo 安裝規定」。 - 如需傳輸層安全標準 (TLS)/安全資料傳輸層 (SSL) 的設定資訊,請參閱「KeyStores 和 Truststores」和「設定私有雲的傳輸層安全標準 (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
設定檔必須能讓使用者存取或讀取設定檔。
新手上路驗證
完成新手上路程序後,請在管理伺服器節點上發出下列 CURL 指令,驗證系統狀態。
- 發出下列 CURL 指令,藉此確認管理伺服器的使用者和機構狀態:
> curl -u <adminEmail>:<adminpasswd> http://localhost:8080/v1/users
> curl -u <adminEmail>:<adminpasswd> http://localhost:8080/v1/organizations
<管理員密碼>> - 如果您已啟用數據分析功能,請使用下列指令:
> curl -u <adminEmail>:<adminpasswd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/Provisioning/axstatus - 您也可以在機器 2 上執行下列指令,查看 PostgreSQL 資料庫狀態,以便啟動 psql:
> psql -h /opt/apigee/var/run/apigee-postgresql -U Apigee Apigee
在命令提示字元中,輸入下列指令: - 使用網路瀏覽器存取 Apigee Edge 使用者介面。請記住,您記下安裝結尾的管理控制台網址。
- 啟動偏好的瀏覽器,並輸入 Edge UI 的網址。看起來會像下方這樣,其中的 IP 位址代表機器 1,或是您安裝 UI 以進行其他設定的機器:
http://192.168.56.111:9000/login
9000 是 UI 使用的通訊埠編號。如果您直接在代管 Edge UI 的伺服器上啟動瀏覽器,可以使用格式如下:
http://localhost:9000/login
注意:確認通訊埠 9000 已開啟。 - 在控制台登入頁面上,指定 Apigee 系統管理員的使用者名稱/密碼。
注意:這是您在安裝期間設定的全域系統管理員密碼。或者,您可以執行下列操作:
- 啟動偏好的瀏覽器,並輸入 Edge UI 的網址。看起來會像下方這樣,其中的 IP 位址代表機器 1,或是您安裝 UI 以進行其他設定的機器:
- 註冊新的 Apigee 使用者帳戶,並使用新使用者憑證登入。
- 按一下「Sign in」(登入),瀏覽器將重新導向至:
http://192.168.56.111:9000/platform/#/<orgname>/
並開啟資訊主頁,讓您設定先前建立的機構 (如果使用 Apigee 管理員憑證登入的話)。 - 如果您是第一次使用 Edge,可以建立第一個 API Proxy。詳情請參閱「建構第一個 API Proxy」。
另請參閱範例 (包含範例清單) 中的範例,以及可在 Mock Target API 自己的 API 建構實驗中使用的模擬目標 REST REST API。
- 按一下「Sign in」(登入),瀏覽器將重新導向至: