Edge Microgate 版本说明

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

版本 3.3.x

问题修复和增强功能 v.3.3.x

3.3.2

2023 年 8 月 18 日，我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.3.2 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

安全问题已解决

无。

3.3.1

2022 年 6 月 7 日，我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.3.1 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

安全问题已解决

3.3.0

2022 年 2 月 4 日，我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.3.0 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

npm install apigeetool@0.15.1

版本 3.2.x

问题修复和增强功能 v.3.2.x

3.2.3

2021 年 9 月 17 日，我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.2.3 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

安全问题已解决

3.2.2

2021 年 7 月 15 日（星期四），我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.2.2 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

安全问题已解决

3.2.1

2021 年 3 月 5 日（星期五），我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.2.1 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

edgemicro:
 enable_GET_req_body: true

3.2.0

2021 年 1 月 21 日（星期四），我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.2.0 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

版本 3.1.x

问题修复和增强功能 v.3.1.x

3.1.8

2020 年 11 月 16 日（星期一），我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.1.8 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

3.1.7

2020 年 9 月 24 日（星期四），我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.1.7 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

{"message":"write after end","code":"ERR_STREAM_WRITE_AFTER_END"}

3.1.6

2020 年 8 月 20 日，星期四，我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.1.6 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

3.1.5

2020 年 6 月 26 日（星期五），我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.1.5 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

3.1.4

2020 年 4 月 23 日（星期五），我们发布了针对 Edge Microgate 的以下修复。

bug 修复：

修复了版本 3.1.3 中的依赖项问题。版本 3.1.3 在 npm 代码库中已标记为已弃用。此外，版本 3.1.3 的版本说明中所述的所有 bug 修复和增强功能都适用于此版本。

3.1.3

2020 年 4 月 15 日（星期三），我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.1.3 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

