安装 Edge Microgate

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

Edge Microgateway v. 3.1.x

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

最低硬件要求

Edge Microgateway 需要以下最低硬件配置：

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

前提条件

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

在有互联网连接的情况下安装 Edge Microgateway

本部分介绍如何安装 Edge Microgateway 并初始化默认 配置。如果您在没有互联网连接的情况下运行，请参阅 我能否在没有互联网连接的情况下安装 Edge Microgateway？。

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

    如需安装特定版本的 Edge Microgateway，您需要在安装命令中指定 版本号 。如果您未指定 版本号，系统将安装最新版本。例如，如需安装 版本 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 Microgateway 中的设置和配置步骤操作。

升级 Edge Microgateway

如需升级之前安装的 Edge Microgateway 版本，请参阅 在有互联网连接的情况下升级 Edge Microgateway。

Apigee 建议您先使用新版本测试现有配置，然后再升级生产环境。

在 Windows 上以服务形式运行 Edge Microgateway

您可以在 Windows 上以服务形式运行 Edge Microgateway。如需了解详情，请参阅 Apigee 社区中关于在 Windows 上对 Microgateway (edgemicro) 进行运营管理的最佳实践。

我能否在没有互联网连接的情况下安装 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

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

卸载 Edge Microgateway

如果您需要移除 Edge Microgateway，请执行以下操作：

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

Kubernetes 支持

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

Docker 支持

您现在可以下载最新版本的 Edge Microgateway 作为 Docker 映像：

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