安裝 Edge Microgate

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

Edge Microgateway 2.4.x 版

目標對象

如需安裝或解除安裝 Edge Microgateway，請參閱本指南。

必要條件

  • 系統必須安裝 Node.js 4.5 LTS 以上版本。請參閱下方的 Node.js 額外操作說明。
  • Windows 必須安裝 OpenSSL，並新增至 PATH。
  • 如果您使用 Apigee Edge Private Cloud 設定 Edge Microgateway，必須執行 Private Cloud 4.16.01 以上版本。

安裝 Node.js

系統必須安裝 4.5 以上版本的 Node.js。您可以執行下列指令來檢查：

node -v

取得或更新 Node.js 的方法有很多種，舉例來說，您可以使用 HomeBrew、yum，或直接從 Node.js 網站下載：https://nodejs.org/download.

連上網際網路時安裝 Edge Microgateway

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

  1. 使用下列指令，透過 npm 安裝 最新版 Edge Microgateway。這項指令會安裝軟體，並將 edgemicro 可執行檔放在路徑中。另請參閱「Edge Microgateway 安裝位置」。
    npm install edgemicro -g

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

    npm install edgemicro@2.3.1 -g
  2. 查看版本號碼。舉例來說，如果您安裝的是 2.3.5 版： 
    edgemicro --version
current nodejs version is v6.1.0
current edgemicro version is 2.3.5
  3. 執行這項指令，在主目錄中建立預設設定檔。 
    edgemicro init
  4. (選用) 名為 default.yaml 的設定檔已放在主目錄中名為 .edgemicro 的子目錄。請立即檢查，確認這個檔案存在：
    ls ~/.edgemicro
default.yaml

    附註： 在 Edge Microgateway 文件中，我們以波浪號 (~) 代表主目錄，這是 UNIX 捷徑。如果您使用 Windows，且執行的殼層不支援波浪符號，則必須在參照主目錄的指令中，以適當的環境變數取代波浪符號。例如：%USERPROFILE%/.edgemicro。

  5. 按照「設定及配置 Edge Microgateway」一文中的步驟操作。

在 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

[prefix] 的值可設定。詳情請參閱 npm 資料夾。

解除安裝 Edge Microgateway

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

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