• 153509313 - 修复了 Node.js 调试模块会导致内存泄漏的问题。此问题在版本 v3.1.0、v3.1.1 和 3.1.2 中存在。
• 153509313 - 修正了以下问题：在日志记录输出中，两个不同事务的同一消息 ID 会输出。
• 151673570 - 修复了 Edge Microgate 未更新为使用新的 Apigee KVM API 的问题。Edge Microgate 现在会使用新命令来添加和更新 KVM 值。
• 152822846 - 在先前的版本中，Edge Microgate 已更新，现在的资源路径映射处理方式与 Apigee Edge 的处理方式一致。在此版本中，修复了未正确处理 /literal_string/* 模式的问题。例如/*/2/*。另请参阅 配置“/”“/*”和“/**”的资源路径的行为。
• 152005003 - 进行了更改，以便为配额启用组织和环境范围的标识符。
• 152005003 - 进行了更改，以便为配额启用组织和环境范围的标识符。“org + env + appName + productName”的组合用作配额标识符。

3.1.2

2020 年 3 月 16 日（星期一），我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.1.3 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

• 151285018 - 进行了功能增强，针对 Edge Microgate 和后端目标之间的流量添加了 HTTP 代理支持。此外，还修复了 Edge Microgate 和 Apigee Edge 之间现有 HTTP 代理支持的问题。如需了解详情，请参阅：
  • 使用 HTTP 代理与 Apigee Edge 通信
  • 使用 HTTP 代理进行目标通信
• 149101890 - 目标服务器或负载平衡器关闭其连接的情况的日志通知代码从 ERROR 更改为 INFO。
• 150746985 - 修复了以下问题：当配置文件中存在 redisBasedConfigCache: true 或 quotaUri: https://%s-%s.apigee.net/edgemicro-auth 时，edgemicro verify 命令会无法正常运行。
• 151284716 - 进行了一项增强功能，可以在重新加载期间重新启动工作器时更快地关闭服务器连接。
• 151588764 - 将用于在 Docker 容器中运行 Edge Microgate 的 Docker 映像中的 Node.js 版本更新为 12，因为 Node.js v8 已废弃。
• 151306049 - 进行了文档更新，以列出 Edge Microgate CLI 命令使用的 Apigee Edge 管理 API。请参阅 Edge Microgate 使用哪些管理 API？。

3.1.1

在 2 月 20 日（星期四），我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.1.1 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

• 146069701 - 修复了 microgateway-core 模块不遵循 HTTP_PROXY 和 HTTPS_PROXY 环境变量的问题。进行此更改后，现在系统会忽略 YAML 配置文件中的代理设置（如果已指定）；仅使用环境变量来指定代理。

  如果要在配置文件中指定代理配置，您还必须指定 HTTP_PROXY 变量，该变量会提及与配置文件中指定的网址相同的代理网址。例如，如果您指定以下配置：

  edge_config:
    proxy: http://10.128.0.20:3128
    proxy_tunnel: true
  

  您还必须指定以下环境变量：

  HTTP_PROXY=http://10.128.0.20:3128

• 146320620 - 添加了新的配置参数 edgemicro.headers_timeout。此属性会限制 HTTP 解析器等待接收完整 HTTP 标头的时间（以毫秒为单位）。例如：

  edgemicro:
  keep_alive_timeout: 6000
  headers_timeout: 12000

  在内部，该参数会在请求中设置 Node.js Server.headersTimeout 属性。（默认值：比使用 edgemicro.keep_alive_timeout 设置的时间多 5 秒。此默认设置可防止负载平衡器或代理错误地丢弃连接。）

• 149278885 - 新增了一项功能，允许您在 API 代理级别设置目标 API 超时，而不是使用一种全局超时设置。

  如果您在 API 代理中设置了 TargetEndpoint 属性 io.timeout.millis，Edge Microgate 将能够检索该属性，并应用目标端点特有的超时设置。如果未应用此参数，Edge Microgate 将使用由 edgemicro.request_timeout 指定的全局超时时间。

3.1.0

在 1 月 21 日（星期二），我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.1.0 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

• 144187500 - 当 quotas.failOpen 标志触发时，系统会记录一个新的警告级别事件。如果发生配额处理错误或向 Edge 发出的“配额应用”请求无法更新远程配额计数器，则会触发此标志。在这种情况下，将仅根据本地计数处理配额，直到下次成功同步远程配额。以前，只有在日志级别设置为 DEBUG 时，系统才会记录此事件。

  例如：

  2020-01-20T02:52:53.040Z [warn][localhost:8000][5][foo-eval][test][hello/][]
  [DbpGIq9jKfzPX8jvXEivhA0LPwE][f372cc30-3b2f-11ea-845f-a627f][quota][remote quota not
  available so processing locally, setting quota-failed-open for identifier: AppQuota60.Quota60]
  [GET][][][][]

• 145023519 - 修复了以下问题：每当 Edge Microgate 检测到 API 代理发生更改时，传输中的交易或新交易都会受到影响。现在，当更改代理时，Edge Microgate 会刷新缓存，而工作器节点会重启。进行此更改后，发送到微网关的传输中的事务和新 API 调用不会受到影响。
• 146378327 - sourceRequest、targetRequest 和 targetResponse 的日志级别已更改为 INFO 级别。
• 146019878 - 针对 Edge Analytics 和 Edge Microgate sourceResponse/targetResponse 日志事件中的“API 代理性能”计算的延迟时间之间的差异已得到修复。现在，边缘分析和 Microgate 日志事件中的延迟时间一致。
• 与模式匹配逻辑相关的变更：
  • 147027862 - OAuth 插件已更新，支持 API 产品中指定的以下资源路径匹配模式：
    • /{literal}**
    • /{literal}*
    • 上述两种模式的任意组合

    进行此更改后，Edge Microgate 插件现在遵循与 Apigee Edge 相同的模式匹配方式，如配置“/”“/*”和“/**”的资源路径的行为中所述。

  • 145644205 - 更新了 apiKeys 插件的模式匹配逻辑，以匹配 OAuth 插件。
• 143488312 - 修复了以下问题：客户端 ID 参数的开头或结尾空格导致 OAuth 令牌和 API 密钥请求的 JWT 产品列表创建为空。
• 145640807 和 147579179 - 新增了一项功能，允许一个名为“同步器”的特殊 Edge Microgate 实例从 Apigee Edge 检索配置数据，并将其写入本地 Redis 数据库。然后，您可以将其他微网关实例配置为从数据库中读取其配置数据。此功能为 Edge Microgate 提供了更高的弹性水平。它允许微网关实例启动并正常运行，而无需与 Apigee Edge 通信。如需了解详情，请参阅使用同步器。

  Syncrhonizer 功能目前支持与 Redis 5.0.x 配合使用。

版本 3.0.x

问题修复和增强功能 v.3.0.x

3.0.10

11 月 8 日（星期五），我们发布了 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.0.10 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

• 142677575 - 进行了功能更新，以便 Edge Microgate 的 API 产品中使用的资源路径的模式匹配现在与 Apigee Edge 使用的资源路径模式匹配保持一致，如 配置“/”“/*”和“/**”的资源路径的行为中所述。

  注意：如果您使用 /*/2/** 等复合资源模式，则必须确保将 edgemicro_auth 代理添加到独立的 API 产品中。然后，您必须将该产品添加到代理的开发者应用中，如以下屏幕截图所示：

  

  注意：Edge Microgate 不支持 features.isSingleForwardSlashBlockingEnabled 配置属性，如 配置“/”“/*”和“/**”的资源路径的行为中所述。

• 143740696 - quotas 配置结构已更改（另请参阅版本 3.0.9 的版本说明）。quotas 属性用于配置配额插件。对结构进行更改是为了提高配置元素的清晰度。 如需配置配额插件，请使用以下 YAML 配置。请注意，此配置属性称为 quotas。 如需详细了解各个 quotas 配置属性，请参阅 配额的配置选项。

  edgemicro:
    home: ../gateway
    port: 8000
    max_connections: -1
    max_connections_hard: -1
    logging:
      level: info
      dir: /var/tmp
      stats_log_interval: 60
    plugins:
      dir: ../plugins
      sequence:
        - oauth
        - quota
  quotas:
    bufferSize:
      hour: 20000
      minute: 500
      default: 10000
    useDebugMpId: true
    failOpen: true
  ...

• 141750056 - 新增了一项功能，允许您将 Redis 用作配额后备存储空间。如果 useRedis 为 true，则使用 volos-quota-redis 模块。 如果为 true，则配额仅限于连接到 Redis 的 Edge Microgate 实例。如果为 false，则 volos-quota-apigee 模块将用作后备存储空间，并且配额计数器为全局值。如需了解详情，请参阅 配额的配置选项。例如：

  edgemicro:
  ...
  quotas:
    useRedis: true
    redisHost: localhost
    redisPort: 6379
    redisDb: 1

• 140574210 - edgemicro-auth 代理生成的令牌的默认到期时间已从 108000 毫秒（1.8 分钟）更改为 1800 秒（30 分钟）。
• 143551282 - 为了支持已启用 SAML 的组织，更新了 edgemicro genkeys 命令以包含 ‑‑token 参数。此参数可让您使用 OAuth 令牌（而不是用户名/密码）进行身份验证。如需了解详情，请参阅 生成密钥。

3.0.9

10 月 11 日（星期五），我们发布了 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.0.9 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

• 141989374 - 为配额插件新增了“应急开启”功能。 启用此功能后，如果发生配额处理错误或向 Edge 的“配额应用”请求无法更新远程配额计数器，系统将仅根据本地计数处理配额，直到下次成功同步远程配额为止。在这两种情况下，请求对象中都会设置 quota-failed-open 标志。

  如需启用配额“应急开启”功能，请设置以下配置：

  quotas :
   failOpen : true

  注意：此外，OAuth 插件的 fail-open 请求对象标志的名称已更改为 oauth-failed-open。

• 142093764 - 对 edgemicro-auth 代理进行了配置更改，以防止发生配额超限。此更改是将配额类型设置为 calendar。如需使用此改进功能，您必须将 edgemicro-auth 更新到 3.0.7 或更高版本。
• 142520568 - 新增了一项功能，用于在配额响应中记录 MP（消息处理器）ID。如需使用此功能，您必须将 edgemicro-auth 代理更新到 3.0.7 或更高版本，并设置以下配置：

  quotas:
    useDebugMpId: true

  设置 useDebugMpId 后，Edge 的配额响应将包含 MP ID 并由 Edge Microgate 记录。例如：

  {
      "allowed": 20,
      "used": 3,
      "exceeded": 0,
      "available": 17,
      "expiryTime": 1570748640000,
      "timestamp": 1570748580323,
      "debugMpId": "6a12dd72-5c8a-4d39-b51d-2c64f953de6a"
  }

3.0.8

9 月 26 日（星期四），我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.0.8 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

• 140025210 - 新增了“应急开启”功能。如果由于连接错误（阻止对 edgemicro-auth 代理成功调用 API 密钥验证）而无法刷新过期的 JWT 令牌，此功能允许 API 处理继续。

  利用该功能，您可以设置一个宽限期，在此期限内旧令牌将保留在缓存中并可在宽限期到期之前重复使用。借助此功能，Edge Microgate 可以在出现临时连接故障时继续处理请求。当连接恢复且“Verify API 密钥”调用成功时，系统将提取新的 JWT 并替换缓存中的旧 JWT。

  如需配置新的“应急开启”功能，请执行以下操作：

  1. 在 Edge Microgate 配置文件的 oauth 节中设置以下属性：

     oauth:
       failOpen: true
       failopenGraceInterval: time_in_seconds
       cacheKey: true
       ...

     例如：

     oauth:
       failOpen: true
       failopenGraceInterval: 5
       cacheKey: true
       ...

     在此示例中，如果旧令牌因连接问题而无法刷新，则将使用 5 秒钟。 5 秒钟后，系统将返回身份验证错误。

• 141168968 - 进行了更新，以便在所有插件日志输出中包含 correlation_id。 此外，一些日志的日志级别已根据需要更改为 error。
• 140193349 - 对 edgemicro-auth 代理进行了更新，要求在每次“验证 API 密钥”请求时验证 Edge Microgate 密钥和密钥。Edge Microgate 已更新为始终在每个“验证 API 密钥”请求中发送密钥和密钥。此更改可防止客户端仅使用 API 密钥获取 JWT。
• 140090250 - 添加了有关配额处理的诊断记录功能的更新。进行此更改后，您现在可以将日志输出与 Edge Microgate 日志的其余部分相关联。

3.0.7

9 月 12 日（星期四），我们发布了针对 Edge Microgate 的以下修复和增强功能。

组件版本：

下表列出了与 Edge Microgate 3.0.7 关联的各个组件项目的版本号。请注意，由于每个组件都是一个单独的项目，因此版本号可能与主产品版本不一致：

bug 修复和增强功能：

• 140075602 - 对 OAuth 插件进行了更新，以在适当的情况下返回 5xx 状态代码。以前，插件在所有非 200 情况下仅返回 4xx 状态代码。现在，对于不是 200 状态的任何消息响应，系统将返回确切的 4xx 或 5xx 代码，具体取决于错误。

  此功能默认处于停用状态。如需启用此功能，请将 oauth.useUpstreamResponse: true 属性添加到您的 Edge Microgate 配置。例如：

  oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    gracePeriod: 10
    useUpstreamResponse: true

• 140090623 - 在版本 3.0.6 中，新增了一个配置属性 quota.quotaUri。 如果您希望通过部署到贵组织的 edgemicro-auth 代理来管理配额，请设置此配置属性。如果未设置此属性，则配额端点默认为内部 Edge Microgate 端点。例如：

  edge_config:
    quotaUri: https://%s-%s.apigee.net/edgemicro-auth

  在版本 3.0.7 中，edgemicro-auth 已更新为接受此新配置。如需使用 quotaUri 属性，您必须升级到最新的 edgemicro-auth 代理。如需了解详情，请参阅 升级 edgemicro-auth 代理。

• 140470888 - 向配额调用添加了 Authorization 标头，以提供身份验证。此外，还修改了 edgemicro-auth 代理，以从配额标识符中移除“organization”。由于配额端点位于客户组织中，因此不再需要配额标识符。
• 140823165 - 以下属性名称：

  edgemicro:
      keepAliveTimeout

  已在版本 3.0.6 中记录错误。正确的属性名称应为：

  edgemicro:
      keep_alive_timeout

• 139526406 - 修复了以下 bug：如果开发者应用有多个产品，就会出现配额计数错误。现在，对于包含多个商品的应用中的每个商品，系统现在都会正确强制执行配额。“appName + productName”的组合用作配额标识符。

3.0.6

在 8 月 29 日（星期四），我们发布了针对 Edge Microgate 的以下修复和增强功能。

• 138633700 - 添加了新的配置属性 keepAliveTimeout。通过此属性，您可以设置 Edge Microgate 超时（以毫秒为单位）。（默认值：5000 毫秒）

  例如：

  edgemicro:
    keep_alive_timeout: 600

• 140090623 - 添加了新的配置属性 quotaUri。如果您希望通过部署到贵组织的 edgemicro-auth 代理来管理配额，请设置此配置属性。如果未设置此属性，则配额端点默认为内部 Edge Microgate 端点。例如：

  edge_config:
    quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
  

  如需使用此功能，您必须先将最新版本的 edgemicro-auth 代理部署到您的组织。如需了解详情，请参阅 升级 Edgemicro-auth 代理。

• 138722809 - 添加了新的配置属性 stack_trace。通过此属性，您可以控制是否在日志文件中显示堆栈轨迹。例如：

  stack_trace: false

  如果 stack_trace 设置为 true，堆栈轨迹将在日志中输出。如果设置为 false，则系统不会在日志中输出堆栈轨迹。

3.0.5

在 8 月 15 日（星期四），我们发布了针对 Edge Microgate 的以下修复和增强功能。

• 139005279 - 修复了 edgemicro status 命令无法返回正确数量的工作器进程的问题。
• 138437710 - 修复了 ExitCounter 类中的一个问题，该问题会导致无法写入正确的日志。

• 139064652 - 添加了为事件日志和系统日志添加 trace 和 debug 日志记录级别的功能。目前，我们仅添加了添加这些日志级别的功能。目前，可用的日志级别为 info、warn 和 error。
• 139064616 - 所有控制台日志语句的日志输出都已标准化。控制台日志记录语句现在包含以下属性：
• 时间戳
• 组件名称
• 进程 ID
• 控制台日志消息

• 138413755 - 改进了以下 CLI 命令的 JWT 密钥和密文相关日志消息：cert、verify、upgradekvm、token、genkeys、revokekeys、rotatekey 和 configure。

• 138413577 - 添加并改进后端服务超时的错误处理方式。
• 138413303 - 添加并改进响应和套接字超时的错误处理。
• 138414116 - 添加了并改进“连接被拒绝”错误的错误处理方式。

3.0.4

在 8 月 1 日（星期四），我们发布了针对 Edge Microgate 的以下修复和增强功能。

• 134445926 - 改进了内部 Edge Microgate 身份验证。
• 137582169 - 解决了启动不需要的进程的问题。额外的进程会导致插件重新加载并使用过多的内存。 Edge Microgate 现在将进程数量保持在预期限制范围内。
• 137768774 - 日志消息改进：
  • 清理了事务（请求）日志。
  • 根据需要添加了更多日志消息。
  • 将事务（请求）日志消息从控制台输出移到了相关日志文件。
  • 更新了控制台日志，以使用集中式日志记录功能。
• 138321133、138320563 - 对配额缓冲区进行基本内部更改，以启用未来配额增强。

3.0.3

在 7 月 23 日（星期二），我们发布了针对 Edge Microgate 的以下修复和增强功能。

• Logging 增强功能：现有的运行时日志使用新的 eventLog() 函数，以一致的格式捕获和记录运行时数据。日志信息包括：
  • 时间戳（ISO 8601：YYYY-MM-DDTHH:mm:ss.sssZ）。
  • 日志级别（错误、警告或信息）。
  • 主机名 - 请求标头中发出请求的主机名。
  • 进程 ID - 如果您运行的是 Node.js 进程集群，则此参数是发生了日志记录的进程的 ID。
  • Apigee 组织名称。
  • 组织中的环境名称。
  • API 代理名称。
  • 客户端 IP 地址。
  • ClientId。
  • 关联 ID（未设置）。
  • Edge Microgate 组件名称。
  • 自定义消息 - 某些对象可能会输出传递给此错误属性的其他信息。
  • 请求方法（如果是 HTTP 请求）。
  • 响应状态代码（如果是 HTTP 请求）。
  • 错误消息。
  • 错误代码 - 如果对象包含错误代码，则会在此属性中输出。
  • 所用时间。
  • 操作系统 行尾标记。

  null 属性值会导致空括号 ([])。

  以下示例展示了日志格式：

  Timestamp [level][hostname][ProcessId][Org][Environment][APIProxy][ClientIp][ClientId][][component][customMessage][reqMethod][respStatusCode][errMessage][errCode][timeTaken]

  (137770055)

• 性能：未根据环境过滤 API 产品。此问题现已解决。(135038879)
• 其他功能测试集成和代码质量改进。

3.0.2

2019 年 7 月 3 日（星期三），我们发布了针对 Edge Microgate 的以下修复和增强功能。

代码质量 - 代码已经过质量审核，并且代码进行了更改，以满足用户要求的质量标准。我们解决了由 JSHint 引起的代码质量错误和警告。因此，我们发现并修复了一些实际的代码错误。所有 Apigee Edge Microgate 模块都经过了此流程。请参阅 microgateway-config、microgateway-core、microgateway-plugins 和 microgateway 的 6 月 28 日和 7 月 2 日提交内容。 所有代码质量更改的模块都已使用内部工具进行了测试，这些工具验证了 Edge Microgate 是否符合客户使用场景的执行情况。

3.0.1

2019 年 6 月 21 日（星期五），我们发布了 Edge Microgate 的以下修复和增强功能。

• 134834551 - 更改 Edge Microgate 支持的 Node.js 版本
  （Node.js 支持的版本：8 和 12；版本 7、9 和 11 为实验性版本）
• 134751883 - 在负载下重新加载时，Edge Microgate 崩溃
• 134518428 - 如果过滤模式不正确，Edge Microgate 的产品端点会返回 5XX
• 135113408 - 如果工作器意外终止，则应重启
• 134945852 - OAuth 插件中未使用 tokenCacheSize
• 134947757 - 在 OAuth 插件中设置 cacheTTL
• 135445171 - OAuth 中的宽限期计算不正确
• 使用安装 Edge Microgate 时提供的 memored 模块
• 135367906 - 安全审核

版本 2.5.x

新功能和增强功能 v.2.5.x

（修复版 2.5.38，2019 年 6 月 7 日）

使用令牌缓存时，格式不正确的 JWT 可能会导致工作器崩溃。在 Edge microgate-plugins 模块中进行了修复。(b/134672029)

（添加于 2.5.37 版）添加 CLI 选项 edgemicro-cert -t。

通过 edgemicro cert -t 选项，您可以指定用于对管理 API 进行身份验证的 OAuth 令牌。另请参阅管理证书。

（新增 2.5.35 版）添加对使用 edgemicroctl 调试 Edge Microgate 的支持。

您可以将 mgdebug 标志与 edgemicroctl 搭配使用。另请参阅 Kubernetes 集成任务。

（添加于 2.5.35）为 edgemicroctl 启用 Windows 版本。

（添加于 2.5.31）新的 edgemicro-auth/token API

添加了新的 Edgemicro-auth/token API，允许您将 client/secret 作为 Base64 编码的基本授权标头传递，并将 grant_type 作为表单参数进行传递。请参阅直接获取不记名令牌。

（修复 2.5.31）专用配置不遵循令牌标志

修复了以下问题：将 Edge Microgate 配置为在 Edge for Private Cloud 上使用 OAuth2 访问令牌时无法正常工作（未遵循该令牌）。

Docker：支持使用自签名证书

（新增 2.5.29）如果您使用 Node.js 默认不信任的证书授权机构 (CA)，则可以在通过 Edge Microgate 运行 Docker 容器时使用参数 NODE_EXTRA_CA_CERTS。如需了解详情，请参阅使用 Node.js 不信任的 CA。

Docker：支持 TLS

（添加了 2.5.29 版）对于发送到 Edge Microgate 服务器的传入请求（北向请求）以及从 Edge Microgate 发送到目标应用的传出请求（南向请求），在 Docker 容器中运行的 Edge Microgate 现在支持 TLS。

以下示例详细介绍了如何设置这些 TLS 配置：

• 北向 TLS 配置示例
• 南向 TLS 配置示例

在这些示例中，您将了解如何使用容器装载点 /opt/apigee/.edgemicro 加载证书，这些证书随后会在 Edge Microgate 配置文件中引用。

Docker：支持请求代理

（添加了 2.5.27 版）如果您在 Docker 容器中运行 Edge Microgate，当微网关在防火墙后面运行时，您可以使用这些选项来控制代理行为：

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

如需了解详情，请参阅将 Edge Micro 作为 Docker 容器运行。

Docker：更新了插件说明

（添加了 2.5.27 版）如果您在 Docker 容器中运行 Edge Microgate，现在可以通过两种方式部署插件。一种新的方法是使用 Docker 装载点。之前存在的另一个选项基本保持不变；不过，Dockerfile 已更新。如需了解详情，请参阅以下链接：

• 方法 A：在卷上装载插件目录（新）
• 方法 B：将插件构建到容器中（已更新）

针对 KVM 升级命令新增了 OAuth 令牌支持

（添加于 2.5.27 版）您可以通过 upgradekvm 命令使用 OAuth 令牌。如需了解详情，请参阅升级 KVM。

在 Edge Analytics 中隔离 API

（添加了 2.5.26 版）通过新的分析插件标志，您可以隔离特定的 API 路径，使其在 Edge Analytics 信息中心内显示为单独的代理。例如，您可以隔离健康检查 API，以免它们与实际的 API 调用混淆。如需了解详情，请参阅从分析中排除路径。

配置本地代理

（添加于 2.5.25 版）使用本地代理后，您无需在 Apigee Edge 上手动创建微网关感知型代理。微网关将改为使用本地代理的基础路径。如需了解详情，请参阅使用本地代理模式。

使用独立模式

（添加版本 2.5.25）您可以运行 Edge Microgate，它与任何 Apigee Edge 依赖项完全断开连接。此场景称为独立模式，可让您在没有互联网连接的情况下运行和测试 Edge Microgate。请参阅在独立模式下运行 Edge Microgate。

撤消密钥

（添加了 2.5.19 版）新增了一个 CLI 命令，可撤消 Edge Microgate 配置的密钥和密钥凭据。

edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]

支持 Docker

（添加了 2.5.19 版）您现在可以将最新的 Edge Microgate 版本作为 Docker 映像下载：

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

Kubernetes 支持

（添加于 2.5.19 版）您可以将 Edge Microgate 作为服务部署，也可以作为辅助信息文件网关部署在 Kubernetes 集群中部署的服务前面。请参阅：将 Edge Microgate 与 Kubernetes 集成概览。

支持 TCP 节点选项

（在 2.5.16 版中新增了）Edge Micro 配置中新增了一项配置设置 nodelay。

默认情况下，TCP 连接使用 Nagle 算法在数据发送之前对其进行缓冲。将 nodelay 设置为 true 可停用此行为（每次调用 socket.write() 时，数据会立即触发数据）。如需了解详情，另请参阅 Node.js 文档。

如需启用 nodelay，请按如下所示修改 Edge Micro 配置文件：

edgemicro:
  nodelay: true
  port: 8000
  max_connections: 1000
  config_change_poll_interval: 600
  logging:
    level: error
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24

用于永久监控的新 CLI 选项

（添加了 2.5.12 版）向 edgemicro forever 命令中添加了新参数。通过这些参数，您可以指定 forever.json 文件的位置，还可以启动或停止永久后台进程。另请参阅永久监控

示例：

如要永久启动：

edgemicro forever -f ~/mydir/forever.json -a start

如需永久停止，请执行以下操作：

edgemicro forever -a stop

JWT 密钥轮替

添加了一项新功能，可让您轮替用于生成 JWT 令牌的公钥/私钥对，用于在 Edge Microgate 上确保 OAuth 安全性。请参阅 轮替 JWT 密钥。

过滤下载的 API 代理

默认情况下，Edge Microgate 会下载您 Edge 组织中名称前缀为“edgemicro_”开头的所有代理。您可以更改此默认值以下载名称与模式匹配的代理。请参阅 过滤下载的代理。

指定不使用 API 代理的产品

在 Apigee Edge 中，您可以创建不包含任何 API 代理的 API 产品。 此产品配置允许与该产品关联的 API 密钥与贵组织中部署的任何代理配合使用。从 2.5.4 版开始，Edge Microgate 支持此产品配置。

支持永久监控

Edge Microgate 有一个 forever.json 文件，您可以通过配置该文件来控制 Edge Microgate 的重启次数和重启间隔。此文件会配置一项名为 forever-monitor 的服务，该服务以编程方式管理 Forever。请参阅 永久监控。

集中管理 Edge Micro 配置文件

如果您运行多个 Edge Microgate 实例，可能希望从一个位置管理这些实例的配置。为此，您可以指定一个 HTTP 端点，Edge Micro 可以从该端点下载其配置文件。请参阅 指定配置文件端点。

支持永久 CLI 选项

（添加于 2.5.8 版）使用 edgemicro forever [package.json] 命令指定 forever.json 文件的位置。添加此命令之前，配置文件必须位于 Edge Microgate 根目录中。

例如：

edgemicro forever ~/mydir/forever.json

添加了 configUrl 选项，以便重新加载命令

（添加了 2.5.8 版本）您现在可以将 --configUrl 或 -u 选项与 edgemicro reload 命令搭配使用。

JWT 时间差异的宽限期

（新增 2.5.7 版）OAuth 配置中的 gracePeriod 属性有助于防止因系统时钟与 JWT 授权令牌中指定的不早于 (nbf) 或颁发时间 (iat) 时间之间存在细微差异而引发的错误。将此属性设置为允许出现此类差异的秒数。请参阅 OAuth 特性。

（新增 2.5.7 版）OAuth 配置中的 gracePeriod 属性有助于防止因系统时钟与 JWT 授权令牌中指定的不早于 (nbf) 或颁发时间 (iat) 时间之间存在细微差异而引发的错误。将此属性设置为允许出现此类差异的秒数。请参阅 OAuth 特性。

v2.5.x 中修复的 bug

• （问题 #236）修复了清除缓存中的拼写错误。
• （问题 #234）重新加载 Edge Microgate 2.5.35 的崩溃情况。
• （问题 #135）使用 -v 选项时出现无效的虚拟主机引用“secure”错误。此修复会在部署之前修改 Edgemicro-auth 代理，以确保虚拟主机与“-v”标志中指定的内容完全匹配。此外，您可以为虚拟主机指定任意数量的任意名称（不再受限于默认和安全）。
• （问题 #141）edgemicroReload 命令不支持配置文件选项 -c。此问题已解决。
• （问题 #142）Edge Microgate 在安装时指出已废弃的加密方式。 此问题已解决。
• （问题 #145）Edge Microgate 的配额无效。此问题已解决。
• （Apigee 社区问题： https://community.apigee.com/questions/33149/emg-jwt-token-validated-against-拦截-api-proxies-a.html#answer-33336）已根据 OAUTH 中的 API 代理和资源 URI 验证 JWT 令牌。此问题现已解决。
• （Apigee 社区问题：https://community.apigee.com/questions/47846/microgateway-not-working-with-oauth.html）Microgate 不支持 OAuth。此问题已解决。
• 修复了 Windows 上的 pidPath。
• （问题 #157）已修复导致以下错误消息的问题：未定义 ReferenceError: deployProxyWithPassword。
• （问题 #169）更新 Node.js 依赖项 (npm 审核)
• edgemicro-auth 代理现在使用 Edge JWT 政策。该代理不再依赖于 Node.js 来提供 JWT 支持。

版本 2.4.x

新功能和增强功能 v.2.4.x

1. 为 Edgemicro-auth 代理设置自定义别名 (PR 116)

您可以更改 edgemicro-auth 代理的默认基本路径。默认情况下，基本路径为 /edgemicro-auth。要进行更改，请在 edgemicro configure 命令中使用 -x 标志。

例如：

edgemicro configure -x /mypath …

2. 针对基本路径的通配符支持 (PR 77)

您可以在 edgemicro_* 代理的基本路径中使用一个或多个“*”通配符。例如，借助 /team/*/members 的基本路径，客户端可以调用 https://[host]/team/blue/members 和 https://[host]/team/green/members，而无需创建新的 API 代理来支持新团队。请注意，不支持 /**/。

