4.50.00 Edge for Private Cloud リリースノート

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントに移動します。
情報

このセクションでは、Edge for Private Cloud の機能リリース バージョン 4.50.00 について説明します。

リリースの概要

次の表に、このリリースの変更点をまとめます。

新機能

このリリースには、次の新機能が含まれています。

○ API プロキシで TLS 接続情報が使用可能になりました
○ Zookeeper のアップグレード
○ Drupal 8 ポータルの提供と Drupal 7 のサポート終了

これらの新機能の詳細については、新機能をご覧ください。

下位互換性 このバージョンの Apigee Edge for Private Cloud では、下位互換性に影響する次の問題が導入されました。
     
  • 問題 132443137 の修正(19.03.01 Public Cloud リリースノートを参照)により、Message Processor は X-Apigee-* で始まるヘッダーを無視するようになりました。そのため、X-Apigee-* ヘッダーを使用するコードをリファクタリングし、サポートされているヘッダーに置き換える必要があります。
  • Cassandra ログファイルの名前が変更されました。現在は次のようになっています。

    /opt/apigee/var/log/apigee-cassandra/system.log
含まれるリリース

以前の Edge for Private Cloud 機能リリース以降、次のリリースが行われ、このリリースに含まれています。

○ Edge:
   20.04.06(ランタイム、API 管理、収益化管理)
   20.03.27(UI)
   20.03.16(Edge Analytics)
   20.03.11(UI)
   20.02.27(API モニタリング)
   20.02.24(UI)
   20.02.03(API モニタリング)
   20.01.29(UI)
   20.01.22(UI)
   20.01.06(API 管理/ランタイム)
○ Edge(続き):
   20.01.06(UI)
   19.11.13(API セキュリティ レポート)
   19.10.01(UI)
   19.09.26(Edge UI/Portal)
   19.08.27(UI)
   19.08.15(API セキュリティ レポート)
   19.07.29(UI)
○ ポータル:
   20.05.27.00
   20.04.13.00
   20.03.20.00
   19.12.20.00
   19.11.21.00
   19.09.25.00
廃止された機能 なし
サポートの終了

4.50.00 のリリースでは、次のようになります。

  • 4.18.05: Apigee Edge for Private Cloud バージョン 4.18.05 は非推奨になりました。

このリリースで非推奨になった機能は次のとおりです。

  • Node.js プロキシと Secure Vault のサポート
  • OAuth v1 ポリシーのサポート
  • Concurrent Rate Limit ポリシーのサポート
  • Istio の Apigee アダプタのサポート
  • Teams の早期アクセス機能のサポート

削除スケジュールなど、非推奨の詳細については、Apigee の非推奨、終了、CPS の変更をご覧ください。

バグの修正

このリリースには、次のバグ修正が含まれています。

○ キーストアが類似した名前またはエイリアスで構成されている場合、Message Processor が環境の読み込みに失敗します。(154428338)
○ パッチのインストール中に QPid の依存関係の競合が発生する(152574421)
○ キャッシュ メモリの制限が最大 L1 キャッシュサイズを尊重しない(151449163)
○ バックアップ スクリプトが失敗する(150710952)
○ QPid サーバーが余分なログメッセージを送信する(148231209)
○ Postgresql のバックアップで SSO 情報が保存されない(147458330)
○ apigee-nginx のバージョンがアップグレードされない。(146872858)
○ 「新しい UI を試す」メッセージが表示されなくなった(145419621)
○ Apigee SmartDocs API の脆弱性(145340106)
○ Postgres バックアップ スクリプトが失敗する(145254693)
○ さまざまなセキュリティ修正(142150706)
○ ルーターからメッセージ プロセッサへのタイムアウト率が高い(138107618)
○ SSO 設定スクリプトの失敗(135616498)
○ JMX ポート(132044907)
○ 競合状態によるランタイム トラフィックの断続的な 404(130653816)
○ アップグレード中の OpenLDAP の破損(120799182)
○ 複数のデータセンター構成での DataAccessException(76087166)
○ MessageLogging ポリシーで FormatMessage が false に設定されていると機能しない(68722102)

