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 のサポートを追加しました

RedHat Enterprise Linux で RHEL がサポートされるようになりました。

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

含まれるリリース

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

○ Edge:
   18.06.08
   18.06.06
   18.05.21
   18.05.10
   18.05.09
   28.04
○ ポータル:
   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 の変更をご覧ください。

バグの修正

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











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

既知の問題

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

apigee-sso5 の 5 メタデータ ファイル形式





















0apigee-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 Management、およびポータルのリリースのすべての機能が含まれています。

このリリースでは、以下の機能に加え、複数のユーザビリティ、パフォーマンス、セキュリティ、安定性も追加されています。

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)

新しい Edge エクスペリエンス UI での収益化の一般提供を開始しました。

New Edge エクスペリエンス UI では、Apigee Edge for Private Cloud のすべての収益化タスクを管理できるようになりました。これには次の内容が含まれます。

今回の発表で、収益化の差異レポートのサポートが終了しました。Apigee の非推奨をご覧ください。

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

Apigee Edge for Private Cloud には、オープンソースの monit ユーティリティをベースとした apigee-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 Management、およびポータルのすべてのバグ修正が含まれています。

問題 ID 説明
122694069

Zookeeper がバックアップ スクリプトで停止しなかった

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

「組織なし」のランディング ページが追加されました

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

カスタム レポートの削除

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

新しい Edge エクスペリエンスの [マップ] タブ

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

Zookeeper JVM オプション

Zookeeper の構成ファイルを使用して 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 トラフィックが中断され、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_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 の使用を開始するには、次のリンクを使用します。

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