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

ここに表示されているのは Apigee Edge のドキュメントです。
Go to the Apigee X のドキュメントに移動します。 info

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

リリースの概要

次の表に、この機能リリースでの変更の概要を示します。

新機能 ○ JWT ポリシーが一般提供（GA）になりました
○ RedHat Enterprise Linux 6.9 がサポートされるようになりました
○ Oracle Linux 6.9 がサポートされるようになりました
○ CentOS 6.9 がサポートされるようになりました
○ New Edge エクスペリエンスのインストール構成の変更
○ ルーターの再試行オプションを仮想ホスト レベルで設定できるようになりました
含まれるリリース
○ Edge UI:
   18.04.04
   18.03.02
   18.02.14
   17.11.06 		○ Edge Management/ランタイム:
   18.04.06
   18.04.04
   18.03.02
   18.02.02
   18.01.05
 ○ ポータル:
   18.04.25.01
   18.04.25.00
   18.04.23.00
   18.03.28.00
   18.03.05.00
   18.02.15.00
   18.01.31.00
   17.12.20.00
廃止された機能 ○ API BaaS
○ モニタリング ダッシュボード（ベータ版）
サポートの終了 ○ Apigee セキュアストア（Vault）が KVM に置き換えられました
○ API プロキシの [Performance] タブにパスを追加する
○ Developer Services ポータルの SMTPSSL プロパティ
バグの修正 ○ ユーザーのメールアドレスが変更されないようにする（65550638）
○ jackson-databind のセキュリティの脆弱性（69711616）
○ Message Processor のメモリリーク（71612599）
既知の問題

このリリースには、次の既知の問題があります。

○ Message Processor のバックアップで正しいファイルセットがバックアップされない（121095148）
○ HEAD Node.js ターゲットへのリクエストがハングする（79993247）
○ [Create reverse proxy via Open API] オプションが表示される（79949124）
○ ホスト名が解決されない（79757554）
○ 複数のデータセンター構成で DataAccessExceptions が発生する（76087166）
○ apigee-postgresql の停止時に権限エラー メッセージが表示される（72379834）
○ MessageLogging ポリシーでログメッセージに余分な情報が含まれる（68722102）

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

以降のセクションでは、これらのトピックについて詳しく説明します。

アップグレード パス

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

4.18.01 から 4.18.01 → 4.18.05 から直接アップグレードする
4.17.09 から 4.17.09 → 4.18.05 から直接アップグレードする
4.17.05 から 4.17.05 → 4.18.05 から直接アップグレードする
4.17.01 から 4.17.01 → 4.18.01 にアップグレード してから、4.18.01 → 4.18.05 にアップグレードする
4.16.09 から 4.16.09 → 4.18.01 にアップグレードしてから 4.18.01 → 4.18.05 にアップグレードする
4.16.05 から 4.16.05 → 4.18.01 にアップグレード してから、4.18.01 → 4.18.05 にアップグレードする
4.16.01 から 4.16.01 → 4.18.01 にアップグレードしてから、 4.18.01 → 4.18.05 にアップグレードする
4.15.0x から 4.15.0x → 4.16.01 にアップグレードしてから、 4.16.01 → 4.18.01 にアップグレードし、 4.18.01 → 4.18.05 にアップグレードする

新機能

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

このリリースには、次の機能強化に加えて、使いやすさ、 パフォーマンス、セキュリティ、安定性に関する複数の機能強化も含まれています。

JWT ポリシー

次の JWT ポリシー はベータ版ではなくなり、一般提供になりました。

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

この機能リリースでは、サポートされているソフトウェアに次の変更が加えられています。

  • Red Hat Enterprise Linux（RHEL）6.9 がサポートされるようになりました
  • Oracle Linux 6.9 がサポートされるようになりました
  • CentOS 6.9 がサポートされるようになりました
  • RHEL/CentOS/Oracle Linux 7.2 はサポートされなくなりました

