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

現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください
情報

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

リリースの概要

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

新機能

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

○ Edge UI の一般提供(GA)リリース
○ Edge UI での Monetization の一般提供(GA)リリース
apigee-monit に自己修復およびモニタリング サービスを追加
○ Edge UI に新しい TLS 構成プロパティを追加
○ Edge UI で仮想ホストを作成、編集、削除できるようになりました
○ OpenAPI v3 のサポートが追加され、
○ Enterprise Linux(RHEL)が Oracle でサポートされます。

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

含まれるリリース

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

○ Edge:
   18.06.08
   18.06.06
   18.05.21
   18.05.10
   18.05.09
   18.04.23.00
○ ポータル:
   18.11.28.00
   18.10.17.00
   18.10.09.00
   18.07.16.00
廃止 なし
サポートの終了 Apigee Edge for Private Cloud バージョン 4.17.09 はサポートを終了しました(非推奨)。

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

バグの修正

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

○ Zookeeper がバックアップ スクリプトによって停止されていない ○ 4 ○ 7 ○ 4 ○ 7 パスワード再設定用の Zookeeper の停止(122694069)
○ '該当組織のランディング ページ追加なし(120993451)
○ カスタム レポートの削除(120682369)
○ 新しい Edge エクスペリエンスでの Geomap タブの生成(120681592)






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

既知の問題

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











apigee-monitHEAD

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

アップグレード パス

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

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

新しい機能と特長

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

このリリースでは、以下の機能強化に加えて、ユーザビリティ、パフォーマンス、セキュリティ、安定性に関する複数の改善が行われました。

Edge UI の一般提供(GA)リリース

Apigee Edge UI は最新の管理 UI サービスです。以前はベータ版でした。Apigee Edge for Private Cloud v4.19.01 では、Edge UI が一般リリースに含まれています。

Edge UI を使用するには、SAML を有効にしてから、独自のノードに Edge UI をインストールする必要があります。

詳細については、Private Cloud 用の Edge UI をご覧ください。

Edge UI での Monetization の一般提供(GA)リリース

New Edge エクスペリエンス UI での Monetization の一般提供が開始されました。

Apigee Edge for Private Cloud のすべての収益化タスクが、New Edge エクスペリエンス UI で管理できるようになりました。たとえば、次のタスクを実行できます。

この発表により、Monetization 差異レポートは正式に非推奨になりました。 Apigee の非推奨をご覧ください。

apigee-monit は自己修復とモニタリングのサービスを追加する

Apigee Edge for Private Cloud に apigee-monit というオープンソースの monit ユーティリティをベースにしたツールが追加されました。apigee-monit は定期的に Edge サービスをポーリングします。サービスが利用できない場合、apigee-monit はそのサービスの再起動を試みます。

apigee-monit のインストール、構成、使用については、apigee-monit による自己回復をご覧ください。

新しい TLS 構成プロパティ

Edge UI では、次の設定に使用できる新しい TLS 構成プロパティがサポートされています。

  • デフォルトの TLS プロトコル
  • サポートされている TLS プロトコルのリスト
  • サポートされている TLS アルゴリズム
  • サポートされている TLS 暗号

詳細については、オプションの TLS プロパティの設定をご覧ください。

Edge UI での仮想ホストの作成、編集、削除

セルフサービス機能が拡張され、ブラウザで仮想ホストを作成、編集、削除できるようになりました(Edge UI のみ)。

詳細については、ブラウザを使用して仮想ホストを作成するをご覧ください。

OpenAPI v3 サポートの追加

このリリースでは、OpenAPI バージョン 3(Edge UI のみ)を介したプロキシ作成のサポートが追加されました。

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

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

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

このリリースでは、次のプラットフォームのサポートが追加されました。

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

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

  • RHEL/CentOS/Oracle バージョン 7.3
  • RHEL/CentOS バージョン 6.8
  • Oracle Linux 6.7

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

バグの修正

このセクションでは、このリリースで修正された Private Cloud のバグを示します。さらに、このリリースには、含まれるリリースに示されている Edge UI、Edge 管理、ポータル リリースのバグがすべて修正されています。

問題 ID 説明
122694069