3. 为 Private Cloud 配置添加了自定义配置路径 (PR 99)

默认情况下，微网关配置文件位于 ./config/config.yaml 中。在 init、配置和启动命令中，您现在可以在命令行中使用 -c 或 --configDir 标志指定自定义配置路径。修复了无法识别用于 Private Cloud 安装的自定义配置目录的问题。

例如：

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

4：尊重 *_PROXY 变量 (PR 61)

如果 Edge Microgate 安装在防火墙后面，并且无法与公有云中的 Apigee Edge 通信，您可考虑以下两种方案：

选项 1：

第一个选项是在 microgate 配置文件中将 edgemicro:proxy_tunnel 选项设置为 true：

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: true

当 proxy_tunnel 为 true 时，Edge Microgate 会使用 HTTP CONNECT 方法在单个 TCP 连接上建立 HTTP 请求隧道。（如果用于配置代理的环境变量启用了 TLS，也是如此）。

选项 2：

第二个选项是指定代理，并在微网关配置文件中将 proxy_tunnel 设置为 false。例如：

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: false

在这种情况下，您可以设置以下变量来控制要使用的每个 HTTP 代理的主机，或者哪些主机不应处理 Edge Microgate 代理：HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY。您可以将 NO_PROXY 设置为 Edge Microgate 不应代理的网域列表（以英文逗号分隔）。例如：

