安装 Edge Microgate

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

Edge Microgate v. 3.1.x

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

最低硬件要求

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

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

前提条件

  • Apigee 支持在 Windows、macOS 和 Linux 上运行活跃 LTS 或维护 LTS 版本。如需了解详情,请参阅 Apigee Edge Microgate 支持的软件
  • Windows 要求安装 OpenSSL 并将其添加到 PATH
  • 如果您使用 Apigee Edge 私有云通过 Edge Microgate 进行配置,则必须运行 Private Cloud 4.18.01 或更高版本。

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

本部分介绍如何安装 Edge Microgate 并初始化默认配置。如果您在没有互联网连接的情况下操作,请参阅我可以在没有互联网连接的情况下安装 Edge Microgate 吗?

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

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

    npm install edgemicro@3.1.0 -g
    
  2. 检查版本号。例如,如果您安装了版本 3.1.0:
    edgemicro --version
    current nodejs version is v12.5.0
    current edgemicro version is 3.1.0
    
  3. 按照设置和配置 Edge Microgate 中的设置和配置步骤进行操作。

升级 Edge Microgate

如需升级之前安装的 Edge Microgate 版本,请参阅在连接到互联网的情况下升级 Edge Microgate

Apigee 建议您在升级生产环境之前,使用新版本测试现有配置。

在 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