您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息
Edge Microgate v. 2.4.x
受众群体
如果您需要安装或卸载 Edge Microgate,请参阅本指南。
前提条件
- 您必须在系统中安装 Node.js 4.5 LTS 或更高版本。请参阅下面的其他 Node.js 说明。
- Windows 要求安装 OpenSSL 并将其添加到 PATH。
- 如果您使用 Apigee Edge 私有云通过 Edge Microgate 进行配置,则必须运行 Private Cloud 4.16.01 或更高版本。
安装 Node.js
您必须在系统中安装 Node.js 4.5 或更高版本。您可以通过执行以下命令来进行检查:
node -v
您可以通过多种方式获取或更新 Node.js。例如,您可以使用 HomeBrew、yum 或直接从 Node.js 网站下载:https://nodejs.org/download.
在连接到互联网的情况下安装 Edge Microgate
本部分介绍如何安装 Edge Microgate 并初始化默认配置。
- 使用以下命令,使用
npm
安装最新版本的 Edge Microgate。此命令会安装软件,并将edgemicro
可执行文件放在路径中。另请参阅 Edge Microgate 的安装位置。npm install edgemicro -g
如需安装特定版本的 Edge Microgate,您需要在安装命令中指定版本号。如果您未指定版本号,系统会安装最新版本。例如,如需安装版本 2.3.1,请使用以下命令。
npm install edgemicro@2.3.1 -g
- 检查版本号。例如,如果您安装了版本 2.3.5:
edgemicro --version current nodejs version is v6.1.0 current edgemicro version is 2.3.5
- 运行以下命令,在您的主目录中创建默认配置文件。
edgemicro init
- (可选)名为
default.yaml
的配置文件已放入主目录中名为.edgemicro
的子目录中。立即检查以确保此文件存在:ls ~/.edgemicro default.yaml
注意 :在 Edge Microgate 文档中,我们使用波浪号 (
~
) 来引用主目录,这是一种 UNIX 快捷键。在 Windows 系统上,如果运行不支持波浪号的 shell,则需要在引用主目录的命令中替换波浪号的相应环境变量。例如:%USERPROFILE%/.edgemicro
。 - 按照设置和配置 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,请按以下步骤操作:
- 删除或归档安装目录
[prefix]/lib/node_modules/edgemicro
(其中 [前缀] 是 npm 前缀),如 Edge Microgate 的安装位置中所述。 - 删除或归档日志文件。默认情况下,
edgemicro-*.log
文件位于/var/tmp/
,但此位置可配置。如有疑问,请检查配置文件,如“管理日志文件”中所述。 - 删除或归档运行时配置和缓存配置文件:
~/.edgemicro/*.yaml