export HTTP_PROXY='http://localhost:3786'
export HTTPS_PROXY='https://localhost:3786'

如需详细了解这些变量，请参阅：

https://www.npmjs.com/package/request#controlling-proxy-behaviour-using-environment-variables

5：为目标请求设置自定义超时 (PR 57)

您可以使用以下配置为目标请求设置自定义超时：

edgemicro:
    request_timeout: 10

超时设置以秒为单位。如果发生超时，Edge Microgate 将返回 504 状态代码。

6. 在目标响应中遵循自定义 HTTP 状态消息 (PR 53)

Edge Microgate 会遵循为目标响应设置的自定义 HTTP 状态消息。在之前的版本中，从目标发送的状态消息已被 Node.js 默认值替换。

7. X-Forwarded-For 标头可以为分析设置 client_ip

如果存在，X-Forwarded-For 标头将设置 Edge Analytics 中报告的 client_ip 变量。此功能可让您了解向 Edge Microgate 发送请求的客户端的 IP 地址。

8. OAuth 插件变更

OAuth 插件支持 API 密钥验证和 OAuth 访问令牌验证。在此项变更之前，该插件接受了任一安全形式。进行此项更改后，您可以仅允许使用其中一种安全模型（同时保持向后兼容性）。

OAuth 插件添加了两个新标志：

