安装 Edge Microgate

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息

Edge Microgate v. 2.3.x

受众群体

如果您需要安装或卸载 Edge Microgate，请参阅本指南。

前提条件

  • 您必须在系统中安装 Node.js 4.5 LTS 或更高版本。请参阅下面的其他 Node.js 说明。
  • Windows 要求安装 OpenSSL 并将其添加到 PATH。
  • 如果您使用 Apigee Edge 私有云通过 Edge Microgate 进行配置，则必须运行 Private Cloud 4.15.07 或更高版本。

安装 Node.js

您必须在系统中安装 Node.js 4.5 或更高版本。您可以通过执行以下命令来进行检查：

node -v

您可以通过多种方式获取或更新 Node.js。例如，您可以使用 HomeBrew、yum 或直接从 Node.js 网站下载：https://nodejs.org/download.

在连接到互联网的情况下安装 Edge Microgate

本部分介绍如何安装 Edge Microgate 并初始化默认配置。

  1. 使用以下命令安装带有 npm 的最新版 Edge Microgate。此命令会安装软件并将 edgemicro 可执行文件放在路径中。如需确定以下命令的安装位置，请参阅 Edge Microgate 的安装位置？。 
    npm install edgemicro -g

    如需安装特定版本的 Edge Microgate，您需要在安装命令中指定版本号。如果您未指定版本号，系统会安装最新版本。例如，如需安装 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 Microgate 文档中，我们使用波浪号 (~) 来引用主目录，这是一种 UNIX 快捷键。在 Windows 系统上，如果正在运行的 shell 不支持波浪号，则需要在引用主目录的命令中替换波浪号的相应环境变量。例如：%USERPROFILE%/.edgemicro。

  5. 按照安装 Edge Microgate 中的步骤操作。

在 Windows 即服务上运行 Edge Microgate

您可以在 Windows 上将 Edge Microgate 作为服务来运行。如需了解详情，请参阅 Apigee 社区中的 Windows 上 Microgate (edgemicro) 运营管理最佳实践。

我可以在没有互联网连接的情况下安装 Edge Microgate 吗？

在无法连接到互联网的网站上，管理员可以在您的内部网络上安装和维护专用 npm 注册表。有关设置私有 npm 注册表的说明不在本指南的讨论范围内；但您可以搜索并找到有用的说明。安装私有 npm 注册表后，您可以按照上述安装说明进行操作。

开始使用

如果您刚开始接触 Edge Microgate，在完成安装后，最好从安装 Edge Microgate 开始。设置和配置指南涵盖了安装、配置、启动和使用 Edge Microgate 实例所需的所有步骤。

Edge Microgate 的安装位置

当您将 npm 与全局选项 (npm install -g edgemicro) 搭配使用时，该软件安装在 [prefix]/lib/node_modules/edgemicro 中。您可以使用以下命令找到 [prefix] 的值：

npm config get prefix

[prefix] 的值是可以配置的。如需了解详情，请参阅 npm-folders。

卸载 Edge Microgate

如果您需要移除 Edge Microgate，请按以下步骤操作：

  1. 删除或归档安装目录 [prefix]/lib/node_modules/edgemicro（其中 [前缀] 是 npm 前缀），如 Edge Microgate 安装位置中所述。
  2. 删除或归档日志文件。默认情况下，edgemicro-*.log 文件位于 /var/tmp/，但此位置可配置。如有疑问，请检查配置文件，如“管理日志文件”中所述。
  3. 删除或归档运行时配置和缓存配置文件： 
    ~/.edgemicro/*.yaml