これらの各修正の詳細については、バグの修正をご覧ください。

既知の問題

このリリースには、次の既知の問題が含まれています。

○ JWT 検証が失敗する(159788170)
○ Mint 評価サーバーのメモリリーク(137865184)
○ Amazon Linux 1 で apigee-monit がサポートされていない(122370980)
○ Message Processor のバックアップで正しいファイルセットがバックアップされない(121095148)
○ アップグレード後にキャッシュミス率が増加する(160109014)
○ 空の本文と Content-Encoding: gzip を含む GET リクエストに対する HTTP 408 レスポンス。(159858015)

回避策など、これらの既知の問題の詳細については、既知の問題をご覧ください。

アップグレード パス

次の表に、このリリースのアップグレード パスを示します。

4.19.01 または 4.19.06 から 4.19.01/4.19.06 → 4.50.00 に直接アップグレード
4.18.05 から 4.18.05 → 4.50.00 に直接アップグレード

新機能

このセクションでは、このリリースの新機能について説明します。また、このリリースには、含まれるリリースに記載されている Edge UI、Edge Management、Portal のリリースに含まれるすべての機能が含まれています。

このリリースには、次の機能強化に加えて、ユーザビリティ、パフォーマンス、セキュリティ、安定性の強化も含まれています。

API プロキシで TLS 接続情報を使用できるようになりました

Edge には、TLS をサポートする仮想ホストを介して API プロキシへのリクエストを処理する際に TLS 接続に関する情報をキャプチャする機能があります。この情報には API プロキシからフロー変数を通じてアクセスできるので、これを基に追加の分析や検証を行うことができます。詳細については、API プロキシでの TLS 接続情報へのアクセスをご覧ください。

Zookeeper のアップグレード

このリリースには Zookeeper 3.4.14 が含まれています。

Drupal 8 ポータルの提供と Drupal 7 のサポート終了

Drupal 8 は、Apigee が推奨する Private Cloud 用デベロッパー ポータルとして Drupal 7 を継承しています。Drupal 7 自体が 2021 年 11 月に長期サポートを終了するため、Drupal 7 用の Apigee モジュールは 2021 年 11 月以降サポートされません。Drupal 7 のインストール/アップグレード スクリプトはまだ使用できますが、今後使用しないでください。今後のリリースで削除される予定です。

Apigee と統合する Drupal 8 モジュールについては、Drupal 8 を使用したポータルの構築をご覧ください。

サポートされるソフトウェア

このリリースには、サポートされているソフトウェアに対する次の変更が含まれています。

サポートが追加されました サポート終了

今回のリリースでは、次のプラットフォームのサポートを追加しました。

  • Red Hat Enterprise Linux(RHEL)7.8
  • CentOS 7.8
  • Oracle Linux 7.8

このリリースでは、次のプラットフォームのサポートが終了しました。

  • Red Hat Enterprise Linux(RHEL)6.10
  • CentOS 6.10
  • Oracle Linux 6.9

サポートされているプラットフォームの完全なリストについては、サポートされているソフトウェアとそのバージョンをご覧ください。

バグの修正

このセクションでは、このリリースで修正された Private Cloud のバグの一覧を示します。また、このリリースには、含まれるリリースに示されている Edge UI、Edge Management、Portal のリリースに含まれるすべてのバグ修正が含まれています。

問題 ID 説明
154428338

キーストアが類似した名前またはエイリアスで構成されている場合、Message Processor が環境を読み込めない。

類似した命名規則を持つキーストアを読み込む際の正規表現ルックアップの競合を修正しました。これにより、Message Processor がキーストアに関連付けられた環境を読み込めない、またはルックアップ中に複数の競合するキーストアが返された場合に起動できないという問題が発生していました。
152574421

パッチのインストール中に QPid の依存関係の競合が発生する

これで、正しいバージョンの QPid がインストールされました。
151449163

キャッシュ メモリの上限が L1 キャッシュの最大サイズを尊重していない

キャッシュ メモリの上限が最大 L1 キャッシュ サイズを尊重するようになりました。
150710952

バックアップ スクリプトが失敗する

