開發人員服務入口網站規定

開發人員服務入口網站 4.16.09 版

以下為安裝作業的軟硬體需求。

硬體

規定

作業系統

這些安裝操作說明和提供的安裝檔案已在此處列出的作業系統中測試:https://apigee.com/docs/api-services/reference/supported-software

RAM

1 GB

硬碟

10 GB

網路介面

必須連上網路。

在安裝過程中,安裝程式會從網路下載資源。如果您的環境已設為 Proxy 傳出的 HTTP 和 HTTPS 要求,您必須設定 Proxy,才能正確處理下載期間可能發生的重新導向要求。

舉例來說,向 https://drupal.org/ 提出的要求會傳回 HTTP 301 狀態碼,並重新導向至 https://www.drupal.org/

您必須將 Proxy 設定為傳回 HTTP 200 狀態碼,其中包含來自重新導向的內容。

以 SAP 安裝作業時,如果您的環境設為代理傳出 HTTPS 要求,則 Proxy 必須支援 TLSv1.0。OpenSSL 0.9.8 不支援 TLSv1.1 或 TLSv1.2,僅支援 TLSv1.0。

MySQL 資料庫需求

如果選擇在與開發人員通路服務相同的機器上安裝 MySQL Server,開發人員 Channel Services 安裝程式會提示您輸入資料庫名稱和資料庫使用者,然後為您安裝 MySQL 伺服器並建立資料庫結構定義。安裝的版本是適用於您的 OS 的最新版本。

如果您想將 MySQL 伺服器安裝在不同的系統上,必須先在該系統上安裝 MySQL 伺服器,再啟動開發人員 Channel Services 安裝程式。您必須安裝 MySQL 5.0.15 以上版本。

開發人員通路服務安裝程式需要 MySQL 伺服器含有具有空白資料庫結構定義的資料庫。Developer Channel Services 安裝程式會提示您輸入資料庫主機名稱、資料庫名稱和資料庫使用者。安裝程式接著會連線至資料庫,以建立預設的資料庫資料表和資料。

開發人員通路服務會透過資料庫使用者連線至資料庫,而且必須具備下列權限:SELECT、INSERT、UPDATE、DELETE、CREATE、DROP、INDEX、ALTER、CREATE TEMPORARY TABLES 和 LOCK TABLES。

舉例來說,如要建立名為 devportal 的資料庫和名為 devportal 的使用者:

  1. 在系統上安裝 MySQL 伺服器。
  2. 使用下列指令,以超級使用者身分登入 MySQL:
    > MySQL -u root -p
  3. 在系統提示時輸入根密碼。
  4. 在 MySQL> 提示中,輸入下列內容來建立開發使用者:
    MySQL>create user 'devportal'@'localhost', by 'devportal';
    MySQL> 將 *.* 授予「devportal'@'localhost';
    MySQL> 清除權限」;
    執行 > 結束
  5. 在系統提示中,建立 devportal 資料庫:
    > MySQLadmin -u devportal -p create devportal

    輸入 devportal 密碼。
  6. 登入 MySQL 並授予從入口網站伺服器 IP 存取 devportal 的權限:
    MySQL> GRANT ALL ON ON deval.*。TO devportal@'portalIP' IDENTIFIED BY 'portalIP';

    ,其中 portalIP 是入口網站伺服器的 IP 位址,portalIP開發人員使用者的密碼。
  7. 編輯 /etc/my.cnf,將 bind-address 設定為 MySQL 伺服器的 IP 位址。
  8. 重新啟動 MySQL:
    > /etc/init.d/MySQLd restart
  9. 確認 MySQL 伺服器的通訊埠 3306 已開啟。這個程序取決於您的作業系統。舉例來說,如果是 Linux,請使用下列指令:
    > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j accept

安裝開發人員 Channel Services 時,請指定不要在本機安裝 MySQL 伺服器。然後系統會提示您輸入遠端資料庫的 IP 位址、使用者名稱及資料庫名稱。

Red Hat Enterprise Linux (RHEL) 需求

