私有雲的邊緣 4.17.09 版
安裝前,請確認下列事項:
- 請先安裝 Postgres,再安裝入口網站。您可以在安裝 Edge 時安裝 Postgres,或單獨安裝 Postgres 供入口網站使用。
- 如果您是單獨安裝 Postgres,則可與入口網站位於相同的節點。
- 如果您要連線至在 Edge 中安裝的 Postgres,且 Postgres 設為主要/待命模式,請指定 Postgres 伺服器的 IP 位址。
- 您正在使用支援的 64 位元版本 Red Hat Enterprise Linux、CentOS 或 Oracle 版本執行安裝作業。如要查看支援的版本清單,請參閱支援的軟體和支援的版本。
- 已安裝 Yum。
安裝程式只包含 Apigee Developer Services 入口網站所需的 Drupal 模組 (或簡稱為入口網站)。如要瞭解如何安裝其他提供的模組,請參閱「擴充 Drupal 7」。
安裝總覽
在節點上安裝 Edge apigee-setup 公用程式後,請使用該公用程式在節點上安裝入口網站。apigee-setup 公用程式的格式是:
> sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
將設定檔傳送至 apigee-setup 公用程式,其中包含安裝相關資訊。如果設定檔缺少任何必要資訊,apigee-setup 公用程式會提示您在指令列中輸入該資訊。
唯一的規定是設定檔必須可供「apigee」存取或讀取。
例如,使用以下指令安裝入口網站:
> sudo /opt/apigee/apigee-setup/bin/setup.sh -p dp -f myConfig
詳情請參閱「安裝 Edge apigee-setup 公用程式」。
建立設定檔
以下是入口網站安裝的無訊息設定檔範例。根據您的設定,視需要編輯這個檔案。使用 -f 選項來setup.sh即可加入此檔案。
IP1=IPorDNSnameOfNode # Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost. HOSTIP=$(hostname -i) # Specify the name of the portal database in Postgres. PG_NAME=devportal # Specify the Postgres admin credentials. # The portal connects to Postgres by using the 'apigee' user. # If you changed the Postgres password from the default of 'postgres' # then set PG_PWD accordingly. # If connecting to a Postgres node installed with Edge, # contact the Edge sys admin to get these credentials. PG_USER=apigee PG_PWD=postgres # The IP address of the Postgres server. # If it is installed on the same node as the portal, specify that IP. # If connecting to a remote Postgres server,specify its IP address. PG_HOST=$IP1 # The Postgres user credentials used by the portal # to access the Postgres database, # This account is created if it does not already exist. DRUPAL_PG_USER=drupaladmin DRUPAL_PG_PASS=portalSecret # Specify 'postgres' as the database. DEFAULT_DB=postgres # Specify the Drupal admin account details. # DO NOT set DEVPORTAL_ADMIN_USERNAME=admin. # The installer creates this user on the portal. DEVPORTAL_ADMIN_FIRSTNAME=firstName DEVPORTAL_ADMIN_LASTNAME=lastName DEVPORTAL_ADMIN_USERNAME=userName DEVPORTAL_ADMIN_PWD=pWord DEVPORTAL_ADMIN_EMAIL=foo@bar.com # Edge connection details. # If omitted, you can set them in the portal UI. # Specify the Edge organization associated with the portal. EDGE_ORG=edgeOrgName # Specify the URL of the Edge management API. # For a Cloud based installation of Edge, the URL is: # https://api.enterprise.apigee.com/v1 # For a Private Cloud installation, it is in the form: # http://<ms_ip_or_DNS>:8080/v1 or # https://<ms_ip_or_DNS>:TLSport/v1 MGMT_URL=https://api.enterprise.apigee.com/v1 # The org admin credentials for the Edge organization in the form # of Edge emailAddress:pword. # The portal uses this information to connect to Edge. DEVADMIN_USER=orgAdmin@myCorp.com DEVADMIN_PWD=pWord # The PHP port. # If omitted, it defaults to 8888. PHP_FPM_PORT=8888 # You must configure the SMTP server used by the portal. # The properties SMTPHOST and SMTPPORT are required. # The others are optional with a default value as notated below. # SMTP hostname. For example, for the Gmail server, use smtp.gmail.com. SMTPHOST=smtp.gmail.com # Use SSL for SMTP: 'y' or 'n' (default). SMTPSSL="n" # SMTP port (usually 25). # The value can be different based on the selected encryption protocol. # For example, for Gmail, the port is 465 when using SSL and 587 for TLS. SMTPPORT=25 # Username used for SMTP authentication, defaults is blank. SMTPUSER=your@email.com # Password used for SMTP authentication, default is blank. SMTPPASSWORD=yourEmailPassword
1. 測試與 Apigee Edge 的連線
在入口網站伺服器上的命令提示字元中執行下列 cURL 指令,測試與 Edge 管理伺服器之間的連線:
> curl -u {EMAIL}:{PASSWORD} http://<ms_ip_or_DNS>:8080/v1/organizations/{ORGNAME}
或是:
> curl -u {EMAIL}:{PASSWORD} https://<ms_ip_or_DNS>:TLSPort/v1/organizations/{ORGNAME}
其中 EMAIL 和 PASSWORD 是 ORGNAME 管理員的電子郵件地址與密碼。
請務必指定 Edge 安裝專用的主機名稱和通訊埠編號。通訊埠 8080 是 Edge 使用的預設通訊埠。如果您要在雲端連結至機構,則要求網址為:https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}。
如果成功,這個指令會傳回類似以下的回應:
{ "createdAt" : 1348689232699, "createdBy" : "USERNAME", "displayName" : "cg", "environments" : [ "test", "prod" ], "lastModifiedAt" : 1348689232699, "lastModifiedBy" : "foo@bar.com", "name" : "cg", "properties" : { "property" : [ ] }, "type" : "trial" }
2. 移除 7.0 之前的 PHP 版本
安裝指令碼會在開始安裝之前,檢查系統中是否有 PHP 7.0 之前的版本。如果 PHP 版本 7.0 之前的版本存在,系統會顯示以下警告訊息:
The following packages present on your system conflict with software we are about to install. You will need to manually remove each one, then re-run this install script. php php-cli php-common php-gd php-mbstring php-mysql php-pdo php-pear php-pecl-apc php-process php-xml
使用下列指令移除 PHP 套件:
yum remove <package-name>
3. 安裝 Postgres
您必須安裝 Postgres 入口網站,才能安裝入口網站。您可以在安裝 Edge 時安裝 Postgres,或單獨安裝 Postgres 供入口網站使用。
- 如果您要連線至在 Edge 中安裝的 Postgres,且 Postgres 設為主要/待命模式,請指定 Postgres 伺服器的 IP 位址。
- 如果您是單獨安裝 Postgres,則可與入口網站位於相同的節點。
如要瞭解如何在安裝 Edge 時安裝 Postgres,請參閱「在節點上安裝 Edge 元件」。
如何單獨安裝 Postgres:
- 使用網際網路或非網際網路程序,在節點中安裝 Edge apigee-setup 公用程式。詳情請參閱「安裝 Edge apigee-setup 公用程式」。
- 建立 Postgres 設定檔,如下所示:
# 必須解析為主機的 IP 位址或 DNS 名稱,而非 127.0.0.1 或 localhost。
HOSTIP=$(hostname -i)
# Postgres 的 Pod 和區域。使用下方顯示的預設值。
MP_POD=gateway
REGION=dc-1
# 設定 Postgres 密碼。預設值為「postgres」。
PG_PWD=postgres - 在命令提示字元中,執行設定指令碼以安裝 Postgres:
> /opt/apigee/apigee-setup/bin/setup.sh -p pdb -f configFile
「-p pdb」選項會指定安裝 Postgre。
設定檔必須可供「apigee」使用者存取或讀取。
4. 安裝入口網站
如何安裝入口網站:
- 使用網際網路或非網際網路程序,在節點中安裝 Edge apigee-setup 公用程式。詳情請參閱「安裝 Edge apigee-setup 公用程式」。
- 確認您已安裝獨立式 Postgres,或安裝 Edge 時一併安裝 Postgres。
- 在命令提示字元中執行設定指令碼:
> /opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile
「-p dp」選項會指定安裝入口網站。
設定檔必須可供「apigee」使用者存取或讀取。 - 前往入口網站首頁 http://localhost:8079,或是入口網站的 DNS 名稱。
- 使用您在設定檔中設定的管理員憑證登入入口網站,確保入口網站正常執行。
- 在 Drupal 選單中依序選取「Reports」>「狀態報告」,確保您查看入口網站的目前狀態。
5. 確認已啟用更新管理員模組
如要接收 Drupal 更新通知,請確認已啟用 Drupal Update Manager 模組。在 Drupal 選單中選取「Modules」,然後向下捲動至「Update Manager」模組。如果尚未啟用,請啟用。
啟用後,您可以前往「報表」>「可用的更新」選單項目,查看可用的更新。您也可以使用下列 Drush 指令:
> drush pm-info update
您必須從網站的根目錄執行這個指令。根據預設,開發人員入口網站安裝位置為 /opt/apigee/apigee-drupal/wwwroot。因此,在執行指令前,您應該先將目錄變更為 /opt/apigee/apigee-drupal/wwwroot。如果您並未在預設目錄中安裝入口網站,請切換至安裝目錄。
使用「Reports」(報表) >「Available Updates」(可用更新) >「Settings」(設定) 選單項目來設定模組,讓系統在有可用更新時透過電子郵件通知您,以及設定檢查更新的頻率。
6. 設定 Apache Solr 搜尋引擎 (選用)
根據預設,當您安裝入口網站時,系統會停用連結至 Apache Solr 搜尋引擎的 Drupal 模組。大多數的入口網站使用 Drupal 搜尋引擎,因此不需要 Drupal Solr 模組。
如果您決定使用 Solr 做為搜尋引擎,就必須在伺服器上本機安裝 Solr,然後在入口網站上啟用並設定 Drupal Solr 模組。
如要啟用 Drupal Solr 模組:
- 以具備管理員或內容建立權限的使用者登入入口網站。
- 在「Drupal」選單中選取「Modules」。
- 啟用 Apache Solr Framework 模組和 Apache Solr Search 模組。
- 儲存變更。
- 請按照 https://drupal.org/node/1999280 的說明設定 Solr。
7. 安裝 SmartDocs (選用)
SmartDocs 可讓您在 Developer Services 入口網站上以完全互動的方式提供 API 說明文件,藉此記錄您在 Developer Services 入口網站中的 API。不過,您必須先在 Edge 上安裝 SmartDocs,才能透過入口網站使用 SmartDocs。
- 如要將入口網站連線至 Edge Cloud 安裝項目,代表裝置已安裝 SmartDocs,您不需要再進一步設定。
- 如要將入口網站連結至 Edge for Private Cloud 安裝作業,請務必確認已在 Edge 上安裝 SmartDocs。如要進一步瞭解如何安裝 Edge 和 SmartDocs,請參閱安裝 SmartDocs。
此外,您也必須在入口網站中啟用 SmartDocs。如要進一步瞭解 SmartDocs,請參閱「使用 SmartDocs 記錄 API」。
8. 為非網際網路安裝設定 JQuery Update 模組 (選用)
如果您在非網際網路安裝中安裝並使用 JQuery Update 模組,則必須將模組設定為使用本機版本的 JQuery。如果您將模組設定為使用 CDN 進行非網際網路安裝,它會嘗試存取 CDN,並造成頁面載入延遲。如要進一步瞭解 JQuery Update 模組,請參閱 https://www.drupal.org/project/jquery_update。
如要設定 JQuery Update 模組以使用本機版本的 JQuery:
- 以具備管理員或內容建立權限的使用者登入入口網站。
- 在 Drupal 選單中依序選取「Configuration」>「Development」>「JQuery Update」。
- 按一下左側導覽面板中的「成效」。
- 在 JQuery 和 JQuery UI CDN 下拉式選單中,選取「None」。
- 按一下「儲存設定」。
9. 接下來要我為你做什麼呢?
安裝 Developer Services 入口網站後,您可以依自身需求設定及自訂入口網站。Apigee 網站上的說明文件包含設定、樣式和管理入口網站的所有資訊。如要查看說明文件,請前往 http://apigee.com/docs/developer-services/content/what-developer-portal。
下表列出您在安裝後最常執行的部分常見工作,並提供 Apigee 說明文件的連結,該說明文件可讓您進一步瞭解相關資訊:
工作 | 說明 |
---|---|
主題會定義入口網站的外觀,包括顏色、樣式和其他視覺元素。 |
|
首頁包含主選單、歡迎訊息、頁首、頁尾和標題。 |
|
註冊程序可控管新開發人員在入口網站上註冊帳戶的方式。舉例來說,新的開發人員可以立即存取入口網站,或是需要經過管理員驗證。這項程序也能控管入口網站管理員在建立新帳戶時的通知方式。 |
|
入口網站會針對特定事件傳送電子郵件。例如,有一位新開發人員在入口網站註冊,以及開發人員遺失自己的密碼。 |
|
新增《條款及細則》頁面,開發人員必須先接受這些條款,才能存取入口網站。 |
|
入口網站會實作角色型授權模型。在允許開發人員註冊之前,請先定義入口網站使用的權限和角色。 |
|
入口網站內建對網誌和討論串論壇的支援,定義查看、新增、編輯及刪除網誌和論壇文章所需的權限。 |
|
確保進行資料庫備份 |
請務必備份 Drupal 資料庫。請注意,由於每次安裝項目都不同,因此您可以選擇如何以最佳方式備份資料庫。 注意:「備份與遷移」模組與 Postgres 資料庫不相容。 另請參閱備份入口網站。 |
設定主機名稱 |
如果您沒有在 DNS 伺服器上設定主機名稱,您隨時可以透過伺服器的 IP 位址存取網站。如果您想使用主機名稱,可以為伺服器設定 DNS。基本設定應可正常運作,無須進行任何其他設定。 如果您已設定負載平衡器,或因為其他原因而在網站上收到不正確的網址,可以在下列檔案中設定 /opt/apigee/apigee-drupal-devportal-opdk_version/source/conf/settings.php 如果您升級入口網站,這個值就會遭到覆寫。 |
自訂開發 | 您也可以在主題之外的自訂程式碼,擴充入口網站的功能。方法是按照 Drupal 的模組開發主題所述建立自己的 Drupal 模組,然後將模組放在 /sites/all/modules 目錄中。 |