Edge 安裝作業總覽

一般 Edge 安裝由多個節點分配的 Edge 元件組成。在節點上安裝 Edge 後,請在節點上安裝一或多個邊緣元件。

安裝程序

在節點上安裝 Edge 的程序有多個步驟:

  1. 停用節點的 SELinux,或將其設為寬鬆模式。詳情請參閱「安裝 Edge Apigee 設定公用程式」。
  2. 決定是否要啟用 Cassandra 驗證。
  3. 決定是否要為 Postgres 設定主要待命複製作業。
  4. 從建議的拓撲清單中選取 Edge 設定。舉例來說,您可以在單一節點上安裝邊緣,並在測試用的單一節點上安裝 13 個節點。詳情請參閱「安裝拓撲」。
  5. 在所選拓撲的每個節點中安裝 Edge apigee-setup 公用程式:
    • 下載 Edge bootstrap_4.51.00.sh 檔案至 /tmp/bootstrap_4.51.00.sh
    • 安裝 Edge apigee-service 公用程式和依附元件。
    • 安裝 Edge apigee-setup 公用程式和依附元件。

      詳情請參閱「安裝 Edge Apigee 設定公用程式」。

  6. 使用 apigee-setup 公用程式,根據所選拓撲在各節點上安裝一或多個 Edge 元件。

    請參閱「在節點上安裝 Edge 元件」。

  7. 在「管理伺服器」節點中,使用 apigee-setup 公用程式來安裝 apigee-provision,即您用於建立及管理 Edge 機構的公用程式。

    詳情請參閱「為機構提供支援」。

  8. 安裝完成後,請在每個節點上重新啟動傳統版 UI 元件,如以下範例所示:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  9. (建議做法) 完成初始安裝作業後,Apigee 會建議您安裝新的 Edge UI (其元件名稱為 edge-management-ui),這是 Apigee Edge for Private Cloud 開發人員和管理員專用的進階使用者介面。

    詳情請參閱安裝新版 Edge UI

安裝完成後,請參閱常見的安裝後動作清單

誰可以執行安裝作業

Apigee Edge 發布檔案是以 RPM 和依附元件的形式安裝。如要安裝、解除安裝及更新 Edge RPM,指令必須由根使用者或具有 sudo 完整存取權的使用者執行。對於完整 sudo 存取權,代表使用者俱備 sudo 存取權,以便執行與根目錄相同的作業,

任何想要執行下列指令或指令碼的使用者都必須具備 Root 權限,或是具備完整 sudo 存取權:

  • Apigee-service 公用程式:
    • apigee-service 指令:install, uninstall, update
    • apigee-all 指令:install, uninstall, update
  • setup.sh 指令碼來安裝 Edge 元件 (除非您已使用「apigee-service install」安裝必要的 RPM)。如果不需要,則取得 Root 權限或完整 sudo 存取權)。
  • update.sh 指令碼來更新 Edge 元件

另外,Edge 安裝程式會在系統中建立新的使用者,並命名為「Apigee」。許多 Edge 指令會叫用 sudo 以「Apigee」使用者的身分執行。

如果使用者想執行上述所有指令以外的其他指令,則必須具備「Apigee」使用者的完整 sudo 存取權。這些指令包括:

  • Apigee-service 公用程式指令,包括:
    • apigee-service 指令,例如 start, stop, restart, configure
    • Apigee-all 指令,例如 start, stop, restart, configure

建立具備「sudo」使用者的完整 sudo 使用者權限

如要將使用者設為「Apigee」使用者的完整 sudo 存取權,請使用「visudo」指令編輯 sudoers 檔案,以便新增下列項目:

installUser        ALL=(apigee)      NOPASSWD: ALL

其中 installUser 是 Edge 使用者的使用者名稱。

配置設定檔的權限

所有「Apigee」使用者都能存取 Edge 指令使用的任何檔案或資源。其中包括 Edge 授權檔案和任何設定檔。