バックアップ スクリプトによって Zookeeper が停止しない

この修正前は、バックアップ スクリプトによって Zookeeper プロセスが停止していませんでした。
120993451

「組織がありません」のランディング ページが追加されていません

組織が関連付けられていないユーザーとしてログインしたデベロッパーが、存在しないページに誘導されることはなくなりました。これらのユーザー向けに新しいランディング ページが追加されました。
120682369

カスタム レポートの削除

New Edge エクスペリエンスではカスタム レポートを削除できません。
120681592

New Edge エクスペリエンスの [Geomap] タブ

New Edge エクスペリエンスで [Geomap] タブを開くと、New Edge エクスペリエンスでエラーがスローされていました。
120624977

Zookeeper JVM オプション

Zookeeper の構成で Code を使用して JVM オプションを設定しても機能しませんでした。
80187407

ツールチップで未定義のエラーが発生しました

グラフに時系列が 1 つしかない場合、ツールチップには未定義のエラーがスローされていました。
79949124

OpenAPI を介したリバース プロキシの作成

プロキシの作成時に [Use OpenAPI] ボタンが機能しない。
77515655

パスワードを再設定してもリンクが送信されない

パスワード再設定用のリンクをリクエストしたときに、ユーザーにメールが届きませんでした。
72799769

パスワードの再設定用リンクのヘッダーが正しくない

ユーザーが trustxforwarded プロパティを true に設定しても、結果のリクエスト ヘッダーでは HTTPS が使用されていません。
69550284

WSDL を使用した API プロキシの作成

WSDL の使用時に API プロキシの生成が失敗していました。

既知の問題

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

問題 ID 説明
135616498

apigee-sso インストールのメタデータ ファイル形式

apigee-sso をインストールし、URL の代わりに metadata.xml ファイルを使用する場合、metadata.xml ファイルの最後に新しい行(CRLF)が含まれていないと、metadata.xml ファイル全体が読み取られません。

回避策:

この問題を回避するには、次のいずれかを行います。

  • metadata.xml ファイルの末尾に CRLF を追加します。

    または

  • メタデータに URL ベースの場所を使用する
122370980

apigee-monit は Amazon Linux 1 ではサポートされていません

回避策:

なし
121095148

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

回避策:

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

115278838

セッション トークンが無効になっていない

ユーザーが [Apigee Edge ログアウト] ボタンをクリックしても、サーバーでセッション トークンは無効になりません。

回避策:

SAML で New Edge エクスペリエンスを使用する。

113342838

JMX 認証が有効になっている場合に Cassandra オペレーションが機能しない

回避策:

nodetool コマンドを呼び出すたびに、ユーザー名とパスワードを追加します。

79993247

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

Node.js ターゲットに対する HEAD リクエストはハングし、接続が保留状態になる可能性があります。

回避策:

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

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 ノードに接続しようとしているため、起動しない可能性があります。DataAccessExceptions は、Cassandra ノードが停止した場合に発生します。これにより、API トラフィックが中断することも考えられます。具体的には、KVM を取得しようとしたときに Message Processor から 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_EMAILADMIN_PW は、Apigee アカウントの認証情報です。
    • MS_IPMS_PORT は、Management Server の IP アドレスとポート番号です。
    • REGION は、Management Server が配置されているデータセンターの名前です。
    • GATEWAY_POD は Pod 名です。デフォルトは "gateway" です。ただし、名前が別の名前になっている可能性があるため、実装を確認してください。
    • CASSANDRA_NODE_TYPE は、kms-datastoredc-datastorekeyvaluemap-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-datastoredc-datastorekeyvaluemap-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 クラスタには影響しません。これらのコマンドの詳細については、データストアの登録を更新するをご覧ください。

68722102

ログメッセージ内の追加情報を含む MessageLogging ポリシー

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

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

回避策:

なし
65737520

システム管理者パスワードを再設定できない

特殊文字を含む Management Server のシステム管理者パスワードをリセットすると、失敗します。

回避策:

データファイルにパスワードを定義してから、Management API の /users エンドポイントに渡します。詳しくは、システム管理者パスワードを再設定するをご覧ください。

次のステップ

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

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