詳細については、 サポートされているソフトウェアとサポートされているバージョンをご覧ください。

New Edge エクスペリエンスのインストール構成の変更

New Edge エクスペリエンスの 4.18.05 リリースでは、 4.18.01 リリースから構成ファイルが変更されています。新しいプロパティについては、 Edge 4.18.01 からのインストール構成の変更をご覧ください。

ルーターの再試行オプションを仮想ホスト レベルで設定できるようになりました

ルーターと Message Processor の通信の再試行オプションを 仮想ホストで設定できるようになりました。これにより、ルーター レベルでのみ設定可能だった以前のオプションよりも詳細な制御が可能になります。

詳細については、 仮想 ホスト構成プロパティをご覧ください。

新しい分析ディメンションと x_forwarded_for_ip ディメンションの変更

Edge Analytics で Edge が x_forwarded_for_ip ディメンション を設定する方法が変更されました。以前は、X-Forwarded-For ヘッダーに複数の IP アドレスがある場合、x_forwarded_for_ip ディメンションには最後にリストされた IP アドレスのみが含まれていました。お客様は、x_forwarded_for_ip ディメンションを使用して、Edge に API リクエストを行うクライアントの IP アドレスを特定していました。

このリリースでは、x_forwarded_for_ip ディメンションに IP アドレスの完全なリスト が X-Forwarded-For ヘッダーに含まれるようになりました。

警告: X-Forwarded-For ヘッダーは、前回の TCP handshake で受信した IP アドレス Edge となっているヘッダー内の最後のアドレスを除いて、アクセスが拒否された IP によるなりすましを受ける可能性があります。Edge に API リクエストを行う元のクライアント IP アドレスを特定するために、 このリリースでは、Edge Analytics に新しいディメンション ax_resolved_client_ip が追加されています。

カスタム レポートまたはカスタム レポートのフィルタ条件で ax_resolved_client_ip ディメンションを使用して、API リクエストを行うクライアントの IP アドレスを特定できるようになりました。Analytics の指標、ディメンション、フィルタのリファレンス で ax_resolved_client_ip ディメンションの詳細をご覧ください。

この変更は、AccessControl ポリシーが X-Forwarded-For ヘッダーを処理する方法にも影響します。 このリリースでは、Edge は X-Forwarded-For HTTP ヘッダーに 最後 の外部 TCP handshake（クライアント IP やルーターなど）から受信した単一の IP アドレスを自動的に入力します。 以前のリリースでは、Edge は X-Forwarded-For HTTP ヘッダーに 最初の外部 TCP handshake（クライアント IP やルーターなど）から受信した単一の IP アドレスを設定していました。 詳細については、 HTTP ヘッダー X-Forwarded-For についてをご覧ください。

含まれるリリース

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

Edge UI Edge Management/ランタイム ポータル
18.04.04
18.03.02
18.02.14
17.11.06 		18.04.06
18.04.04
18.03.02*
18.02.02
18.01.05
 18.04.25.01
18.04.25.00
18.04.23.00
18.03.28.00
18.03.05.00
18.02.15.00
18.01.31.00
17.12.20.00
* バグの修正 74622499 は、Edge for Private Cloud 4.18.05 リリースには含まれていません。

上記のリンクをクリックすると、この機能リリースに 含まれるこれらのリリースのバグの修正と新機能が表示されます。

廃止された機能

このセクションでは、この機能リリースで廃止された機能について説明します。

API BaaS

API BaaS は廃止されました。詳細については、 Apigee の非推奨、終了、CPS の変更をご覧ください。

モニタリング ダッシュボード（ベータ版）

モニタリング ダッシュボード（ベータ版）は廃止され、サポートされなくなりました。そのため、次のコンポーネントはインストールに含まれなくなりました。

  • apigee-influxdb
  • apigee-telegraf
  • apigee-grafana