建立設定檔時,您可以將檔案擁有者變更為「apigee:apigee」,以確保檔案可供 Edge 指令存取:

  1. 在編輯器中建立任何使用者的檔案。
  2. chown 將檔案的擁有者變更為「apigee:apigee」,或者您已將使用者從「Apigee」使用者變更為執行 Edge 服務,並將該檔案升級為執行 Edge 服務的使用者。

區隔 Edge 和非根使用者之間的安裝工作

儘管以根層級或具有完整 sudo 存取權的使用者執行整個 Edge 安裝程序最簡單的方法,但不一定都是如此。相反地,您可以將程序分離為根層級執行的工作,以及具有「Apigee」使用者完整 sudo 使用者執行的工作。

  1. 由根執行的工作:
    1. 下載並執行 bootstrap_4.51.00.sh 檔案:
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
      sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

      這個步驟會安裝 apigee-service 公用程式,並建立「Apigee」使用者。

    2. 設定使用者,具備「Apigee」使用者的完整 sudo 存取權,詳情請參閱建立具備「sudo」使用者的完整使用者存取權
    3. 安裝 apigee-setup 公用程式:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    4. 使用 apigee-setup 公用程式在節點上安裝 Edge RPM:
      /opt/apigee/apigee-service/bin/apigee-service compName install

      您在節點上安裝的 Edge RPM 必須視拓撲而定。可用元件清單包括:apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server

  2. 根使用者會在節點上安裝 Edge RPM 後,具備「Apigee」使用者完整 sudo 存取權的使用者完成設定程序:
    1. 使用 setup.sh 公用程式完成節點中的邊緣元件設定。指令的格式取決於您在節點上安裝的元件。如需完整清單,請參閱「在節點上安裝 Edge 元件」。

      例如,如要完成 ZooKeeper 和 Cassandra 的安裝,請使用下列指令:

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      其中 configFile 是 Edge 設定檔。

      或者,如要執行全方位安裝程序,請使用下列指令:

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

安裝設定檔的位置

您必須將設定檔傳送給 apigee-setup 公用程式,其中包含邊緣安裝相關資訊。靜音安裝的唯一條件是,設定檔必須可供「Apigee」使用者存取或讀取。例如,將檔案放在節點的 /usr/local/var/usr/local/share 目錄中,並將 chown 放入「apigee:apigee」。

除了 Edge 系統管理員的密碼以外,設定檔中的所有資訊都是必要資訊。如果您略過密碼,apigee-setup 公用程式會要求您在指令列中輸入密碼。

詳情請參閱「在節點上安裝 Edge 元件」。

處理安裝失敗問題

如果在安裝 Edge 元件時發生錯誤,可以嘗試修正問題,然後再次執行安裝程式。安裝程式會在發生偵測失敗時重複執行,或是日後想在安裝後變更或更新元件。

安裝或升級之後,請務必為每個執行節點的邊緣重新啟動 Edge UI 元件。

網際網路或非網際網路安裝

如要在節點上安裝 Edge,節點必須能夠存取 Apigee 存放區:

  • 具備外部網際網路連線的節點

    具備外部網際網路連線的節點可以存取 Apigee 存放區,藉此安裝 Edge RPM 和依附元件。

  • 沒有外部網際網路連線的節點

    沒有外部網際網路連線的節點可以存取您內部設定的 Apigee 存放區鏡像版本。這個存放區包含所有邊緣每千次觀看收益,但您必須確保具有內部網路存放區的所有額外依附元件。

    如要建立內部 Apigee 存放區,您必須具備具備外部網際網路存取權的節點,才能下載邊緣千次曝光收益和依附元件。建立內部存放區後,即可將其移至其他節點,或讓該節點存取 Edge 節點進行安裝。

使用本機 Edge 存放區來維護 Edge 版本

使用本機或鏡像的存放區中,其中一項原因是在沒有外部網際網路連線的節點上安裝 Edge,如上一節所述。

解決 RPM 安裝依附元件

