安裝 Edge Microgate

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件
資訊

Edge Microgateway 2.5.x 版

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

最低硬體需求

Edge Microgateway 具備下列最低硬體設定需求:

  • 在虛擬機器 (VM) 上,Edge Microgateway 需要至少 1 個核心,並至少需要 256 MB 的 RAM。Edge Microgateway 程序本身只需不到 128 MB 的 RAM。
  • 在容器中,Microgateway 可用於小於 100 MB 的圖片大小。

必要條件

  • 您的系統必須安裝 Node.js 版本 6.x LTS 或 8.x LTS。如要查看版本,請執行下列指令:
    node -v
    v6.9.1  
    
  • Windows 規定必須安裝 OpenSSL,並新增至 PATH
  • 如果您使用 Apigee Edge Private Cloud 來設定 Edge Microgateway,您必須執行 Private Cloud 版本 4.18.01 以上版本。

如果您有網際網路連線,請安裝 Edge Microgateway

本節說明如何安裝 Edge Microgateway 及初始化預設設定。

  1. 使用 npm 安裝最新版本的 Edge Microgateway,如下所示。這個指令會安裝軟體,並將 edgemicro 執行檔存放在路徑中
    npm install edgemicro -g
    

    如要安裝特定版本的 Edge Microgateway,您必須在安裝指令中指定「版本號碼」如果未指定版本號碼,系統會安裝最新版本。舉例來說,如要安裝 2.5.7 版,請使用下列指令。

    npm install edgemicro@2.5.7 -g
    
  2. 查看版本號碼。舉例來說,如果已安裝 2.5.7 版:
    edgemicro --version
    current nodejs version is v6.9.1
    current edgemicro version is 2.5.7
    
  3. 按照「設定及設定 Edge Microgateway」中的設定和設定步驟操作。

在 Windows 中以服務的形式使用作業系統微閘道

您可以在 Windows 中以服務的形式操作 Edge Microgateway。詳情請參閱 Apigee 社群中的 在 Windows 上執行 Microgateway (edgemicro) 作業管理的最佳做法

沒有網路連線時,我可以安裝 Edge Microgateway 嗎?

在無法連上網際網路的網站上,管理員可以在內部網路安裝及維護私人 npm 登錄檔。設定私人 npm 登錄檔的操作說明不在本指南的涵蓋範圍內,不過您還是可以搜尋及查看實用的操作說明。安裝私人 npm 登錄檔後,即可按照上述操作說明安裝。

開始使用

如果您是 Edge Microgateway 的新手,設定及設定 Edge Microgateway 是安裝完成後的最佳起點。設定與設定指南涵蓋安裝、設定、啟動及使用 Edge Microgateway 執行個體的所有步驟。

Edge Microgateway 的安裝位置為何?

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

npm config get prefix

前置字串設定會預設為節點的安裝位置。在大多數系統中,這個值為 /usr/local。Windows 上的版本為 %AppData%\npm[prefix] 的值可進行設定。如要進一步瞭解預設 Node.js 模組安裝的位置,以及如何設定安裝位置,請參閱 npm-folders

正在解除安裝 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