• allowOAuthOnly - 如果设置为 true，则每个 API 都必须带有包含不记名访问令牌的授权标头。

• allowAPIKeyOnly - 如果设置为 true，则每个 API 都必须包含带有 API 密钥的 x-api-key 标头（或自定义位置）。

您可以在 Edge Microgate 配置文件中设置这些标志，如下所示：

oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    keep-authorization-header: false
    allowOAuthOnly: false
    allowAPIKeyOnly: false

9. 改进了 Edgemicro-auth 代理 (PR 40)

改进了 edgemicro-auth 代理。在做出这些更改之前，代理会将密钥存储在边缘安全存储区（一个加密保险柜）中。现在，该代理将密钥存储在 Edge 的加密键值对映射 (KVM) 中。

10. 在插件中重写默认目标网址 (PR 74)

您还可以替换目标端点端口，并选择 HTTP 或 HTTPS。在插件代码中修改以下变量：req.targetPort 和 req.targetSecure。要选择 HTTPS，请将 req.targetSecure 设置为 true；对于 HTTP 事件，请将其设置为 false。如果您将 req.targetSecure 设置为 true，请参阅此讨论会话了解详情。

11. 对 OAuth 令牌身份验证的初步支持 (PR 125)

您可以将 Edge Microgate 配置为使用 OAuth 令牌（而不是用户名/密码）进行身份验证。如需使用 OAuth 令牌，请在 edgemicro configure 命令中使用以下参数：