バックアップ スクリプトの更新に基づいて、バックアップ手順を更新しました。
148231209

QPid サーバーが余分なログメッセージを送信する

QPid サーバーが余分なログ メッセージを送信しなくなりました。
147458330

Postgresql のバックアップに SSO 情報が保存されない

Postgresql バックアップで SSO 情報が保存されるようになりました。
146872858

apigee-nginx のバージョンがアップグレードされていません。

apigee-nginx のバージョンが正しくアップグレードされるようになりました。
145419621

「新しい UI を試す」メッセージが表示されなくなった

UI に「新しい UI を試す」というメッセージが表示されなくなります。
145340106

Apigee SmartDocs API の脆弱性

セキュリティの脆弱性に対処するため、Apigee SmartDocs プロキシを更新しました。詳細と必要な手順については、SmartDocs のインストール手順をご覧ください。
145254693

Postgres バックアップ スクリプトが失敗する

Postgres バックアップ スクリプトが正しく動作するようになりました。
142150706

さまざまなセキュリティ上の修正

#111390246 を含むセキュリティの問題の修正。
138107618

Router から Message Processor へのタイムアウト率が高い

この問題は解決済みです。
135616498

SSO 設定スクリプトの失敗

ファイル スキーム URL を使用すると SSO 設定スクリプトが失敗する問題を修正しました。
132044907

JMX ポート

JMX ポートは、外部アクセスに対して開くべきではありません。内部サーバーに対してのみ開くべきです。
130653816

競合状態によりランタイム トラフィックで 404 が断続的に発生する

MP ブートストラップ中の競合状態を修正しました。これにより、一部のプロキシが正しくデプロイされないことがなくなります。
120799182

アップグレード中の OpenLDAP の破損

この問題は解決済みです。
76087166

複数のデータセンター構成での DataAccessException

複数のデータセンター構成では、1 つのデータストアが使用できなくなっても、DataAccessException エラーは表示されなくなります。
68722102

MessageLogging ポリシーで FormatMessage が false に設定されている場合、機能しない

MessageLogging ポリシーで FormatMessage を false に設定できるようになりました。

既知の問題

次の表に、このリリースの既知の問題を示します。

問題 ID 説明
159788170

JWT 検証が失敗する

2,048 ビット未満の RSA 鍵の場合、JWT 検証が失敗します。

回避策:

鍵が 2,048 ビット以上であることを確認します。
137865184

Mint 評価サーバーのメモリリーク

新しい Qpid インスタンスが mxgroup に登録されると、コンシューマーなしでキューが構築され、使用可能なすべてのリソースが使用されるまでキューの深さが増加します。

回避策:

なし。
122370980

Amazon Linux 1 で apigee-monit がサポートされていない

回避策:

なし。
121095148

Message Processor のバックアップで正しいファイルセットがバックアップされない

回避策:

バックアップをもう一度実行すると、正しいファイルのセットがバックアップされます。

160109014

アップグレード後にキャッシュミス率が増加した

リリース 4.50.00 にアップグレードすると、プロキシのキャッシュミス率が増加する可能性があります。これらのミスは、次のような MP ログのエラー メッセージの増加を伴う場合があります。

InvalidClassException when fetching cps cache entry from second level - com.apigee.jsonparser.LinkedJSONObject; local class incompatible: stream classdesc serialVersionUID = -8575741446425131573, local class serialVersionUID = 752634431212433936. Considering it as cache miss.

回避策:

なし。キャッシュ ヒット率は時間の経過とともに安定することが予想されます。

159858015

本文が空で Content-Encoding: gzip の GET リクエストに対する HTTP 408 レスポンス。

API クライアントがヘッダー Content-Encoding: gzip と空のリクエスト本文を含む GET リクエストを行うと、408 タイムアウト レスポンスが返されます。

回避策:

空の本文で GET リクエストを行う場合は、Content-Encoding ヘッダーを省略します。

次のステップ

Edge for Private Cloud 4.50.00 の使用を開始するには、次のリンクを使用します。

新規インストール:
新規インストールの概要
既存のインストール:
アップグレードパス