安装 Edge Microgate

您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。
info

Edge Microgateway v. 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. (可选)系统会在主目录中名为 .edgemicro 的子目录中放置一个名为 default.yaml 的配置文件。请立即检查以确保此文件 存在:
    ls ~/.edgemicro
    default.yaml

    注意: 在 Edge Microgateway 文档中,我们使用波浪号 (~) 指代主目录,这是一个 UNIX 快捷方式。如果您使用的是 Windows,并且运行的 shell 不支持波浪号,则需要在引用主目录的命令中将波浪号替换为相应的 环境变量。例如:%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 与全局选项 (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