-t, --token <token>

例如：

edgemicro configure -o docs -e test -t <your token>

v2.4.3 中修复的问题

• 修复了需要付费组织才能正确运行 Edgemicro-auth 代理的问题。现在，您还可以将 Edge Microgate 与试用组织搭配使用。（PR 5）
• 修复了流没有完成数据处理，但最终处理程序仍然会执行的问题。这会导致发送部分响应。（PR 71）
• 修复了无法识别用于 Private Cloud 安装的自定义配置目录的问题。（PR 110）
• 修复了客户端与 Edge Microgate 之间的双向 SSL 问题。（PR 70）
• 修复了以下问题：代理基路径上要求有尾随斜杠，才能使 API 密钥验证正常运行。现在，基本路径末尾不需要使用尾随斜杠。（PR 48）

版本 2.3.5

新功能和增强功能 v.2.3.5

代理过滤

您可以过滤 Edge Microgate 实例将处理哪些微网关感知型代理。Edge Microgate 启动时，它会下载与其关联的组织中所有感知到微网关的代理。使用以下配置来限制微网关将处理哪些代理。例如，此配置将微网关将处理的代理限制为三个：edgemicro_proxy-1、edgemicro_proxy-2 和 edgemicro_proxy-3：

proxies:
  - edgemicro_proxy-1
  - edgemicro_proxy-2
  - edgemicro_proxy-3

