Edge Microgate 版本说明

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

版本 3.3.x

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

3.3.3

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

组件版本：

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

bug 修复和增强功能：

已解决的安全问题

• CVE-2023-0842
• CVE-2023-26115
• CVE-2022-25883
• CVE-2017-20162
• CVE-2022-31129
• CVE-2022-23539
• CVE-2022-23541
• CVE-2022-23540
• CVE-2024-21484
• CVE-2022-46175
• CVE-2023-45133
• CVE-2020-15366
• CVE-2023-26136
• CVE-2023-26115

3.3.2

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

组件版本：

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

bug 修复和增强功能：

已解决的安全问题

无。

3.3.1

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

组件版本：

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

bug 修复和增强功能：

已解决的安全问题

3.3.0

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

组件版本：

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

bug 修复和增强功能：

npm install apigeetool@0.15.1

版本 3.2.x

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

3.2.3

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

组件版本：

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

bug 修复和增强功能：

已解决的安全问题

3.2.2

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

组件版本：

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

bug 修复和增强功能：

已解决的安全问题

3.2.1

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

组件版本：

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

bug 修复和增强功能：

edgemicro:
 enable_GET_req_body: true

3.2.0

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

组件版本：

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

bug 修复和增强功能：

版本 3.1.x

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

3.1.8

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

组件版本：

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

bug 修复和增强功能：

3.1.7

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

组件版本：

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

bug 修复和增强功能：

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

3.1.6

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

组件版本：

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

bug 修复和增强功能：

3.1.5

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

组件版本：

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

bug 修复和增强功能：

3.1.4

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

bug 修复：

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

3.1.3

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

组件版本：

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

bug 修复和增强功能：

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

3.1.2

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

组件版本：

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

bug 修复和增强功能：

• 151285018 - 进行了一项功能增强功能，为 Edge Microgateway 和后端目标之间的流量添加了 HTTP 代理支持。此外，我们还修复了 Edge Microgateway 和 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 Microgateway 的 Docker 映像中的 Node.js 版本更新为 12，因为 Node.js v8 已弃用。
• 151306049 - 进行了文档更新，列出了 Edge Microgateway CLI 命令使用的 Apigee Edge 管理 API。请参阅 Edge Microgateway 使用哪些管理 API？。

3.1.1

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

组件版本：

下表列出了与 Edge Microgateway 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 Microgateway 将能够检索该属性并应用目标端点特定的超时。如果未应用此参数，Edge Microgateway 将使用通过 edgemicro.request_timeout 指定的全局超时。

3.1.0

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

组件版本：

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

bug 修复和增强功能：

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

  例如：

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

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

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

  目前支持将同步功能与 Redis 5.0.x 搭配使用。

版本 3.0.x

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

3.0.10

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

组件版本：

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

