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-setup 和 setup.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」以停用檢查功能。