ルーター、Message Processor、ノードの指標を引き続き取得するには、Apigee では JMX を使用して Edge for Private Cloud のデータを独自のモニタリング ツールと統合することをおすすめします。詳細については、モニタリング対象とモニタリング方法をご覧ください。

既存のインストールをバージョン 4.18.05 にアップグレードする場合は、モニタリング ダッシュボードをアンインストールする必要があります。Apigee は、引き続き期待どおりに機能することを保証するものではありません。

サポートの終了

この機能リリースでは、次の機能が非推奨になりました。

詳細については、 Apigee の非推奨、終了、CPS の変更をご覧ください。

Apigee セキュアストア（Vault）

Vault とも呼ばれる Apigee セキュアストアは非推奨となり、2018 年 9 月に廃止されます。

セキュアストアを使用する代わりに、 Key-Value マップの操作で説明されているように、暗号化された Key-Value マップ（KVM）を使用します。 暗号化された KVM は Vault と同じくらい安全で、作成と 取得のオプションが豊富です。

API プロキシの [Performance] タブにパスを追加する

このリリースより前は、管理 UI で API プロキシに移動し、 [Performance] タブに移動して、 プロキシの [Performance] タブと [Business Transactions] ダッシュボードでグラフベースの比較を行うためのさまざまなパスを作成できました。

この機能は廃止され、UI で使用できなくなりました。この機能の代替については、 Business Transactions API の代替をご覧ください。

Developer Services ポータルの SMTPSSL プロパティ

ポータルに接続された SMTP サーバーで使用されるプロトコルを設定するには、SMTPSSL プロパティの代わりに SMTP_PROTOCOL プロパティを使用します。`SMTP_PROTOCOL` の有効な値 はSMTP_PROTOCOL、「standard」、「ssl」、「tls」です。

詳細については、 Developer Services ポータルのインストールをご覧ください。

バグの修正

このセクションでは、この機能リリースで修正された Private Cloud のバグについて説明します。この機能リリースには、以下に示すバグに加えて、含まれるリリースに示されている Edge UI、Edge Management、ポータルのリリースに含まれるすべてのバグの修正が含まれています。

問題 ID 説明
71612599

Message Processor のメモリリーク

メモリリークが修正されました。Qpidd が 停止したときに Message Processor で発生していました。
69711616

jackson-databind のセキュリティの脆弱性

逆シリアル化の欠陥を防ぐため、jackson-databind ライブラリがバージョン 2.7.9.1 に更新されました。
65550638

ユーザーのメールアドレスが変更されないようにする

Management API に送信されるメッセージ ペイロードでユーザーのメールアドレスを変更できなくなりました。また、Management API では、リクエスト本文で XML を使用できなくなりました。

既知の問題

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

問題 ID 説明
121095148

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

回避策:

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

Node.js ターゲットへの HEAD リクエストがハングする

Node.js ターゲットへの HEAD リクエストがハングし、接続が保留になることがあります。

回避策:

この問題を回避するには、HEAD リクエストのハンドラを定義して、空のレスポンスを明示的に返すようにします。
79949124

[Create reverse proxy via Open API] オプションが表示される

現在、プロキシ ウィザードには、Open API を介して新しいプロキシを作成するオプションが表示されます。これは、Edge for Private Cloud ではできません。

回避策:

なし。
79757554

ホスト名が解決されない

Edge for Private Cloud をインストールまたはアップグレードした後、ホスト名がアドレスに解決されないことがあります。

回避策:

この問題を解決するには、Edge UI コンポーネントを再起動します。

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
76087166

複数のデータセンター構成で DataAccessException が発生する

複数のデータセンター構成で、1 つのデータストアが使用できなくなると、次のエラーが表示されることがあります。

DataAccessException: Error while accessing datastore;
Please retry later

その結果、Management Server が dc-1 と dc-2 の両方の Cassandra ノードに接続しようとするため、起動しないことがあります。Cassandra ノードがダウンしている場合、DataAccessExceptions が発生します。また、API トラフィックが中断し、Message Processor が KVM の取得を試行中に DataAccessExceptions を報告することもあります。

