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

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

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

硬體

規定

作業系統

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

RAM

1 GB

硬碟

10 GB

網路介面

必須連上網際網路。

在安裝程序中,安裝程式會從網路下載資源。如果環境已設定為代理傳出 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 伺服器 (單機拓樸),開發人員頻道服務安裝程式會提示您輸入資料庫名稱和資料庫使用者,然後安裝 MySQL 伺服器並為您建立資料庫結構定義。已安裝的版本是 OS 可用的最新版本。

如果您想在另一個系統上安裝 MySQL 伺服器,必須先在該系統上安裝 MySQL 伺服器,再啟動開發人員管道服務安裝程式。您必須安裝 MySQL 5.0.15 以上版本。

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

「開發人員管道服務」會使用該資料庫使用者連線至資料庫,且必須具備下列權限:SELECT、INSERT、UPDATE、DELETE、CREATE、DROP、INDEX、ALTER、CREATE TEMPORARY TABLES、LOCK TABLES。

舉例來說,如要建立名為 devportaldevportal 的使用者:

  1. 在系統上安裝 MySQL Server。
  2. 使用以下指令以 root 使用者身分登入 MySQL:
    > mysql -u root -p
  3. 在系統提示時輸入根密碼。
  4. 在 mysql> 提示中輸入下列內容,建立開發環境使用者:
    mysql>建立使用者 'devportal'@'localhost' (由「devportal」識別);
    mysql> 將 *.* 上的所有權限授予「devportal'@'localhost」;
    mysql> flush 權限;
    mysql> quit
  5. 在系統提示中建立 devportal 資料庫:
    > mysqladmin -u devportal -p create devportal

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

    其中 portalIP 是入口網站伺服器的 IP 位址,而 devportalPWdevportal 使用者的密碼。
  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

安裝開發人員管道服務時,請指定不要在本機安裝 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 存取權。

部署架構需求

開發人員 Channel Services 透過 REST API 提供單一的 Apigee 管理伺服器介面,方便儲存及擷取使用者應用程式的相關資訊。視安裝情況而定,開發人員 Channel Services 必須能夠透過 HTTP 或 HTTPS 連線至管理伺服器。

開始安裝前的必要資訊

開始安裝前,請務必準備好下列資訊:

  1. 您要設定哪個平台:Red Hat 或 CentOS?如果這是 Red Hat 安裝作業,機器必須在 Red Hat Network 上註冊,才能下載 RPM。
  2. 您是否打算在本機電腦上安裝 MySQL?部分 HA 安裝作業需要將 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

      如果是 Edge for Private Cloud 安裝作業,網址格式如下:
      http://EdgeIp:8080/v1

      或:
      https://EdgeIp:SSLport/v1

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

      這個使用者名稱/密碼適用於貴機構的管理員,且只能用於透過入口網站連線至 Edge。舉例來說,如果您指定使用者的憑證,而該使用者在 Edge 中遭到刪除,則入口網站將無法再連線至 Edge。因此,請在貴機構中建立專門用於此連線的管理員。

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