Apigee Edge 發布檔案以一組 RPM 檔案的形式安裝,每個檔案都有專屬的安裝依附元件鏈結。其中許多依附元件是由第三方元件定義,而這些元件不在 Apigee 控制範圍內,而且隨時可能變更。因此,說明文件不會列出每個依附元件的明確版本號碼。

如要在搭載網際網路的機器中執行安裝,節點可以下載必要的 RPM 和依附元件。不過,如果是從沒有網際網路的節點進行安裝,您通常會設定包含所有必要依附元件的內部存放區。如要確保本機存放區包含所有依附元件,唯一方法就是嘗試安裝、找出任何缺少的依附元件,並將依附元件複製到本機存放區,直到安裝成功為止。

常見的 Yum 指令

Linux 專用的 Edge 安裝工具需要透過 Yum 安裝及更新元件。您可能需要使用多個 Yum 指令來管理節點中的安裝作業。

  • 清除所有 Yum 快取:
    sudo yum clean all
  • 如要更新邊緣元件:
    sudo yum update componentName

    例如:

    sudo yum update apigee-setup
    sudo yum update edge-management-server

檔案系統結構

Edge 會安裝 /opt/apigee 目錄中的所有檔案。

在本指南和邊緣作業指南中,根安裝目錄的的記錄如下:

/opt/apigee

這項安裝作業會使用下列檔案系統結構來部署私有雲的 Apigee Edge。

記錄檔

apigee-setupsetup.sh 指令碼的記錄檔會寫入 /tmp/setup-root.log

每個元件的記錄檔都包含在 /opt/apigee/var/log 目錄中。每個元件都有專屬的子目錄。舉例來說,管理伺服器的記錄位於目錄中:

/opt/apigee/var/log/edge-management-server

下表列出記錄檔的位置:

元件 位置

管理伺服器

/opt/apigee/var/log/edge-management-server

路由器

/opt/apigee/var/log/edge-router

邊緣節點是透過 NGINX 實作。如需其他記錄,請參閱:

/opt/apigee/var/log/edge-router/nginx
/opt/nginx/logs

訊息處理器

/opt/apigee/var/log/edge-message-processor

Apigee Qpid 伺服器

/opt/apigee/var/log/edge-qpid-server
Apigee Postgres 伺服器 /opt/apigee/var/log/edge-postgres-server
傳統版 UI (而非新的 Edge UI,元件名稱為 edge-management-ui) /opt/apigee/var/log/edge-ui
ZooKeeper /opt/apigee/var/log/apigee-zookeeper
開啟 LDAP /opt/apigee/var/log/apigee-openldap
Cassandra /opt/apigee/var/log/apigee-cassandra/system.log
Qpidd 音樂 /opt/apigee/var/log/apigee-qpidd
PostgreSQL 資料庫 /opt/apigee/var/log/apigee-postgresql
apigee-monit /opt/apigee/var/log/apigee-monit

資料

元件 位置
管理伺服器 /opt/apigee/data/edge-management-server
路由器 /opt/apigee/data/edge-router
訊息處理器 /opt/apigee/data/edge-message-processor
Apigee Qpid 代理程式 /opt/apigee/data/edge-qpid-server
Apigee Postgres 代理程式 /opt/apigee/data/edge-postgres-server
ZooKeeper /opt/apigee/data/apigee-zookeeper
開啟 LDAP /opt/apigee/data/apigee-openldap
Cassandra /opt/apigee/data/apigee-cassandra/data
Qpidd 音樂 /opt/apigee/data/apigee-qpid/data
PostgreSQL 資料庫 /opt/apigee/data/apigee-postgres/pgdata
apigee-monit /opt/apigee/data/apigee-monit

在安裝時啟用系統檢查

Edge 安裝設定檔支援下列屬性:

ENABLE_SYSTEM_CHECK=y

如果將這項屬性設為「y」,安裝程式會檢查系統是否符合所安裝元件的 CPU 和記憶體需求。預設值為「n」以停用檢查功能。