Edge Microgateway リリースノート

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご覧ください。

バージョン 3.3.x

バグの修正と機能強化 v.3.3.x

3.3.2

2023 年 8 月 18 日に、Edge Microgateway の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.3.2 に関連する個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

セキュリティに関する問題を修正しました

なし。

3.3.1

2022 年 6 月 7 日に、Edge Microgateway の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.3.1 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

セキュリティに関する問題を修正しました

3.3.0

2022 年 2 月 4 日に、Edge Microgateway の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.3.0 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

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 に関連する個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

セキュリティに関する問題を修正しました

3.2.2

2021 年 7 月 15 日（木曜日）、Edge Microgateway に対する修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.2.2 に関連する個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

セキュリティに関する問題を修正しました

3.2.1

2021 年 3 月 5 日（金）、Edge Microgateway は修正と機能拡張をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.2.1 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

edgemicro:
 enable_GET_req_body: true

3.2.0

2021 年 1 月 21 日（木）、Edge Microgateway は修正と機能強化がリリースされました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.2.0 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

バージョン 3.1.x

バグの修正と機能強化 v.3.1.x

3.1.8

2020 年 11 月 16 日（月）、Edge Microgateway に対する修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.8 に関連する個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

3.1.7

2020 年 9 月 24 日（木）、Edge Microgateway に対する修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.7 に関連する個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

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

3.1.6

2020 年 8 月 20 日（木曜日）、Edge Microgateway に対する修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.6 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

3.1.5

2020 年 6 月 26 日（金）、Edge Microgateway は以下の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.5 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

3.1.4

2020 年 4 月 23 日（金）に、Edge Microgateway に次の修正をリリースしました。

バグの修正:

バージョン 3.1.3 における依存関係の問題を修正しました。バージョン 3.1.3 は、npm リポジトリで非推奨としてマークされています。それ以外の場合は、バージョン 3.1.3 のリリースノートで説明されているすべてのバグの修正と機能強化が適用されます。

3.1.3

2020 年 4 月 15 日（水）、Edge Microgateway は以下の修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.3 に関連する個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

