安裝 Edge Microgate

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

Edge Microgateway 3.1.x 版

本主題說明如何安裝或解除安裝 Edge Microgateway。

最低硬體需求

Edge Microgateway 至少需要下列硬體設定：

  • 在虛擬機器 (VM) 上，Edge Microgateway 至少需要 1 個核心和 256 MB 的 RAM。Edge Microgateway 程序本身佔用的 RAM 不到 128 MB。
  • 在容器中，Microgateway 可搭配小於 100 MB 的映像檔使用。

必要條件

  • Apigee 支援 Windows、macOS 和 Linux 上的 Active LTS 或 Maintenance LTS 版本。詳情請參閱「Apigee Edge Microgateway 支援的軟體」。
  • Windows 必須安裝 OpenSSL，並新增至 PATH。
  • 如果您使用 Apigee Edge Private Cloud 設定 Edge Microgateway，必須執行 Private Cloud 4.18.01 以上版本。

連上網際網路時安裝 Edge Microgateway

本節說明如何安裝 Edge Microgateway，以及如何初始化預設設定。如果沒有網際網路連線，請參閱「Can I install Edge Microgateway without an internet connection?」(沒有網際網路連線時是否可以安裝 Edge Microgateway？)。

  1. 使用 npm 安裝最新版 Edge Microgateway，步驟如下。這項指令會安裝軟體，並將 edgemicro 可執行檔放在路徑中。
    npm install edgemicro -g

    如要安裝特定版本的 Edge Microgateway，請在安裝指令中指定版本號碼。如未指定版本號碼，系統會安裝最新版本。舉例來說，如要安裝 3.1.0 版，請使用下列指令。

    npm install edgemicro@3.1.0 -g
  2. 查看版本號碼。舉例來說，如果您安裝了 3.1.0 版： 
    edgemicro --version
current nodejs version is v12.5.0
current edgemicro version is 3.1.0
  3. 請按照「設定及配置 Edge Microgateway」一文中的步驟操作。

升級 Edge Microgateway

如要升級先前安裝的 Edge Microgateway 版本，請參閱「升級 Edge Microgateway (如果連上網際網路)」。

Apigee 建議您先使用新版本測試現有設定，再升級正式環境。

在 Windows 上以服務形式執行 Edge Microgateway

您可以在 Windows 上以服務形式運作 Edge Microgateway。詳情請參閱 Apigee 社群的「 Best practices for operational management of Microgateway (edgemicro) on Windows」。

我可以在沒有網際網路連線的情況下安裝 Edge Microgateway 嗎？

如果網站無法連上網際網路，管理員可以在內部網路安裝及維護私人 npm 登錄檔。本指南不提供設定私人 npm 登錄檔的說明，但您可以搜尋並找到實用說明。安裝私人 npm 登錄檔後，即可按照上述安裝或升級說明操作。

開始使用

如果您剛開始使用 Edge Microgateway，建議您完成安裝後，先參閱「設定及配置 Edge Microgateway」一文。設定和設定指南涵蓋安裝、設定、啟動及使用 Edge Microgateway 執行個體的所有必要步驟。

Edge Microgateway 安裝在哪裡？

使用全域選項 (npm install -g edgemicro) 搭配 npm 時，軟體會安裝在 [prefix]/lib/node_modules/edgemicro 中。您可以使用下列指令找出 [prefix] 的值：

npm config get prefix

前置字串設定預設為節點的安裝位置。在大多數系統中，這項功能是 /usr/local。Windows 的目錄是 %AppData%\npm。[prefix] 的值可設定。如要進一步瞭解 Node.js 模組的預設安裝位置，以及如何設定安裝位置，請參閱 npm 資料夾。

解除安裝 Edge Microgateway

如需移除 Edge Microgateway，請按照下列步驟操作：

  1. 刪除或封存安裝目錄 [prefix]/lib/node_modules/edgemicro，其中 [prefix] 是 npm 前置字串，如「 Edge Microgateway 安裝位置」一文所述。
  2. 刪除或封存記錄檔。根據預設，edgemicro-*.log 檔案位於 /var/tmp/，但這個位置可供設定。如有疑問，請檢查 Edge Microgateway 設定檔。
  3. 刪除或封存執行階段設定和快取設定檔： 
    ~/.edgemicro/*.yaml

Kubernetes 支援

您可以使用 Edge Microgateway，為 Kubernetes 叢集中執行的服務提供 Apigee API 管理功能。請參閱「整合 Edge Microgateway 與 Kubernetes 總覽」。

支援 Docker

您現在可以下載最新版 Edge Microgateway Docker 映像檔：

docker pull gcr.io/apigee-microgateway/edgemicro:latest