加入機構

私有雲版本 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 的其他設定資訊。

新手上路程序

  1. 在管理伺服器節點中安裝 apigee-provision
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision 安裝
  2. 在「管理伺服器」節點上執行指令:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    設定檔必須能讓使用者存取或讀取設定檔。

新手上路驗證

完成新手上路程序後,請在管理伺服器節點上發出下列 CURL 指令,驗證系統狀態。

  1. 發出下列 CURL 指令,藉此確認管理伺服器的使用者和機構狀態:
    > curl -u <adminEmail>:<adminpasswd> http://localhost:8080/v1/users
    > curl -u <adminEmail>:<adminpasswd> http://localhost:8080/v1/organizations
    <管理員密碼>>
  2. 如果您已啟用數據分析功能,請使用下列指令:
    > curl -u <adminEmail>:<adminpasswd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/Provisioning/axstatus
  3. 您也可以在機器 2 上執行下列指令,查看 PostgreSQL 資料庫狀態,以便啟動 psql:
    > psql -h /opt/apigee/var/run/apigee-postgresql -U Apigee Apigee

    在命令提示字元中,輸入下列指令:



  4. 使用網路瀏覽器存取 Apigee Edge 使用者介面。請記住,您記下安裝結尾的管理控制台網址。
    1. 啟動偏好的瀏覽器,並輸入 Edge UI 的網址。看起來會像下方這樣,其中的 IP 位址代表機器 1,或是您安裝 UI 以進行其他設定的機器:
      http://192.168.56.111:9000/login

      9000 是 UI 使用的通訊埠編號。如果您直接在代管 Edge UI 的伺服器上啟動瀏覽器,可以使用格式如下:
      http://localhost:9000/login

      注意:確認通訊埠 9000 已開啟。
    2. 在控制台登入頁面上,指定 Apigee 系統管理員的使用者名稱/密碼。
      注意:這是您在安裝期間設定的全域系統管理員密碼。或者,您可以執行下列操作:
  5. 註冊新的 Apigee 使用者帳戶,並使用新使用者憑證登入。
    1. 按一下「Sign in」(登入),瀏覽器將重新導向至:
      http://192.168.56.111:9000/platform/#/<orgname>/

      並開啟資訊主頁,讓您設定先前建立的機構 (如果使用 Apigee 管理員憑證登入的話)。
    2. 如果您是第一次使用 Edge,可以建立第一個 API Proxy。詳情請參閱「建構第一個 API Proxy」。

      另請參閱範例 (包含範例清單) 中的範例,以及可在 Mock Target API 自己的 API 建構實驗中使用的模擬目標 REST REST API。