安装 Edge Microgate

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息

Edge Microgateway v. 3.1.5 及更高版本

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

最低硬件要求

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

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

前提条件

  • Apigee 支持 Windows、macOS 和 Linux 上的有效 LTS 或维护 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.5，请使用以下命令。

    npm install edgemicro@3.1.5 -g
  2. 查看版本号。例如，如果您安装了 3.1.5 版： 
    edgemicro --version
current nodejs version is v12.5.0
current edgemicro version is 3.1.5
  3. 按照设置和配置 Edge Microgateway 中的设置和配置步骤操作。

升级 Edge Microgateway

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

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

在 Windows 上将 Edge Microgateway 作为服务运行

您可以在 Windows 上将 Edge Microgateway 作为服务运行。有关详情，请参阅 Apigee 社区中的 在 Windows 上对微网关 (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

前缀配置默认为 Node 的安装位置。在大多数系统上，此值为 /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