Google Analytics（分析）数据脱敏

通过新配置，您可以阻止请求路径信息显示在边缘分析中。将以下内容添加到微网关配置，以遮盖请求 URI 和/或请求路径。请注意，URI 由请求的主机名和路径部分组成。

analytics:
  mask_request_uri: 'string_to_mask'
  mask_request_path: 'string_to_mask'

版本 2.3.3

新功能和增强功能 v.2.3.3

以下是此版本中的新功能和增强功能。

停用自动更改轮询

您可以通过在微网关配置中设置以下特性来关闭自动更改轮询功能：

disabled_config_poll_interval: true

默认情况下，定期轮询会获取在 Edge 上所做的更改（对产品、微网关感知代理等所做的更改）以及对本地配置文件所做的更改。默认轮询间隔为 600 秒（五分钟）。

重写插件中的目标网址

您可以通过修改插件代码中的以下变量，在插件中动态替换默认目标网址：req.targetHostname 和 req.targetPath。

新插件函数签名

我们添加了一个新的插件函数签名，用于以参数形式提供目标响应。添加后，插件可以更轻松地访问目标响应。

function(sourceRequest, sourceResponse, targetResponse, data, cb)

简化了默认日志记录输出

默认情况下，日志记录服务现在会忽略下载的代理、产品和 JWT 的 JSON。您可以在启动 Edge Microgate 时，通过设置 DEBUG=* 来更改为默认输出这些对象。例如：

DEBUG=* edgemicro start -o docs -e test -k abc123 -s xyz456

向 CLI 添加了自定义配置路径

默认情况下，微网关配置文件位于 ./config/config.yaml 中。现在，您可以在 init、配置和 start 命令中使用命令行指定自定义配置路径。例如：

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

v2.3.3 中修复的 bug

• 修复了在处理大型请求/响应期间发生的内存泄漏问题。
• 修复了插件的执行顺序。现在，它的行为方式与文档中说明的方式一致。
• 对于 GET 请求，插件累积请求插件不再挂起。
• 修复了累积响应插件中缺少响应正文导致错误的问题。

版本 2.3.1

安装说明

某些旧版的 Edge Microgate 允许您通过下载 ZIP 文件来安装该软件。这些 ZIP 文件已不再受支持。如需安装 Edge Microgate，您必须使用：

npm install -g edgemicro

如需了解详情，请参阅安装主题。

新功能和增强功能 v.2.3.1

以下是此版本中的新功能和增强功能。

过滤代理

通过新配置，您可以过滤 Edge Microgate 将在启动时加载哪些代理。之前，microgate 加载了从您在 Edgemicro 配置命令中指定的 Edge 组织/环境拉取的所有微网关感知型代理（名为 Edgemicro_* 的代理）。通过这项新功能，您可以过滤此代理列表，使 Edge Microgate 仅加载您指定的代理列表。只需将代理元素添加到微网关配置文件中，如下所示：

edge micro:
proxies:
    - edgemicro_[name]
    - edgemicro_[name]
    ...

例如，假设您的 Edge 组织/环境中有 50 个 edgemicro_* 代理，包括名为 edgemicro_foo 和 edgemicro_bar 的代理。您可以指示微网关仅使用这两个代理，如下所示：

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

微网关在启动时只能调用指定的代理。如果尝试调用从 Edge 组织/环境下载的其他微网关感知型代理，则将导致错误。

在插件中设置目标请求标头

如果要添加或修改目标请求标头，需要考虑两种基本模式：一种是传入请求包含数据（如在 POST 请求中），另一种是不含数据（如在简单的 GET 请求中）。

假设传入请求包含数据，并且您希望在目标请求上设置请求标头。在以前的 Edge Microgate 版本中，在这种情况下，无法可靠地设置目标标头。

此模式的关键是首先累积来自客户端的所有传入数据。然后，在 onend_request() 函数中，使用新函数 request.setOverrideHeader(name, value) 自定义标头。

以下示例插件代码展示了如何执行此操作。在 onend_request 中设置的标头将发送到目标：

module.exports.init = function(config, logger, stats) {


  function accumulate(req, data) {
    if (!req._chunks) req._chunks = [];
    req._chunks.push(data);
  }

  return {

    ondata_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      next(null, null);
    },

    onend_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      var content = Buffer.concat(req._chunks);
      delete req._chunks;
      req.setOverrideHeader('foo', 'bar');
      req.setOverrideHeader('content-length', content.length);
      next(null, content);
    },


    onerror_request: function(req, res, data, next) {
      next(null, null);
    }

  };

}

如果请求不包含数据，您可以在 onrequest() 处理程序中设置目标标头。此模式并不新鲜，它之前已记录过，并且已在 Edge Microgate 提供的示例插件中使用。

onrequest: function(req, res, next) {
      debug('plugin onrequest');
      req.headers['x-foo-request-id'] = "bar";
      req.headers['x-foo-request-start'] = Date.now();
      next();
    }