bug 修复和增强功能：

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

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

  

  注意：Edge Microgateway 不支持 配置“/”、“/*”和“/**”资源路径的行为中所述的 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 Microgateway 实例。如果为 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 Microgateway 的以下修复和增强功能。

组件版本：

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

bug 修复和增强功能：

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

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

  quotas :
   failOpen : true

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

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

  quotas:
    useDebugMpId: true

  设置 useDebugMpId 后，Edge 的配额响应将包含 MP ID，并且 Edge Microgateway 会记录该 ID。例如：

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

3.0.8

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

组件版本：

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

bug 修复和增强功能：

• 140025210 - 添加了新的“应急开启”功能。此功能允许 API 处理在由于连接错误而无法成功刷新（导致无法成功调用 edgemicro-auth 代理）的情况下继续进行 API 处理。

  此功能允许您设置一个宽限期，在该宽限期内，旧令牌将保留在缓存中并可在宽限期到期之前重复使用。该功能允许 Edge Microgateway 在临时连接失败时继续处理请求。当连接恢复并且验证 API 密钥成功调用时，系统将提取新的 JWT 并替换缓存中的旧 JWT。

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

  1. 在 Edge Microgateway 配置文件的 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 Microgateway 密钥和 Secret。Edge Microgateway 已更新为始终在每个 Verify API 密钥请求中发送密钥和密文。此更改可防止客户端仅使用 API 密钥获取 JWT。
• 140090250 - 更新了为配额处理添加诊断记录功能。进行此更改后，现在可以将 Quto 日志输出与 Edge Microgateway 日志的其余部分相关联。

3.0.7

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

组件版本：

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

bug 修复和增强功能：

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

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

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

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

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

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

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

  edgemicro:
      keepAliveTimeout

  在版本 3.0.6 中有错误记录。正确的属性名称应如下所示：

  edgemicro:
      keep_alive_timeout

• 139526406 - 修复了以下 bug：开发者应用具有多个产品时，配额计数会有误。在具有多个产品的应用中，现在可以正确为每个产品强制执行配额。“appName + productName”的组合用作配额标识符。

3.0.6

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

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

  例如：

  edgemicro:
    keep_alive_timeout: 600

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

  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 Microgateway 的以下修复和增强功能。

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

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

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

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

3.0.4

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

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

3.0.3

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

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

  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 Microgateway 的以下修复和增强功能。

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

3.0.1

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

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

版本 2.5.x

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

（已修复 2.5.38、2019 年 6 月 7 日）

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

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

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

（添加 2.5.35 版本）使用 edgemicroctl 添加对调试 Edge Microgateway 的支持。

您可以将 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 for Private Cloud 上配置 Edge Microgateway 以使用 OAuth2 访问令牌无法正常工作（令牌不受支持）。

Docker：支持使用自签名证书

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

Docker：支持 TLS

（添加了 2.5.29 版）在 Docker 容器中运行的 Edge Microgateway 现在支持对 Edge Microgateway 服务器的传入请求（北向请求）和从 Edge Microgateway 到目标应用的传出请求（南向请求）使用 TLS。

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

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

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

Docker：支持请求代理

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

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

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

Docker：更新了插件说明

（添加版本 2.5.27）如果您在 Docker 容器中运行 Edge Microgateway，则现在有两个插件部署选项。一种新的方法是使用 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 Microgateway 与任何 Apigee Edge 依赖项完全断开连接。这种场景称为独立模式，可让您在没有互联网连接的情况下运行和测试 Edge Microgateway。请参阅在独立模式下运行 Edge Microgateway。

撤消密钥

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

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

Docker 支持

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

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

Kubernetes 支持

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

支持 TCP nodelay 选项

（添加了 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 文件的位置，还可以启动或停止 Forever 后台进程。另请参阅永久监控

示例：

要永久启动，请按以下步骤操作：

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

如需永久停止，请按以下步骤操作：

edgemicro forever -a stop

JWT 密钥轮替

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

过滤下载的 API 代理

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

指定不使用 API 代理的产品

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

支持永久监控

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

集中管理 Edge Micro 配置文件

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

支持永久 CLI 选项

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

例如：

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 中修复的错误

• （问题 #236）修复了清除缓存时的拼写错误。
• （问题 234）重新加载 Edge Microgateway 2.5.35 的崩溃。
• （问题 #135）使用 -v 选项时出现无效的虚拟主机引用“secure”错误。此修复会在部署之前修改 Edgemicro-auth 代理，以确保虚拟主机与“-v”标志中指定的内容完全匹配。此外，您可以为虚拟主机指定任意数量的名称和任何名称（不再受限于默认且安全的虚拟主机）。
• （问题 #141）edgemicro refresh 命令不支持配置文件选项 -c。此问题已解决。
• （问题 142）Edge Microgateway 在安装时投诉加密算法已弃用。此问题已解决。
• （问题 145）Edge Microgateway 的配额无效。此问题已解决。
• （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）Microgateway 不支持 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. 向 CLI 添加了自定义配置路径以用于私有云配置 (PR 99)

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

例如：

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

4：遵从 *_PROXY 变量 (PR 61)

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

选项 1：

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

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

当 proxy_tunnel 为 true 时，Edge Microgateway 使用 HTTP CONNECT 方法通过单个 TCP 连接传送 HTTP 请求。（如果用于配置代理的环境变量启用了 TLS，也会出现这种情况。）

选项 2：

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

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

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

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 Microgateway 会返回 504 状态代码。

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

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

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

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

8. OAuth 插件变更

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

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

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

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

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

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

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

改进了 edgemicro-auth 代理。在这些更改之前，代理将密钥存储在加密保险柜 Edge Secure Store 中。现在，该代理将密钥存储在 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 Microgateway 配置为使用 OAuth 令牌（而不是用户名/密码）进行身份验证。如需使用 OAuth 令牌，请在 edgemicro configure 命令中使用以下参数：

-t, --token <token>

例如：

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

v2.4.3 修复了一些 bug

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

版本 2.3.5

新功能和增强功能 v.2.3.5

代理过滤

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

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

Google Analytics（分析）数据遮盖

通过新配置，您可以阻止请求路径信息显示在 Edge 分析中。将以下内容添加到微网关配置中，以遮盖请求 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 Microgateway 时设置 DEBUG=* 即可。例如：

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

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

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

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

v2.3.3 修复了一些 bug

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

版本 2.3.1

安装说明

某些旧版 Edge Microgateway 可让您通过下载 ZIP 文件来安装该软件。系统已不再支持这些 ZIP 文件。如需安装 Edge Microgateway，您必须使用：

npm install -g edgemicro

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

新功能和增强功能 v.2.3.1

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

过滤代理

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

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 Microgateway 版本中，在这种情况下无法可靠地设置目标标头。

此模式的关键是首先累积来自客户端的所有传入数据。然后，在 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 Microgateway 提供的示例插件中使用。

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 Microgateway 的配置后，您可以加载配置而不丢弃任何消息。进行此更改后，Edge Microgateway 始终以集群模式启动，并且 --cluster 选项已从 edgemicro start 命令中移除。

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

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

自动重新加载配置，零停机

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

edgemicro:
    config_change_poll_interval: [seconds]

向 CLI 添加了版本信息

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

edgemicro --version

新的 Edge Microgateway 服务器 SSL 选项

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

将日志文件发送到 stdout

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

edgemicro:
  logging:
    to_console: true  

请参阅 管理日志文件。

版本 2.1.2

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

允许使用自定义 API 端点进行配置

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

• edgeconfig:verify_api_key_url
• edgeconfig:products

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

版本 2.1.1

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

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

我们进行了一项增强功能，使用于将 Edge Microgateway 授权代理部署到 Edge 的命令在 Windows 系统上与 Windows 系统兼容。

版本 2.1.0

新功能和增强功能 v.21.0

新功能和增强功能如下：

指定客户端 SSL/TLS 选项

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

版本 2.0.11

安装说明 v2.0.11

某些旧版 Edge Microgateway 可让您通过下载 ZIP 文件来安装该软件。系统已不再支持这些 ZIP 文件。如需安装 Edge Microgateway，您必须使用：

npm install -g edgemicro

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

新功能和增强功能 v.2.0.11

新功能和增强功能如下：

在启动时指定端口

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

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

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

能够使用自定义授权服务

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

版本 2.0.4

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

新功能和增强功能 v2.0.4

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

支持产品中的资源路径

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

对 npm global install 的支持

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

版本 2.0.0

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

新功能和增强功能 v.2.0.0

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

单进程服务器

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

命名空间型配置文件

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

新的环境变量

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

缓存的配置

Edge Microgateway 在未连接到 Apigee Edge 的情况下重启时会使用缓存的配置文件。

集群模式

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

v2.0.0 中修复了 bug

插件事件生命周期现在可以正确处理异步代码，其中包含具有新回调的代码。

版本 1.1.2

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

新功能和增强功能 v.1.1.2

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

性能改进

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

远程调试程序支持

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

新的配置文件位置

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

日志文件轮播

通过新的配置属性，您可以指定 Edge Microgateway 日志的轮替间隔。

v1.1.2 修复了一些 bug

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