想定される状態は、Management Server がリージョン間のデータストア コンポーネントに接続しないことです。

回避策

回避策として、使用できないデータセンターで次の Cassandra ノードタイプを登録解除し、Cassandra ノードが再び使用可能になったら再登録します。

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

これらの Cassandra ノードタイプを登録解除して再登録するには:

  1. 次の curl コマンドを使用して、Cassandra ノードの UUID を取得します。 
    curl -u ADMIN_EMAIL:ADMIN_PW \
  "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
  &type=CASSANDRA_NODE_TYPE"

    ここで

    • ADMIN_EMAIL と ADMIN_PW は、Apigee アカウントの認証情報です。
    • MS_IP と MS_PORT は、Management Server の IP アドレスとポート 番号です。
    • REGION は、Management Server が配置されているデータセンターの名前です。
    • GATEWAY_POD はポッド名で、デフォルトは「gateway」です。別の名前に変更している可能性もあるため、 実装を確認してください。
    • CASSANDRA_NODE_TYPE は、kms-datastore、dc-datastore、keyvaluemap-datastore のいずれかです。

    次に例を示します。 

    curl -u nickdanger@google.com:myP@$$w0rD
  "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    レスポンスは次の形式を使用します。 

    {
  "internalIP" : "POD_IP_ADDRESS",
  "isUp" : [true|false],
  "pod" : "GATEWAY_POD",
  "reachable" : [true|false],
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
    "uUID" : "POD_UUID"
}

    次に例を示します。 

    {
  "internalIP" : "192.168.1.11",
  "isUp" : false,
  "pod" : "gateway",
  "reachable" : false,
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : "dc-datastore",
  "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
}

    レスポンスの uUID フィールドの値に注意してください。これらを使用して ノードを登録解除します。

  2. Cassandra ノードタイプ（kms-datastore、 dc-datastore、keyvaluemap-datastore）ごとに手順 1 を繰り返します。返された UUID をメモしておきます。
  3. 次のコマンドを使用してノードを登録解除します。 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    ここで、UUID は前のコマンドのレスポンスで返された UUID です。

  4. 手順 1 と 2 で収集した UUID ごとに手順 3 を繰り返します。
  5. 次のコマンドを使用してノードを再登録します。 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
  "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
  Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
  region=REGION&pod=GATEWAY_POD" -H \
  'content-type: application/x-www-form-urlencoded' -X POST

これらのオペレーションでは、Zookeeper からノードを登録および登録解除しますが、Cassandra クラスタには影響しません。これらのコマンドの詳細については、 データストアの登録を更新するをご覧ください。
72379834

apigee-postgresql の停止時に権限エラー メッセージが表示される

apigee-seriver apigee-postgresql stop コマンドを使用して apigee-postgresql を停止すると、apigee-serive がユーザーのホーム ディレクトリに変更できないというメッセージが表示されることがあります。このメッセージは無視してかまいません。

回避策:

なし
68722102

MessageLogging ポリシーでログメッセージに余分な情報が含まれる

MessageLogging ポリシーの FormatMessage 要素は、ログに記録されるメッセージの形式を制御します。FormatMessage=false の場合、ログに記録されるメッセージに Apigee 生成の情報を含めることはできません。ただし、FormatMessage=false を設定しても、ログメッセージには次の情報が含まれます。

  • 優先度スコア
  • タイムスタンプ

回避策:

なし。

次のステップ

Edge for Private Cloud 4.18.05 を使い始めるには、次のリンクを使用してください。

新規インストール:
新規インストールの概要
既存のインストール:
4.18.01 からアップグレードする
4.17.05 または 4.17.09 からアップグレードする
4.17.01 からアップグレードする
4.16.01 または 4.16.05 からアップグレードする
前へ
4.18.05.01
次へ
4.18.01.02