Edge 安裝作業總覽

Private Cloud v. 4.17.05 專用 Edge

典型的 Edge 安裝作業會包含在多個節點中分散的 Edge 元件。在節點上安裝 Edge 後，系統就會安裝並設定一或多個 Edge 元件 節點。

安裝程序

在節點上安裝 Edge 需要多個步驟：

  • 在節點上停用 SELinux，或設為寬鬆模式。請參閱安裝 Edge apigee-setup 公用程式 內容。
  • 決定是否要啟用 Cassandra 驗證。
  • 決定是否要為 Postgres 設定主待命複製功能。
  • 從建議的拓撲清單中選取您的 Edge 設定。舉例來說， 可以在單一節點中安裝 Edge 以供測試，或是在 13 個節點中安裝用於實際工作環境。詳情請參閱安裝拓撲。
  • 在所選拓撲中的每個節點上，安裝 Edge apigee-setup 公用程式：
    • 下載 Edge bootstrap_4.17.05.sh 檔案， /tmp/bootstrap_4.17.05.sh。
    • 安裝 Edge apigee-service 公用程式並 依附元件
    • 安裝 Edge apigee-setup 公用程式和依附元件。

      請參閱安裝 Edge apigee-setup 公用程式
  • 使用 apigee-setup 公用程式可根據您選取的項目，在每個節點中安裝一或多個 Edge 元件 拓撲
    請參閱在節點上安裝 Edge 元件 節點。
  • 在 Management Server 節點上，使用 apigee-setup 公用程式安裝 Apigee-provision 包括用於建立及管理 Edge 機構的公用程式。
    詳情請參閱為機構加入一文。

可執行安裝的使用者

Apigee Edge 發布檔案會安裝為一組 RPM 和依附元件。如要安裝、解除安裝及更新 Edge RPM，必須由 root 使用者或具備完整 sudo 存取權的使用者執行指令。如需完整的 sudo 存取權，則使用者有權執行 sudo 存取權 與根層級相同的作業