零停机重新加载功能

更改 Edge Microgate 配置后，您可以加载配置而不丢失任何消息。进行此更改后，Edge Microgate 始终以集群模式启动，并且 --cluster 选项已从 edgemicro start 命令中移除。

此外，还新增了三个 CLI 命令。您必须从执行 edgemicro start 命令的同一目录运行以下命令：

• edgemicro status - 检查 Edge Microgate 是否正在运行。
• edgemicro stop - 停止 Edge Microgate 集群。
• edgemicro reload - 重新加载 Edge Microgate 配置，无需停机。

自动重新加载配置，无需停机

Edge Microgate 会定期加载新配置，并在发生任何更改时执行重新加载。轮询会提取对 Edge 所做的任何更改（对产品、微网关感知型代理的更改等）以及对本地配置文件所做的更改。默认轮询间隔为 600 秒（五分钟）。您可以在微网关配置文件中更改默认值，如下所示：

edgemicro:
    config_change_poll_interval: [seconds]

向 CLI 添加了版本信息

CLI 中添加了 --version 标志。如需获取 Edge Microgate 的当前版本，请使用以下命令：

edgemicro --version

新的 Edge Microgate 服务器 SSL 选项

除了 key 和 cert 之外，Edge Microgate 现在还支持以下服务器 SSL 选项：

将日志文件发送到 stdout

您可以使用新的配置设置将日志数据发送到标准输出：

edgemicro:
  logging:
    to_console: true  

请参阅 管理日志文件。

版本 2.1.2

以下是此版本中的新功能和增强功能。

允许配置自定义 API 端点

授权代理新增了可配置端点，支持使用自定义身份验证服务。这些端点包括：

• edgeconfig:verify_api_key_url
• edgeconfig:products

如需了解详情，请参阅 使用自定义身份验证服务。

版本 2.1.1

以下是此版本中的新功能和增强功能。

部署与跨平台兼容的身份验证代理

我们进行了增强，使用于将 Edge Microgate 授权代理部署到 Edge 的命令在 Windows 系统中是兼容的。

版本 2.1.0

新功能和增强功能 v.21.0

新功能和增强功能如下：

指定客户端 SSL/TLS 选项

您可以使用一组新的配置选项为目标的 SSL/TSL 连接指定客户端选项。请参阅 使用客户端 SSL/TSL 选项。

版本 2.0.11

安装说明 v2.0.11

某些旧版的 Edge Microgate 允许您通过下载 ZIP 文件来安装该软件。这些 ZIP 文件已不再受支持。如需安装 Edge Microgate，您必须使用：

npm install -g edgemicro

如需了解详情，请参阅安装主题。

新功能和增强功能 v.2.0.11

新功能和增强功能如下：

在启动时指定端口

借助 start 命令，您可以指定端口号以替换配置文件中指定的端口。您还可以使用 PORT 环境变量指定端口号。如需了解详情，请参阅 start 命令。

可以选择保留身份验证标头

新的配置设置 keepAuthHeader 可用于保留请求中发送的 Authorization 标头。如果设置为 true，系统会将 Auth 标头传递给目标。请参阅 OAuth 属性。

能够使用自定义授权服务

如果要使用自己的自定义服务处理身份验证，请将 Edge Microgate 配置文件中的 authUri 值更改为指向您的服务。如需了解详情，请参阅 使用自定义身份验证服务。

版本 2.0.4

Edge Microgate v.2.0.4 已于 2016 年 5 月 25 日发布。

新功能和增强功能 v2.0.4

以下是此版本中的新功能和增强功能。

支持产品中的资源路径

Edge Microgate 现在支持产品中的资源路径。资源路径允许您根据代理路径后缀限制对 API 的访问。如需详细了解如何创建商品和配置资源路径，请参阅创建 API 产品。

支持 npm 全局安装

您现在可以使用 npm -g (global) 选项安装 Edge Microgate 了。如需详细了解此选项，请参阅 npm 文档。

版本 2.0.0

Edge Microgate v2.0.0 已于 2016 年 4 月 18 日发布。

新功能和增强功能 v.2.0.0

以下是此版本中的新功能和增强功能。

单进程服务器

Edge Microgate 现在是一种单进程服务器。它不再使用双进程模式，在这种模式下，一个进程（以前称为“代理”）会启动 Edge Microgate，即第二个进程。新的架构使自动化和容器化变得更简单。

命名空间型配置文件

配置文件现在使用组织和环境设置命名空间，因此多个 Microgate 实例可以在同一主机上运行。运行 Edge Microgate 配置命令后，您可以在 ~/.edgemicro 中找到这些配置文件。

新的环境变量

现在有 4 个环境变量：EDGEMICRO_ORG、EDGEMICRO_ENV、EDGEMICRO_KEY、EDGEMICRO_SECRET。如果您在系统上设置这些变量，在使用命令行界面 (CLI) 配置和启动 Edge Microgate 时，无需指定它们的值。

缓存的配置

如果 Edge Microgate 在不连接到 Apigee Edge 的情况下重启时，会使用缓存的配置文件 。

集群模式

现在，我们提供了以集群模式启动 Edge Microgate 的选项。借助集群模式，您可以利用多核系统。微网关采用 Node.js 集群模块来实现此功能。如需了解详情，请参阅 Node.js 文档。

v2.0.0 中修复的错误

插件事件生命周期现在可以通过新的回调函数正确处理包含代码的异步代码。

版本 1.1.2

Edge Microgate v. 1.1.2 已于 2016 年 3 月 14 日发布。

新功能和增强功能 v.1.1.2

以下是此版本中的新功能和增强功能。

性能改进

Edge Microgate 现在正确使用 Node.js HTTP 代理，以获得更好的连接池。此增强功能可提高高负载下的性能和整体稳定性。

远程调试程序支持

您可以将 Edge Microgate 配置为使用远程调试程序（例如 node-inspector）运行。

新配置文件位置

配置 Edge Microgate 时，agent/config/default.yaml 文件现在会复制到 ~./edgemicro/config.yaml。

日志文件轮播

新的配置属性可让您指定 Edge Microgate 日志的轮替间隔。

v1.1.2 中修复的问题

v. 1.1.2 中修复了以下错误。