安裝 Edge Microgate

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

Edge Microgateway 2.3.x 版

適用對象

如需安裝或解除安裝 Edge Microgateway，請按照本指南的說明操作。

必要條件

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

安裝 Node.js

您的系統必須安裝 Node.js 4.5 以上版本。您可以執行以下指令進行確認：

node -v

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

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

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

  1. 使用以下指令，透過 npm 安裝 最新 的 Edge Microgateway 版本。這個指令會安裝軟體，並將 edgemicro 執行檔存放在路徑中。如要瞭解下列指令會安裝 Edge Microgateway 的位置，請參閱 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 中以服務的形式使用作業系統微閘道

您可以在 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

[prefix] 的值可進行設定。詳情請參閱 npm-folders。

正在解除安裝 Edge Microgateway

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

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