• 153509313 - Node.js デバッグ モジュールがメモリリークを引き起こす問題を修正しました。この問題は、バージョン v3.1.0、v3.1.1、3.1.2 に存在します。
• 153509313 - 2 つの異なるトランザクションで同じメッセージ ID がロギング出力に出力される問題を修正しました。
• 151673570 - Edge Microgateway が新しい Apigee KVM API を使用するように更新されない問題を修正しました。Edge Microgateway は、KVM 値の追加と更新に新しいコマンドを使用するようになりました。
• 152822846 - 以前のリリースでは、リソースパス マッピングの処理が Apigee Edge の処理と一致するように Edge Microgateway が更新されました。このリリースで、パターン /literal_string/* が正しく処理されない問題が修正されました。例: /*/2/* 「/」、「/*」、「/**」のリソースパスの動作を構成するもご覧ください。
• 152005003 - 割り当てで組織スコープと環境スコープの識別子を有効にするように変更。
• 152005003 - 割り当てで組織スコープと環境スコープの識別子を有効にするように変更。「org + env + appName + productName」の組み合わせが割り当て識別子として使用されます。

3.1.2

2020 年 3 月 16 日（月）、Edge Microgateway に対する修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.3 に関連する個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

• 151285018 - Edge Microgateway とバックエンド ターゲット間のトラフィックに HTTP プロキシのサポートを追加する機能が強化されました。さらに、Edge Microgateway と Apigee Edge の間の既存の HTTP プロキシ サポートに関する問題を修正しました。詳しくは、以下をご覧ください。
  • Apigee Edge との通信に HTTP プロキシを使用する
  • ターゲット通信に HTTP プロキシを使用する
• 149101890 - ターゲット サーバーまたはロードバランサが接続を閉じた場合のログ通知コードが ERROR から INFO に変更されました。
• 150746985 - 構成ファイルに redisBasedConfigCache: true または quotaUri: https://%s-%s.apigee.net/edgemicro-auth が存在する場合に edgemicro verify コマンドが正しく機能しない問題を修正しました。
• 151284716 - 再読み込み中にワーカーを再起動したときのサーバー接続をより速く閉じるように機能強化しました。
• 151588764 - Node.js v8 が非推奨になったため、Docker コンテナで Edge Microgateway を実行するために使用される Docker イメージの Node.js バージョンを 12 に更新します。
• 151306049 - Edge Microgateway CLI コマンドで使用される Apigee Edge Management API を一覧表示するために、ドキュメントが更新されました。 Edge Microgateway が使用する管理 API をご覧ください。

3.1.1

2 月 20 日（木）、Edge Microgateway に修正と機能強化がリリースされました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.1.1 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

• 146069701 - microgateway-core モジュールが HTTP_PROXY 環境変数と HTTPS_PROXY 環境変数を尊重しない問題を修正しました。この変更により、YAML 構成ファイルのプロキシ設定（指定されている場合）が無視されるようになりました。プロキシの指定には環境変数のみが使用されます。

  構成ファイルでプロキシ構成を指定する場合は、構成ファイルで指定したプロキシ URL と同じプロキシ URL の 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 - 1 つのグローバル タイムアウト設定を使用する代わりに、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 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

• 144187500 - quotas.failOpen フラグがトリガーされると、新しい WARN レベルのイベントがログに記録されます。このフラグは、割り当て処理エラーが発生した場合、または 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 Microgateway が API プロキシの変更を検出するたびに、処理中または新しいトランザクションに影響する問題を修正しました。プロキシが変更されると、Edge Microgateway はキャッシュを更新してワーカーノードを再起動します。この変更により、処理中のトランザクションとマイクロゲートウェイに送信される新しい API 呼び出しは影響を受けません。
• 146378327 - sourceRequest、targetRequest、targetResponse のログレベルが INFO レベルに変更されました。
• 146019878 - Edge Analytics で「API Proxy Performance」と計算されたレイテンシと Edge Microgateway sourceResponse/targetResponse ログイベントの間の差異が修正されました。Edge Analytics のログイベントと Microgateway ログイベントのレイテンシが整合性になりました。
• パターン マッチング ロジックに関連する変更:
  • 147027862 - OAuth プロダクトが、API プロダクトで指定される次のリソースパス マッチング パターンをサポートするように更新されました。
    • /{literal}**
    • /{literal}*
    • 上記 2 つのパターンの任意の組み合わせ

    この変更により、Edge Microgateway プラグインは Apigee Edge と同じパターン マッチングを行うようになりました。これについては、リソースパス「/」、「/*」、「/**」の構成をご覧ください。

  • 145644205 - OAuth プラグインと一致するように apiKeys プラグインのパターン マッチング ロジックを更新
• 143488312 - OAuth トークンと API キーのリクエストに対して、クライアント ID パラメータの先頭または末尾のスペースで JWT プロダクト リストを作成できないという問題を修正しました。
• 145640807 と 147579179 - 「Synchronizer」と呼ばれる特別な Edge Microgateway インスタンスが Apigee Edge から構成データを取得してローカルの Redis データベースに書き込むことができる新機能が追加されました。その後、他のマイクロゲートウェイ インスタンスをデータベースから構成データを読み取るように構成できます。この機能により、Edge Microgateway に一定の復元力が追加されます。これにより、Microgateway インスタンスは、Apigee Edge と通信することなく起動して機能します。詳しくは、Synchronizer の使用をご覧ください。

  現在、syncrhonizer 機能は Redis 5.0.x でサポートされています。

バージョン 3.0.x

バグの修正と機能強化 v.3.0.x

3.0.10

11 月 8 日（金）、Edge Microgateway に修正と機能強化がリリースされました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.0.10 に関連する個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

• 142677575 - 「/」、「/*」、「/**」のリソースパスの動作の構成で説明されているように、Edge Microgateway の API プロダクトで使用されるリソースパスのパターン マッチングが Apigee Edge で使用されるリソースパス パターンのマッチングと一致するように機能を更新しました。

  注: /*/2/** のような複合リソース パターンを使用する場合は、edgemicro_auth プロキシがスタンドアロン API プロダクトに追加されている必要があります。次に、次のスクリーンショットに示すように、そのプロダクトをプロキシのデベロッパー アプリに含める必要があります。

  

  注: 「/」、「/*」、「/**」のリソースパスの動作の構成で説明されているように、features.isSingleForwardSlashBlockingEnabled 構成プロパティは Edge Microgateway ではサポートされていません。

• 143740696 - quotas 構成の構造が変更されました（バージョン 3.0.9 のリリースノートも参照してください）。quotas プロパティは、Quota プラグインの構成に使用します。構成要素が見やすくなるよう、構造を変更しました。 割り当てプラグインを構成するには、次の 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 プロキシによって生成されたトークンのデフォルトの有効期限を 108,000 ミリ秒（1.8 分）から 1,800 秒（30 分）に変更しました。
• 143551282 - SAML 対応の組織をサポートするために、edgemicro genkeys コマンドが ‑‑token パラメータを含むように更新されました。このパラメータを使用すると、ユーザー名/パスワードの代わりに OAuth トークンを認証に使用できます。 詳しくは、 鍵の生成をご覧ください。

3.0.9

Google は 10 月 11 日（金）、Edge Microgateway に修正と機能強化をリリースしました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.0.9 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

• 141989374 - Quota プラグインに新しい「フェイル オープン」機能が追加されました。この機能を有効にすると、割り当て処理エラーが発生した場合、または Edge に対する「割り当て適用」リクエストがリモート割り当てカウンタの更新に失敗した場合、リモート 割り当てが次に成功するまで、割り当てはローカル数に基づいて処理されます。どちらの場合も、リクエスト オブジェクトに quota-failed-open フラグが設定されます。

  割り当ての「フェイル オープン」機能を有効にするには、次の構成を設定します。

  quotas :
   failOpen : true

  注: また、OAuth プラグインの fail-open リクエスト オブジェクト フラグの名前も、oauth-failed-open に変更されました。

• 142093764 - 割り当ての超過を防ぐため、edgemicro-auth プロキシの構成が変更されました。割り当てタイプを calendar に変更することになっています。この改善を利用するには、edgemicro-auth をバージョン 3.0.7 以降に更新する必要があります。
• 142520568 - 割り当てレスポンスに MP（Message Processor）ID をロギングする新機能が追加されました。この機能を使用するには、edgemicro-auth プロキシをバージョン 3.0.7 以降に更新し、次の構成を設定する必要があります。

  quotas:
    useDebugMpId: true

  useDebugMpId が設定されている場合、Edge からの割り当てレスポンスに MP ID が含まれ、Edge Microgateway によって記録されます。次に例を示します。

  {
      "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 に関連する個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

• 140025210 - 新しい「フェイル オープン」機能が追加されました。この機能により、edgemicro-auth プロキシへの API キー検証呼び出しを妨げる接続エラーが原因で、期限切れ JWT トークンを更新できない場合に、API 処理を続行できます。

  この機能を使用すると、古いトークンがキャッシュに残り、猶予期間が終了するまで再利用される猶予期間を設定できます。この機能により、一時的な接続障害が発生した場合でも、Edge Microgateway がリクエストの処理を続行できます。接続が再開され、Verify API Key 呼び出しが成功すると、新しい JWT が取得され、キャッシュ内の古い JWT が置き換えられます。

  この機能を使用するには、Verify API Key 呼び出しが少なくとも 1 回成功する必要があります。

  新しい「フェイル オープン」機能を構成する手順は次のとおりです。

  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 プロキシが更新され、Edge API キーとシークレットがすべての Verify API Key リクエストで検証されるようになります。Edge Microgateway が更新され、Verify API Key リクエストごとに鍵とシークレットが常に送信されるようになりました。この変更により、クライアントは API キーのみを使用して JWT を取得できなくなります。
• 140090250 - 割り当て処理の診断ロギングを追加するように更新。この変更により、quote のログ出力を他の Edge Microgateway のログに関連付けることができます。

3.0.7

9 月 12 日（木）、Edge Microgateway に修正と機能強化がリリースされました。

コンポーネントのバージョン:

次の表に、Edge Microgateway 3.0.7 に関連付けられている個々のコンポーネント プロジェクトのバージョン番号を示します。各コンポーネントは別々のプロジェクトであるため、リリース番号はメインのプロダクト バージョンと一致しない場合があります。

バグの修正と機能強化。

• 140075602 - 必要に応じて 5xx ステータス コードを返すように OAuth プラグインを更新。以前は、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 プロキシを介して割り当てを管理する場合は、この構成プロパティを設定します。このプロパティが設定されていない場合、内部エンドポイントのエンドポイントはデフォルトで割り当てになります。次に例を示します。

  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」が削除されました。割り当てエンドポイントはお客様の組織内にあるため、割り当て ID は不要になりました。
• 140823165 - 次のプロパティ名。

  edgemicro:
      keepAliveTimeout

  リリース 3.0.6 で誤ったドキュメントがあった。正しいプロパティ名は次のとおりです。

  edgemicro:
      keep_alive_timeout

• 139526406 - デベロッパー アプリに複数のプロダクトがある場合に誤った割り当てカウントが発生するバグを修正しました。複数のプロダクトがあるアプリのプロダクトごとに割り当てが正しく適用されるようになりました。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 - cert、verify、upgradekvm、token、genkeys、取り消しキー、rotatekey、configure の CLI コマンド用に、JWT 鍵とシークレット関連のログメッセージを改善しました。

• 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 リクエストの場合）。
  • エラー メッセージ。
  • エラーコード - オブジェクトにエラーコードが含まれている場合、オブジェクトに出力されます。
  • 所要時間。
  • オペレーティング システムの 行末マーカー。

  プロパティ値が 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 日の commit をご覧ください。コード品質が変更されたすべてのモジュールは、お客様のユースケースで 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 - tokenCacheSize が OAuth プラグインで使用されない
• 134947757 - OAuth プラグインで cacheTTL を設定する
• 135445171 - OAuth で猶予期間が正しく計算されない
• Edge Microgateway インストールに付属の Memeld モジュールを使用する
• 135367906 - セキュリティ監査

バージョン 2.5.x

新機能と機能強化 v.2.5.x

（2019 年 6 月 7 日修正 2.5.38）

JWT の形式が正しくない場合、トークン キャッシュの使用時にワーカーがクラッシュする可能性があります。Edge microgateway-plugins モジュールで修正されました。（b/134672029）

（2.5.37 で追加）CLI オプション edgemicro-cert -t を追加しました。

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

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

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

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

edgemicro forever -a stop

edgemicro forever ~/mydir/forever.json

edgemicro configure -x /mypath …

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

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

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

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

edgemicro:
    request_timeout: 10

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

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

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

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

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

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

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

npm install -g edgemicro

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

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

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

edgemicro:
    config_change_poll_interval: [seconds]

edgemicro --version

edgemicro:
  logging:
    to_console: true  

npm install -g edgemicro