使用者必須是 root 或代表使用者，才能執行下列命令或指令碼 擁有完整 sudo 存取權：

  • apigee-service 公用程式：
    • apigee-service 指令：install、uninstall、update。
    • apigee-all 指令：install、install、update。
  • setup.sh 指令碼安裝 Edge 元件 (除非已使用 「apigee-service install」到 安裝所需的 RPM然後再授予超級使用者或完整的 sudo 存取權 (如果不需要的話)。
  • update.sh 指令碼：更新 Edge 元件

此外，Edge 安裝程式會在您的系統上建立名為「apigee」的新使用者。許多 Edge 指令 叫用 sudo，以以「apigee」的形式執行內容。

除了上述指令外，如果使用者想執行其他指令，必須是擁有「apigee」使用者完整 sudo 存取權的使用者。這些指令包括：

  • apigee-service 公用程式指令，包括：
    • apigee-service 指令，例如 start、停止、重新啟動、設定等。
    • apigee-all 指令，例如start、stop、restart、configure。

建立使用者 kubectl 的完整 sudo 存取權使用者

設定使用者俱備「apigee」的完整 sudo 存取權請使用「visudo」指令 編輯 sudoers 檔案，以新增：

installUser        ALL=(apigee)      NOPASSWD: ALL

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

設定權限

Edge 指令使用的任何檔案或資源都必須能存取「apigee」內容。這包括 Edge 授權檔案和任何設定檔。

建立設定檔時，您可以將檔案擁有者變更為「apigee:apigee」確保 Edge 指令可以存取下列項目：

  1. 以任何使用者身分在編輯器中建立檔案。
  2. 擁有檔案的擁有者為「apigee:apigee」或者，如果您已變更執行 Edge 的使用者帳戶 透過「 Apigee」模式將檔案交給執行 Edge 的使用者 課程中也會快速介紹 Memorystore 這是 Google Cloud 的全代管 Redis 服務

區隔 根使用者和非超級使用者之間的邊緣安裝工作

雖然以 Root 權限或使用者的身分執行整個 Edge 安裝程序最簡單的方式 具備完整的 sudo 存取權，並非永遠可能。您可以將 轉換成 Root 權限所執行的工作，以及由 kubectl 的完整 sudo 存取權內容。

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

      這個步驟會安裝 apigee-service 公用程式，並建立「apigee」使用者。
    2. 設定使用者俱備「apigee」的完整 sudo 存取權使用者，按照說明 。
    3. 安裝 apigee-setup 公用程式：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    4. 使用 apigee-setup 公用程式安裝 節點上的邊緣 RPM：
      > /opt/apigee/apigee-service/bin/apigee-service compName 安裝

      您在節點上安裝的邊緣 RPM 會因拓撲而異。可用的元件清單包括：apigee-provision、apigee-validate、apigee-zookeeper、apigee-cassandra、apigee-openldap、edge-ui、edge-management-server、edge-ui、edge-router、edge-message-processor、apigee-postgresql、apigee-qpidd、edge-postgres-server、edge-qpid-server。
  2. 超級使用者在節點上安裝 Edge RPM 後， kubectl 的完整 sudo 存取權使用者完成設定程序：
    1. 使用 setup.sh 來完成節點上的 Edge 元件設定。這是 視您在節點上安裝的元件而定。如需完整清單，請參閱： 在節點上安裝 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 公用程式，其中包含 Edge 安裝資訊。無聲安裝作業唯一的要求，就是「apigee」使用者必須能存取或讀取設定檔。例如，將檔案放在節點的 /usr/local/var 或 /usr/local/share 目錄中，並將檔案的擁有者變更為「apigee:apigee」。

除了 Edge 系統以外，設定檔中的所有資訊皆為必填 管理員的密碼。如果省略密碼，apigee-setup 公用程式會提示您在指令列中輸入密碼。

請參閱在節點上安裝 Edge 元件： 內容。

處理安裝失敗

如果系統在安裝 Edge 元件期間失敗時，您可以嘗試 然後重新執行安裝程式。安裝程式必須在 或稍後您想變更或更新元件時 安裝。

透過網際網路或非網際網路安裝

如要在節點上安裝 Edge，節點必須能存取 Apigee 存放區：

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

    具備外部網際網路連線的節點可存取 Apigee 存放區來安裝 Edge RPM 和依附元件。
  • 沒有外部網際網路連線的節點

    沒有外部網際網路連線的節點可存取鏡像版本的 Apigee 設定專屬於您的內部存放區這個存放區包含所有邊緣 RPM，但你必須 請確保您可以在內部 更是如此

    如要建立內部 Apigee 存放區，您需要有外部網際網路的節點 有權下載邊緣 RPM 和依附元件。建立容器後 內部存放區，可以將其移至其他節點，或讓該節點可供 Edge 存取 安裝專用的節點

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

使用本機 (或建立鏡像) 的其中一個原因是在節點上安裝 Edge 移除外部網際網路連線，如前一節所述。

不過，使用本機存放區還有另一個好處，即使節點內建外部存放區 網際網路連線。從 Apigee 公開存放區安裝 Edge 時，一律會安裝 最新的邊緣 RPM因此，若您想下載並儲存 則應該為該 Edge 版本建立本機存放區。接著，您可以使用該本機存放區，為任何 Edge 版本執行安裝作業。

舉例來說，您可以先使用本機存放區安裝 Edge 開發環境。接著： 當您準備好遷移至正式環境時，請再次從本機安裝 Edge 從本機存放區安裝，您就能確保開發和正式環境 環境一致

鏡像的存放區非常靈活。舉例來說，您可以透過 最新的 Edge RPM 或有特定版本的 Edge。建立存放區後，您也可以更新存放區，以便從不同 Edge 版本新增 RPM。請參閱安裝 Edge apigee-setup 公用程式 內容。

解決 RPM 安裝依附元件

Apigee Edge 發行版檔案會安裝為一組 RPM 檔案，每個 RPM 檔案都有 自己的安裝依附元件鏈結許多這類相依性是由 Apigee 無法控管的第三方元件定義，且隨時可能會變更。因此，說明文件不會列出每個依附元件的明確版本號碼。

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

常見的 Yum 指令

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

  • 清除所有 Yum 快取：
    sudo yum clean all
  • 如要更新 Edge 元件：
    sudo yum update componentName
    例如：
    sudo yum update apigee-setup
    sudo yum update Edge-management-server

檔案系統結構

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

在這份指南和 Edge Operations Guide 中，根安裝目錄會註明 為：

/opt/apigee

這項安裝作業會使用以下檔案系統結構來部署私人的 Apigee Edge Cloud 上精進自己的技能。

記錄檔

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

Edge UI

/opt/apigee/var/log/edge-ui

ZooKeeper

/opt/apigee/var/log/apigee-zookeeper

OpenLDAP

/opt/apigee/var/log/apigee-openldap

Cassandra

/opt/apigee/var/log/apigee-cassandra

Qpidd

/opt/apigee/var/log/apigee-qpidd

PostgreSQL 資料庫

/opt/apigee/var/log/apigee-postgresql

資料

元件

位置

管理伺服器

/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

OpenLDAP

/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

安裝後工作

安裝完成後，您可以對 Edge 元件執行其他動作。

設定 Edge 元件安裝後

如要在安裝後設定 Edge，請同時使用 .properties 檔案和 Edge 公用程式。適用對象 舉例來說，如要在 Edge UI 上設定 TLS/SSL，請編輯 .properties 檔案，將 必要屬性。變更 .properties 檔案後，請重新啟動受影響的 Edge 元件。

.properties 檔案位於 /opt/apigee/customer/application 目錄。 每個元件在目錄中都有專屬的 .properties 檔案。 例如 router.properties 和 management-server.properties。

如要為元件設定屬性，請編輯對應的 .properties 檔案，然後重新啟動元件：

> /opt/apigee/apigee-service/bin/apigee-service component restart

例如：

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

更新 Edge 時，命名空間中的 .properties 檔案， /opt/apigee/customer/application 已讀取到目錄也就是說，更新會保留您對元件設定的所有屬性。

如要進一步瞭解 Edge 設定，請參閱「如何設定 Edge」。

在 Edge 上叫用指令 元件

Edge 會在 /opt/apigee/apigee-service/bin 安裝管理公用程式， 以便管理 Edge 安裝作業舉例來說，您可以使用 apigee-all 公用程式啟動、停止、重新啟動或判斷節點上所有 Edge 元件的狀態：

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

使用 apigee-service 公用程式 控制與設定個別元件apigee-service 公用程式的格式如下：

/opt/apigee/apigee-service/bin/apigee-service component action

例如，如要重新啟動 Edge Router，請按照下列步驟操作：

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

您可以檢查 /opt/apigee 目錄，判斷節點上安裝的元件清單。該目錄 包含節點中安裝的每個 Edge 元件的子目錄。每個子目錄都是 前置字串為：

  • apigee - 第三方 元件。例如 apigee-cassandra。
  • edge：Apigee 的 Edge 元件。例如 edge-management-server。
  • edge-mint - 營利 元件。例如 edge-mint-management-server。
  • baas - API BaaS 元件。例如 baas-usergrid。

元件的完整動作清單取決於元件本身，但所有元件都支援下列動作：

  • 開始、停止、重新啟動
  • 狀態、版本
  • 備份、還原
  • 安裝、解除安裝