RHEL 有必要訂閱,才能存取 Red Hat 中的軟體下載內容。伺服器必須能連線至網際網路,才能透過 yum 下載 RPM。如果使用 RHEL,伺服器必須在 Red Hat Network (RHN) 中註冊,並註冊至伺服器選用版本。

系統會在安裝期間檢查 Red Hat 需求條件,若尚未註冊 RHEL,入口網站安裝程式會提示您。如果您已有 Red Hat 登入憑證,可以在開始安裝程序之前,使用下列指令註冊 RHEL:

> subscription-manager register --username=my_username --password=my_password --auto-attach 

my_usernamemy_password 改成您的 Red Hat 憑證。

如果您擁有試用版 RHEL,就能取得 30 天的試用授權。詳情請參閱 https://access.redhat.com/solutions/32790

SMTP 需求

根據預設,入口網站使用 PHP mail() 函式傳送郵件。PHP 會嘗試在本機系統上使用 sendmail 傳送電子郵件 (可在 PHP 的 php.ini 檔案中設定)。

在實際工作環境中,Apigee 會要求您設定 SMTP 伺服器,以便從入口網站傳送電子郵件。因此,您必須確保 Drupal 可以存取 SMTP 伺服器上的必要通訊埠。如果不是 TLS SMTP,通訊埠編號通常為 25。如果是已啟用 TLS 的 SMTP,通常是 465,但請向 SMTP 供應商確認。

其他規定

為了執行安裝,安裝軟體的使用者必須具備 Root 存取權。

部署架構需求

開發人員通路服務透過 REST API 與 Apigee 管理伺服器具有單一介面,可用於儲存及擷取使用者應用程式的相關資訊。視您的安裝設定而定,開發人員 Channel Services 必須能透過 HTTP 或 HTTPS 連線至管理伺服器。

開始安裝前的必要資訊

開始安裝前,您必須已提供下列資訊:

  1. 您要設定的平台:Red Hat 或 CentOS?如要安裝 Red Hat,機器則必須在 Red Hat Network 註冊才能下載 RPM。
  2. 您打算在本機電腦上安裝 MySQL 嗎?某些高可用性安裝作業會要求 MySQL 使用的機器與提供入口網站網頁的機器不同。在這種情況下,請不要在本機安裝 MySQL。如果您想在同一部電腦上輕鬆安裝所有內容,請在本機安裝 MySQL。
  3. 如果想存取遠端 MySQL 伺服器,以及遠端 MySQL 伺服器的主機名稱、通訊埠、資料庫名稱、使用者名稱和密碼。系統應會先設定遠端 MySQL 伺服器,再開始安裝。
  4. 網路伺服器的完整網域名稱為何?(這項資訊會新增至 /etc/hosts。)這必須是 IP 位址或主機名稱,例如 portalserver.example.com。預設值為 localhost
  5. 您想將 Apigee 的預設設定用於 Apache 虛擬主機嗎?系統會根據您在上述步驟 7 中指定的主機名稱,建立一個虛擬主機。
  6. 有了三項資訊,您的入口網站就能與 Apigee Edge 管理伺服器通訊。相關資訊如下:
    1. Apigee Management API 端點的網址:可以是主機名稱或 IP 位址。這是所有呼叫的 REST 端點,用於建立應用程式及為開發人員註冊應用程式金鑰。預設端點為 https://api.enterprise.apigee.com/v1

      如果是 Private Cloud 安裝的 Edge,其網址格式為:
      http://EdgeIp:8080/v1

      或:
      https://EdgeIp:SSLport/v1

      其中 EdgeIp 是 Edge 管理的 Edge 伺服器的 IP 位址, 例如 8443。
    2. Apigee 機構名稱:入口網站和 Apigee Edge 機構之間存在關係。您在設定 Management API 端點時,將會設定預設機構。預設值為 my-org。
    3. Management API 端點的使用者名稱和密碼:從入口網站對 Edge 發出的呼叫必須由貴機構的管理員執行。

      這個使用者名稱/密碼僅供貴機構的管理員使用,只能用來從入口網站連線至 Edge。舉例來說,如果您指定使用者的憑證,且該使用者在 Edge 上遭到刪除,那麼入口網站就無法再連線至 Edge。因此,請為貴機構建立這個連線專用的管理員。

      例如:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd