安装 Edge Microgate

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

Edge Microgate v. 2.5.x

本主题介绍如何安装或卸载 Edge Microgate。

最低硬件要求

Edge Microgate 需要以下最低硬件配置:

  • 在虚拟机 (VM) 上,Edge Microgate 需要至少 1 个核心和至少 256 MB 的 RAM。Edge Microgate 进程本身占用的 RAM 不到 128 MB。
  • 在容器上,可以将 Microgate 与小于 100MB 的映像搭配使用。

前提条件

  • 您必须在系统上安装 Node.js 版本 6.x LTS 或 8.x LTS。您可以通过执行以下命令来检查版本:
    node -v
    v6.9.1  
    
  • Windows 要求安装 OpenSSL 并将其添加到 PATH
  • 如果您使用 Apigee Edge 私有云通过 Edge Microgate 进行配置,则必须运行 Private Cloud 4.18.01 或更高版本。

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

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

  1. 使用 npm 安装最新版本的 Edge Microgate,如下所示。此命令会安装该软件,并将 edgemicro 可执行文件放在您的路径中。
    npm install edgemicro -g
    

    如需安装特定版本的 Edge Microgate,您需要在安装命令中指定版本号。如果您未指定版本号,系统会安装最新版本。例如,如需安装 2.5.7 版,请使用以下命令。

    npm install edgemicro@2.5.7 -g
    
  2. 检查版本号。例如,如果您安装了版本 2.5.7:
    edgemicro --version
    current nodejs version is v6.9.1
    current edgemicro version is 2.5.7
    
  3. 按照设置和配置 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

前缀配置默认为安装节点的位置。在大多数系统上,此位置为 /usr/local。在 Windows 上,该文件为 %AppData%\npm[prefix] 的值可配置。如需详细了解 Node.js 模块的默认安装位置以及如何配置安装位置,请参阅 npm-folders

卸载 Edge Microgate

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

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

Kubernetes 支持

您可以使用 Edge Microgate 为在 Kubernetes 集群中运行的服务提供 Apigee API 管理功能。请参阅将 Edge Microgate 与 Kubernetes 集成概览

Docker 支持

您现在可以将最新的 Edge Microgate 版本作为 Docker 映像下载:

docker pull gcr.io/apigee-microgateway/edgemicro:latest