設定入口網站的網址

Apigee 提供 Apigee 開發人員服務入口網站 (或簡稱「入口網站」),您可以使用這個入口網站建構及推出自訂網站,為開發社群提供所有這些服務。Edge 客戶可以在雲端或地端部署環境中建立自己的開發人員入口網站。詳情請參閱「什麼是開發人員入口網站?」。

新版 Edge UI 會在「發布」>「入口網站」 (或「發布」>「開發人員」) 頁面上顯示「開發人員入口網站」按鈕,點選後即可開啟與機構相關聯的入口網站。根據預設,該按鈕會開啟下列網址:

http://live-orgname.devportal.apigee.com

其中 orgname 是機構名稱。

您可以使用機構屬性在機構層級設定開發人員入口網站網址,或在 New Edge UI 中設定全域備用網址範本。

設定組織的入口網站網址

您可以為特定機構設定不同的入口網址,或在機構中設定下列屬性,完全停用按鈕:

  • features.devportalDisabled:設為 false (預設) 可啟用按鈕,設為 true 則可停用。
  • features.devportalUrl:設為機構的開發人員入口網站網址。

您會為每個機構分別設定這些屬性。如要設定這些屬性,請先使用下列 API 呼叫,判斷組織目前的屬性設定:

curl -H "Content-Type:application/json" -u adminEmail:pword -X GET \
  http://ms_IP:8080/v1/organizations/orgname

這項呼叫會傳回物件,以以下形式說明機構:

{
  "createdAt" : 1428676711119,
  "createdBy" : "me@my.com",
  "displayName" : "orgname",
  "environments" : [ "prod" ],
  "lastModifiedAt" : 1428692717222,
  "lastModifiedBy" : "me@my.com",
  "name" : "orgname",
  "properties" : {
    "property" : [ {
      "name" : "foo",
      "value" : "bar"
    } ]
  },
  "type" : "paid"
}

請注意物件 properties 區域中的任何現有屬性。在機構上設定屬性時,properties 中的值會覆寫所有目前的屬性。因此,如要在組織中設定 features.devportalDisabled 或 features.devportalUrl,請務必在設定時複製任何現有屬性。

使用下列 PUT 呼叫,在機構上設定屬性:

curl -H "Content-Type:application/json" -u adminEmail:pword -X PUT \
  http://ms_IP:8080/v1/organizations/orgname \
  -d '{
    "displayName" : "orgname",
    "name" : "orgname",
    "properties" : {
      "property" : [
        {
          "name" : "foo",
          "value" : "bar"
        },
        {
          "name": "features.devportalUrl",
          "value": "http://dev-orgname.devportal.apigee.com/"
        },
        {
          "name": "features.devportalDisabled",
          "value": "false"
        }
      ]
    }
  }'

在 PUT 呼叫中,您只需要指定 displayName、name 和 properties。請注意,這項呼叫包含最初在機構上設定的 foo 屬性。

在 New Edge 使用者介面中設定全域備用入口網站網址範本

如果機構未設定 features.devportalUrl,New Edge UI 會使用 conf_uebe_dev_portal_template 定義的全球備用範本 (預設為 http://live-{org}.devportal.apigee.com,其中 {org} 會替換為機構名稱)。

如要在新版 Edge UI 中變更全域備用網址範本,請按照下列步驟操作:

  1. 在編輯器中開啟 /opt/apigee/customer/application/management-ui.properties。 如果檔案不存在,請建立檔案:
    vi /opt/apigee/customer/application/management-ui.properties
  2. 使用 {org} 做為機構名稱的預留位置,設定 conf_uebe_dev_portal_template:
    conf_uebe_dev_portal_template="https://portal.mycompany.com/{org}"
  3. 儲存變更,並確認檔案擁有者是 apigee 使用者:
    chown apigee:apigee /opt/apigee/customer/application/management-ui.properties
  4. 重新啟動 New Edge UI:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart