4.16.01 - Edge for Private Cloud リリースノート

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

2016 年 3 月 24 日(木)、Apigee Edge for Private Cloud の新しいバージョンをリリースしました。

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

特定のクラウド リリースが Edge for Private Cloud のバージョンに含まれているかどうかを確認する方法については、リリース番号についてをご覧ください。

サポートの終了

Private Cloud 4.15.07.03

API 説明
QPID キューのチェック API を使用した QPID キューの確認ができなくなりました
次の CURL コマンドを発行しても、QPID サーバーで作成されたキューは確認できなくなりました。
curl http:// <qpid_IP>:8083/v1/servers/self/queues
この API は非推奨になりました。

アナリティクス: 複数のレポートのカスタム レポート ダッシュボード ビュー(Cloud 15.09.30)

最大 4 つのカスタム レポートを表示できる特定のカスタム レポート ダッシュボード機能は非推奨となったため、今後のリリースで削除される予定です。(MGMT-2673)。カスタム レポートのその他の要素はすべて引き続き使用できます。

Private Cloud で組織名の長さをオーバーライドできません

次の設定により、組織名の 20 文字をオーバーライドできなくなりました。

  • APIGEE_ORG_NAME_LENGTH=25
    
  • APIGEE_ENV_NAME_LENGTH=25
    

新機能と拡張機能

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

プライベート クラウド

RedHat、CentOS、Oracle 6.7 ~ 7.2 をサポート

このリリースでは、RedHat Enterprise Linux、CentOS、Oracle Linux バージョン 6.7 ~ 7.2 のサポートが追加されました。

システム要件の全一覧については、サポート対象のソフトウェアとバージョンをご覧ください。

RPM ベースのインストール

Edge の今回のリリースでは、RPM ベースのインストール メカニズムを使用しているため、インストールと移行の手順が大幅に簡素化されています。

新しいベース ディレクトリ

Edge 4.16.01 ではディレクトリ構造が変更されました。以前の Edge リリースでは、Edge はベース ディレクトリにインストールされていました。

/<install-dir>/apigee4

install-dir は任意の場所に置くことができます(デフォルト値は /opt)。例:

/opt/apigee4

バージョン 4.16.01 の場合、Edge を次のディレクトリにインストールする必要があります。

/opt/apigee

また、apigee4 ディレクトリが apigee に変更されています。

データ ディレクトリの場所は影響を受けません。このディレクトリは、/opt/apigee に置くことも、他の場所に置くこともできます。

仮想ホストの新しい要件

Edge 移行スクリプトは、既存の Netty Router を Nginx に移行するために必要なほとんどのタスクを処理します。ただし、アップグレードの一環として、移行前にすべての仮想ホストの定義にホスト エイリアスが含まれていることを確認する必要があります。

既存の仮想ホストにホスト エイリアスを追加する方法の詳細については、Edge のインストール ガイド (Apigee の ftp サイト ftp://ftp.apigee.com/)をご覧ください。

コード構成

Edge バージョン 4.16.01 では、/<install-dir>/apigee4/conf ディレクトリの .properties ファイルを使用して Edge コンポーネントを構成することはなくなりました。4.16.01 では、.properties ファイルを使用して Edge コンポーネントを構成しますが、次のディレクトリに配置されます。

/opt/apigee/customer/application

ノードにインストールされた Edge コンポーネントごとに、そのディレクトリに .properties ファイルがあります。コンポーネントを構成するには、対応する .properties ファイルを編集して、既存のプロパティの値を変更するか、新しいプロパティと値を追加します。ファイルがまだ存在しない場合は、作成できます。

以前のバージョンの Edge とは異なり、Edge 4.16.01 の .properties ファイルには、コンポーネントのすべてのプロパティが含まれているわけではありません。このリリースでの変更点の一つは、.properties ファイルにはデフォルトのプロパティ値のオーバーライドのみが含まれることです。

このアーキテクチャのメリットは、新しいバージョンの Edge に移行する際に、Edge インストーラによって /opt/apigee/customer/application 内のファイルが上書きされることです。これにより、Edge が意図せず設定を上書きしてしまう事態を回避できます。

移行時に、Edge インストーラは既存の .properties ファイルを調べ、デフォルト プロパティ値への変更を /opt/apigee/token ディレクトリにコピーします。そのため、移行後に編集を行う必要はありません。

詳細については、Apigee の ftp サイト ftp://ftp.apigee.com/ で入手可能な Apigee Edge 運用ガイドをご覧ください。

Edge 構成スクリプトが置き換えられました

Edge の以前のリリースで使用されていた構成スクリプトは削除され、次のいずれかに置き換えられました。

  • apigee-service、apigee-all、apigee-setup、apiee-provision、apigee-migrate などの Apigee ユーティリティから実行するコマンド。
    たとえば、all-start.sh スクリプトと all-stop.sh スクリプトは、次のコマンドに置き換えられました。
    > /opt/apigee/apigee-service/bin/apigee-all start
    > /opt/apigee/apigee-service/bin/apigee-allstop
  • Edge コンポーネントで直接実行するコマンド。たとえば、以前のリリースでは、OpenLDAP パスワードを変更するために chpasswd-openldap.sh スクリプトを使用していました。このスクリプトは、apigee-openldap コンポーネントで実行する次のコマンドに置き換えられています。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword

コマンドで構成を実行する方法の詳細については、Apigee Edge の運用ガイド(Apigee の ftp サイト ftp://ftp.apigee.com/ で入手可能)をご覧ください。

新しいエッジルーター

Edge for Private Cloud のこのリリースには、Nginx Router をベースとした新しいルーター アーキテクチャが含まれています。Nginx Router は、4.16.01 より前の Edge リリースで使用されていた Netty Router に代わるものです。

Nginx Router のハードウェアとポートの要件は Netty Router と同じであるため、既存のノードを変更する必要はありません。

詳細については、Apigee の ftp サイト ftp://ftp.apigee.com/ で入手可能な Edge インストール ガイド の「付録 A: Nginx Router について」をご覧ください。

BaaS ロードバランサを削除しました

内部ロードバランサは API BaaS ポータルから削除されました。API BaaS ポータルと 3 つの API BaaS Stack ノードの間では、独自のロードバランサを使用する必要があります。

ロードバランサの代わりに、ラウンドロビン DNS を使用することもできます。このシナリオでは、BaaS スタック IP アドレスに対応する複数の A レコードを持つ DNS エントリを作成します。DNS ルックアップ中に、DNS サーバーはラウンドロビン方式で A レコード値を自動的に返します。

Cassandra ノードと ZooKeeper ノードを追加する方法、および既存のデータセンターにデータセンターを追加する方法を説明する新しいドキュメント

Apigee の ftp サイトのドキュメントの ZIP ファイルに、Cassandra ノードと ZooKeeper ノードを追加する方法と、既存のデータセンターにデータセンターを追加する方法を説明する「Edge for Private Cloud のスケーリング」が追加されました。

Orgtool の削除

orgtool では、Edge インストールに対してクエリを実行し、組織に関する情報を取得できます。このツールは削除されました。これで、Edge UI または API 呼び出しを使用して組織に関する情報を取得できます。

4.16.01 でタスクを実行する方法

次の表は、4.15.07.03 でタスクを実行した方法と 4.16.01 でタスクを実行する方法を示しています。詳細については、Apigee の ftp サイト ftp://ftp.apigee.com/ で入手できる Edge 運用ガイドをご覧ください。

タスク 4.15.07.0x 4.16.01

インストール ディレクトリ

/<inst_dir>/apigee4 /opt/apigee

ログ ディレクトリ

/<inst_dir>/apigee4/var/log /opt/apigee/var/log/comp

コンポーネントをインストール

/<inst_root>/apigee4/share/installer/apigee-setup.sh -p comp -f configFile

/opt/apigee/apigee-setup/bin/setup.sh -p コンポーネント -f configFile

すべての開始、停止、再起動、ステータス、バージョン

/<inst_root>/apigee4/bin/all-start.sh
/<inst_root>/apigee4/bin/all-stop.sh
/<inst_root>/apigee4/bin/all-status.sh
/<inst_root>/apigee4/bin/check.sh

/<inst_root>/apigee/apigee-service/bin/apigee-all start|stop|restart|status|version

Comp 開始、停止、再起動、ステータス、バージョン

/<inst_root>/apigee4/bin/apigee-service comp start|stop|restart|status

/<inst_root>/apigee/apigee-service/bin/apigee-service comp start|stop|restart|status|version

バックアップ / 復元

/<inst_root>/apigee4/bin/backup.sh
/<inst_root>/apigee4/bin/restore-comp.sh

/<inst_root>/apigee/apigee-service/bin/apigee-servicecomp バックアップ

/<inst_root>/apigee/apigee-service/bin/apigee-service comp restore

インストールをテスト

/<inst_root>/apigee4/test/test-sa.sh

  1. /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  2. /opt/apigee/apigee-service/bin/apigee-service apigee-validate のセットアップ

オンボーディング

/<inst_root>/apigee4/bin/setup-org.sh

  1. /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFileconfigFile

組織、環境、仮想ホストをワンステップで追加

/<inst_root>/apigee4/bin/setup-org.sh

/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

組織を追加

/<inst_root>/apigee4/bin/create-org.sh

/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision create-org -f configFile

環境を追加

/<inst_root>/apigee4/bin/add-env.sh

/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision add-env -f configFile

ユーザーを追加

API 呼び出し

API 呼び出しまたは

/<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision create-user -f configFile

移行

/<install_root>/apigee4/share/installer/apigee-upgrade.sh -c comp

  1. /opt/apigee/apigee-service/bin/apigee-service apigee-migrate install
  2. /opt/apigee/apigee-migrate/bin/migrate.sh -c cs,zk -f configFileconfigFile

モニタリング ツールとダッシュボードのアルファ版リリース

このリリースには、Edge 用の新しいモニタリング ツールとダッシュボードのアルファ版が含まれています。このツールを使用すると、さまざまなコンポーネント(Router、Message Processor、ZooKeeper、Cassandra)の状態に加え、デプロイ内のさまざまな組織や環境の HTTP エラーコードを把握できます。ダッシュボード データのスナップショットを作成し、Apigee と共有して、サポート インシデントの解決に役立てることもできます。

インストール手順を含むドキュメントは、Apigee の ftp サイト(ftp://ftp.apigee.com/)から入手できる Edge 4.16.01 ドキュメントの ZIP ファイルに含まれています。

ただし、ダッシュボードをインストールして使用するには、ドキュメント ZIP ファイルに含まれる Apigee 評価契約に記入し、orders@apigee.com にメールで送信して Apigee に返送する必要があります。

エッジ プラットフォーム

管理 UI の再スタイル設定(Cloud 15.09.30)

管理 UI の複数のページのデザインを更新しました。(MGMT-2627)

API サービス

再設計された API プロキシ ウィザード(Cloud 16.01.20)

API プロキシ ウィザードが再設計されました。管理 UI の [API Proxies] ページで [+ API Proxy] をクリックすると、新しいウィザードのガイドに沿って API プロキシを作成できます。以前の API プロキシ ウィザードと同じ設定を使用できます。(MGMT-1376)

OpenAPI(Swagger)ドキュメントを使用して API プロキシを作成する(Cloud 16.01.20)

新しい API プロキシ ウィザードの再設計の一環として、OpenAPI(Swagger)ドキュメントから API プロキシを作成できるようになりました。API プロキシ ウィザードの最初のページで、[Reverse Proxy]、[Node.js App]、または [No Target] を選択する際に、[Use OpenAPI] をクリックします。表示されたフィールドに、OpenAPI ドキュメントの URL を入力します。詳細については、シンプルな API プロキシの構築をご覧ください。(MGMT-1376)

SOAP プロキシの WSDL 1.2 サポート(Cloud 16.01.20)

Apigee Edge は、SOAP サービスを呼び出す API プロキシを作成する際に WSDL 1.2 をサポートしています。(MGMT-2835)

TargetEndpoint 構成の SSLInfo 変数(Cloud 16.01.20)

API プロキシ TargetEndpoint では、SSL/TLS の詳細を動的に設定して、柔軟なランタイム要件をサポートできます。TargetEndpoint 構成で SSLInfo を設定する方法を示す次の例では、Java コールアウト、JavaScript ポリシー、または Assign Message ポリシーによって、実行時に値を指定できます。設定する値が含まれているメッセージ変数を使用します。

<TargetEndpoint>
...
  <SSLInfo>
    <Enabled>{myvars.ssl.enabled}</Enabled>
    <ClientAuthEnabled>{myvars.ssl.client.auth.enabled}</ClientAuthEnabled>
    <KeyStore>{myvars.ssl.keystore}</KeyStore>
    <KeyAlias>{myvars.ssl.keyAlias}</KeyAlias>
    <TrustStore>{myvars.ssl.trustStore}</TrustStore>
  </SSLInfo>
...
</TargetEndpoint>

この機能については、次のドキュメントで説明しています。

(APIRT-1475)

SAML アサーション ポリシーの RSA_SHA256 アルゴリズムのサポート(Cloud 16.01.20)

SAML アサーション ポリシーは、RSA_SHA1 に加えて RSA_SHA256 アルゴリズムをサポートするようになりました。(APIRT-1779)

証明書のアップロードの検証(Cloud 16.01.20)

期限切れの証明書や無効な証明書がキーストアとトラストストアにアップロードされるのを防ぐため、管理 API はアップロード時に証明書を検証します。証明書を検証して、ファイルサイズが 50 KB 以下であること、形式が PEM または DER のいずれかであることを確認します。証明書の有効期限も検証されます。デフォルトの有効期限の検証をオーバーライドする(アップロード時に証明書の有効期限を検証しない)には、次のクエリ パラメータを使用します。 ?ignoreExpiryValidation=true

詳細については、 JAR ファイルをキーストアにアップロードする トラストストアに証明書をアップロードするをご覧ください。(SECENG-516)および(APIRT-2213)

Node.js の [ログ] ページでの自動ポーリング(Cloud 16.01.20)

プロキシ エディタから Node.js ログを表示すると、Node.js の [ログ] ページが定期的に自動的に更新され、使用可能な新しいログが一覧表示されます。自動更新を無効にするには、[自動更新を停止] をクリックします。(MGMT-1692)

X-Forwarded-For HTTP ヘッダー(Cloud 15.09.30)

セキュリティを強化するため、Edge では、デフォルトで X-Forwarded-For HTTP リクエスト ヘッダーが削除されます。このヘッダーには 1 つ以上の IP アドレスが含まれています。新しいデフォルトの動作では、Edge が受信するクライアント IP アドレスは、アクセス制御ポリシーをバイパスするために偽装される可能性のあるアドレスではなく、最後の外部 TCP handshake から受信した IP アドレスになります。

このデフォルトの動作を変更して、X-Forwarded-For アドレスが API プロキシに到達できるようにするには、組織でプロパティ feature.enableMultipleXForwardCheckForACL=true を設定する必要があります。

ポリシー プロパティへの JavaScript アクセス(Cloud 15.07.08)

API プロキシフローで JavaScript を使用する場合、JavaScript ポリシーで定義されたプロパティにアクセスできます。これは、JavaScript コードで既知の変数を使用する場合は特に便利です。たとえば、JavaScript ポリシーに次のプロパティ定義が含まれているとします。

<Properties>
    <Property name='source'>response.content</Property>
</Properties>

JavaScript では、次のように、「source」プロパティへの参照を使用してメッセージ レスポンスにアクセスできます。
var source = properties.get('source'); // returns: response.content
または
var source = properties.source
または
var source = properties['source']

詳細については、JavaScript ポリシーをご覧ください。(APIRT-1460)

組織レベルの監査(Cloud 15.07.08)

組織管理者は、組織レベルで行われた操作の履歴を監査できます。管理 UI で、[管理] > [組織の履歴] を選択します。詳細については、監査: API、プロダクト、組織の履歴をご覧ください。(MGMT-2232)

組織管理者がロールから自己削除する(Cloud 15.07.08)

組織管理者は、[Admin] > [Organization Users] に移動し、名前の横にある [Remove] をクリックして、管理 UI で組織管理者のロールから自身を削除できます。(MGMT-934)

API プロキシ バンドルのインポートの進行状況インジケーター(Cloud 15.07.08)

管理 UI でサイズの大きな API プロキシ バンドルをアップロードすると、インポートがまだ進行中であることを示す「動作中」のアニメーションが表示されます。これにより、インポートが完了するまで管理 UI を操作できなくなります。(MGMT-1285)

キャッシュの動作と構成(Cloud 15.07.22)

メモリ内キャッシュの管理と使用率を改善するため、Edge クラウド リリース 15.06.10 では、環境キャッシュ リソースの [メモリ内の最大要素数] の設定が非推奨になりました。Edge Cloud リリース 15.07.22 では、この設定は Apigee Edge 管理 UI の [環境構成] にあるキャッシュ作成 UI から削除されました。

すべてのキャッシュ リソース(デフォルト キャッシュを含む)に存在する要素の合計は、キャッシュに割り当てられた合計メモリによって異なります。デフォルトでは、特定の Message Processor のメモリ内キャッシュに割り当てられるメモリの合計は、利用可能な合計メモリの 40% です。キャッシュ メモリが不足しているか、要素の有効期限が切れた場合にのみ、要素がメモリ内キャッシュから強制排除されます。(MGMT-2413、APIRT-1140)

管理 UI でのターゲット サーバー構成(Cloud 15.07.22)

管理 UI の [API] > [環境構成] ページで、ターゲット サーバーを追加、編集、削除できるようになりました。

また、ページのデザインが一新され、新しいページに移動する代わりに、インラインでキャッシュを作成、追加、削除できるようになりました。「メモリ内の最大要素数」など、いくつかのキャッシュ プロパティは、ランタイム キャッシュの動作に影響しなくなったため、UI で使用できなくなりました。(MGMT-280)

SSL と syslog へのメッセージ ロギング(Cloud 15.07.22)

Message Logging ポリシーでは、SSL/TLS 経由でサードパーティのログ管理プロバイダに syslog を送信できます。ポリシー構成で、親要素の直接の子として以下を使用します。

<SSLInfo>
    <Enabled>true</Enabled>
</SSLInfo>

詳細については、Message Logging ポリシーをご覧ください。(APIRT-942)

Management UI(Cloud 15.07.22)

Apigee エンジニアリングにより、管理 UI でさまざまな小規模なバグの修正とユーザビリティの向上が行われました。

Trace の cURL(Cloud 15.09.02)

ターゲット サーバーにリクエストを行う API プロキシ呼び出しをトレースする際に、ターゲット サーバーへのリクエストを cURL コマンドとして表示できます。Transaction Map 図で [Request sent to target server] ステージを選択し、[Phase Details] ペインの [Request sent to target server] 列の [Show Curl] ボタンをクリックします。(MGMT-2589)

データ マスキングの特殊文字(Cloud 15.09.02)

データ マスキングを使用して JSON ペイロードの機密データをマスキングする場合、$、*、{ などの特殊文字をマスクできるようになりました。(APIRT-1727)

管理 UI の Key-Value マップ(Cloud 15.09.30)

Edge 管理 UI で環境スコープの Key-Value マップ(KVM)を作成して管理できるようになりました。環境スコープの KVM には、test や prod などの環境内の任意の API プロキシからアクセスできる Key-Value ペアが含まれています。管理 UI のメニューで、[APIs] > [Environment Configuration] > 必要な環境を選択 > [Key Value Maps] タブの順に移動します。詳細については、環境 Key-Value マップの作成と編集をご覧ください。(MGMT-1393)

管理 UI の PopulateCache ポリシーのデフォルト有効期限(Cloud 15.09.30)

API プロキシ エディタを使用して PopulateCache ポリシーを追加すると、キャッシュ有効期限の <TimeoutInSec> 要素に 3, 600 秒(1 時間)の値が事前入力されます。以前のデフォルトは 300 秒(5 分)でした。(MGMT-2622)

デベロッパー サービス

API プロダクト ページのパフォーマンス、デベロッパー アプリがリストされない(Cloud 16.01.20)

管理 UI で API プロダクトを表示すると、そのプロダクトに関連付けられているデベロッパー アプリが一覧表示されます。UI のパフォーマンスを向上させるため、API プロダクトを編集する際にデベロッパー アプリのリストは表示されません。(MGMT-2869)

[Developer Apps] ページのキー列(Cloud 15.08.05)

多数のデベロッパー アプリ(数千個)がある組織では、[Developer Apps] ページに [Key] 列(アプリごとのキーの数を表示)を表示すると、ディスプレイのパフォーマンスが低下する可能性があります。この状況でディスプレイのパフォーマンスを向上させるには、Apigee サポートに連絡して、組織レベルのプロパティ features.appsNoCredentialsEnabled = true を設定します。このプロパティは [キー] 列を削除します。ただし、[キー] 列を削除すると、コンシューマ キーとシークレットによる検索もできなくなります。(MGMT-2486)

デベロッパーの詳細ページの進行状況スピナー(Cloud 15.09.30)

管理 UI に [デベロッパーの詳細] ページが読み込まれると、アプリの読み込み中にページの [アプリ] セクションに進行状況スピナーが表示されます。これにより、アプリの読み込み時に [アプリ] セクションが空で表示される以前の動作が改善されます。(MGMT-2667)

収益化

API パッケージ名を編集する(Cloud 16.01.20)

API パッケージの名前は、公開料金プランが API パッケージに含まれていても、収益化ライフサイクルのどの時点でも更新できます。(DEVRT-2177)

カスタム属性で小数点を使用できるようになりました(Cloud 16.01.20)

「カスタム属性付きレート表」プランを使用する場合、トランザクションの調整因子として使用されるメッセージ ヘッダー内のカスタム属性を、小数点以下 4 桁までの小数値にできるようになりました。このタイプのプランの詳細については、レート表のカスタム属性の詳細を指定する(DEVRT-2191)をご覧ください。

概要レポートの料金プラン名と ID(Cloud 15.09.02)

Management API を使用して概要収益レポートを生成する場合、レポートに [料金プラン] 名と料金 [プラン ID] 列を追加できます。そのためには、レポートを作成するで説明されているように、API 呼び出しで groupBy 属性として「RATEPLAN」を追加します。(この機能は、収益化レポートの UI ではまだご利用いただけません)。詳細レポートでは、既存の料金プランの名前と ID の列が、他のグループ化列とともにレポート前面付近に配置されるようになりました。(DEVRT-1740)

分析サービス

応答時間指標に対する sum( ) 関数(Cloud 16.01.20)

アナリティクスのカスタム レポートと API 呼び出しで、集計関数「sum」を、目標応答時間、合計応答時間、end_point_response_time に使用できるようになりました。たとえば、/stats API(http://docs.apigee.com/management/apis/get/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/stats/%7Bdimension_name%7D-0)では、「select」クエリ パラメータ ?select=sum(total_response_time) を使用できます。(AXAPP-2006)

レイテンシ分析レポート: API プロキシ名の並べ替え(Cloud 16.01.20)

レイテンシ分析レポート UI(Apigee Edge Enterprise プランのみ)では、API プロキシは [Proxy] プルダウン リストにアルファベット順に表示されます。(MGMT-2858)

表示名でダッシュボードに表示される Developer Apps(Cloud 16.01.20)

管理 UI ダッシュボードの [Developer Apps] 棒グラフには、内部名ではなく表示名でデベロッパー アプリが一覧表示されます。(MGMT-2853)

カスタム レポートに新しい日付/時刻ウィジェットを追加(Cloud 16.01.20)

管理 UI のカスタム レポートページの日付/時刻選択ツール ウィジェットが強化されました。(MGMT-2881)

GeoMap での市のドリルダウン(Cloud 15.07.22)

アナリティクスの GeoMap には、米国とカナダの「都市」ドリルダウンが含まれています。地図上で州をクリックすると、通話の発信元の都市のリストが表示されます。(MGMT-2282)

アナリティクスのカスタム レポートでの |(パイプ)文字と = 文字(Cloud 15.09.02)

アナリティクスのカスタム レポートの定義では、|(パイプ)記号と = 記号を使用できます。これまでは、これらのシンボルに %7C および %3D エンコードを使用する必要がありました。(MGMT-2504)

プロキシパス サフィックス ディメンション(Cloud 15.09.30)

アナリティクスのカスタム レポートと API 呼び出しで、新しいプロキシパスのサフィックス(proxy_pathsuffix)ディメンションを使用できるようになりました。プロキシパスのサフィックスは、条件フロー用に作成されたパスなど、API プロキシ URL のベースパスより後の部分です。(AXAPP-1902)

レポートに、表示名ではなくデベロッパー ID が表示される(Cloud 15.09.30)

デベロッパーを返す /stats API を使用して Edge Analytics API 呼び出しを行うと、デベロッパーの表示名がデベロッパー ID とともに返されます。以前は、デベロッパー ID のみが返されていました。(AXAPP-1759)

修正済みのバグ

以下のバグはこのリリースで修正されています。

Private Cloud 4.16.01

次の表に、Edge for Private Cloud 4.16.01 リリース以降に修正されたバグを示します。これらの修正を得るには、Apigee Edge 4.16.01.x を最新の 4.16.01 リリースに更新するの説明に沿って、4.16.01 インストールを最新の RPM とサポート ファイルに更新します。

問題 ID 説明 ビルド番号
PRC-736

apigee-lib で GCC が不要に

apigee-lib-4.16.01-0.0.901
PRC-735

Yahoo Weather API に OAuth が必要になったため、apigee-validate が失敗しなくなりました。

apigee-validate-4.16.01-0.0.910
PRC-739

任意のファイル システム フォルダにあるミラーの抽出をユーザーに許可する

apigee-mirror-4.16.01-0.0.904
PRC-756

BaaS Usergrid check_cassandra_availability.sh が nc コマンドを使用しなくなりました

baas-usergrid-2.1.0-0.0.112
PRC-778

アップグレード後に Zookeeper クラスタの情報が失われないように修正

apigee-migrate-4.16.01-0.0.873
PRC-787

API BaaS で Cassandra 認証がサポートされるようになりました

baas-usergrid-2.1.1-0.0.122
PRC-804

ログファイルの場所を指定可能に

apigee-service-4.16.05-0.0.435
PRC-840

Edge コンポーネントのシンボリック リンクの破損

edge-gateway-4.16.01-0.0.538

EDGEUI-538
EDGEUI-524

WSDL のインポートで Soap プロキシ生成がハングする/ WSDL からの API プロキシの生成に関する問題

edge-ui-4.16.01-0.0.3650
EDGEUI-543

URL がローカル アドレスの場合に、URL オプションから WSDL をインポートできない

edge-ui-4.16.01-0.0.3650
APIRT-2719
APIRT-2918

ターゲット コールアウトを作成する際に target.url が設定されるようになりました

edge-gateway-4.16.01-0.0.538

Cloud 16.01.20

問題 ID 説明
MGMT-2964 新しいプロキシ エディタが Flows タグ内のコメントを受け付けない
MGMT-2957 組織に新しい Pod を追加すると、新しい Pod 内のルーターにバンドルのデプロイ ステータスがエラーとして返される
MGMT-2937 カスタムロールに関する不十分な権限のエラー
MGMT-2875 WSDL SOAP の生成に SOAP 1.2 のヘッダーが正しくない
MGMT-2739 デベロッパー アプリ レポート: [アナリティクス] タブに異常グラフが表示されない
MGMT-2735 Node.js ログの更新が完了/停止しない
MGMT-2734 デプロイされたバンドルを保存しようとしたときにエラーが発生しても [保存] ボタンが有効にならない
MGMT-2729 UI で TargetServer のポートを更新すると SSLInfo が消去される
MGMT-2702 Firefox と IE のクロスサイト セキュリティの脆弱性
クロスサイト リクエストを不適切な方法で許可する FireFox と IE の脆弱性が原因で発生する可能性があるセキュリティの脆弱性を修正しました。
MGMT-2681 Proxy Editor: Condition で正規表現の一致を使用すると、Flow Navigator に動詞が表示されない
MGMT-2361 RPCException: 呼び出しがタイムアウトしてプロキシのデプロイが失敗する
MGMT-1662 Apigee Public Cloud リリース中に API プロキシのデプロイに失敗する
DEVRT-2286 sync-organization Monetization API に互換性がない
Apigee Edge データと収益化の同期に使用される API が、16.01.20 リリースの最新の更新で修正されました。
DEVRT-2173 パッケージの名前を変更する必要があるが、料金プランが有効なため編集できない
DEVRT-1661 デベロッパーは料金プランの開始日より前に API リクエストをブロックしているが、ブロックはリリースされない
API デベロッパーが将来の日付に開始される月次定額、ボリューム バンド、またはバンドルレートのプラットフォームを受け入れ、指定された開始日より前に API リクエストを送信すると、API デベロッパーはそれ以上リクエストを実行できなくなります。料金プランの開始日になると、ブロックは解除されます。
DEVRT-1643 保存した料金プランが破損した
AXAPP-1991 Apigee Analytics のサマリーをオプトアウトしてもメールが止まらない
AXAPP-1946 アナリティクスのクリーンアップ時にディスク容量が解放されない
AXAPP-1708 Analytics API で質問する方法によって、同じ統計データでも異なる数値が生成されるように見える
AXAPP-1293 アナリティクスの概要メールに存在しないデベロッパー アプリ名が表示される
APIRT-2518 JavaScript ポリシーを使用した https バックエンドへの接続に関する問題
APIRT-2398 無効または期限切れの認可コードが Apigee エラーとしてカウントされる
APIRT-2397 steps.assignmessage.SetVariableFailed が Apigee エラーとしてカウントされました
APIRT-2396 IllegalAimpressions、OAuth の ArrayIndexOutofBoundsException が Apigee エラーとしてカウントされる
APIRT-2362 JavaScript コンパイル エラー
APIRT-2322 無効なクライアント ID が誤って Apigee エラーとして報告される
APIRT-2159 ロギング接頭辞に message_id を追加する
APIRT-2145 Facebook API のトランザクションの高エラー失敗
「:」で始まるヘッダー値の検証が削除されました。
APIRT-2137 MP: チャンク転送エンコード、コンテンツ長 0 の 205
APIRT-2124 Nginx ルーターが、新しく追加された MP の MP プールを更新しない
APIRT-2117 Message Logging ポリシーが DNS の更新を尊重しない
APIRT-2110 ルーターから 1 つの X-Forwarded-For ヘッダーのみが渡される
APIRT-2062 SkipCacheLookup 条件が満たされている場合にレスポンス キャッシュが正しく機能しない
APIRT-2061 Message Processor が QPID にメッセージを push しない
APIRT-2052 管理ポートが応答していないために多数の CLOSE_WAIT が発生する
APIRT-2024 ロードバランサのない Nginx で X-Forwarded-For HTTP ヘッダーが適切に入力されない
X-Forwarded-For のサポート終了のお知らせが 150930 リリースノートとアクセス制御ポリシーに追加されました。
APIRT-1933 プロキシ固有のクラスローダーは引き続き MP クラスローダーにデリゲート
APIRT-1877 名前空間がある XML レスポンスをマスクできない
APIRT-1838 Apigee-127: VerifyAPIKey は 1 つの API プロダクトのみを返す(複数のプロダクトが存在する場合)
APIRT-1827 同時ストリーミングの上限が低くなっています
APIRT-1820 4.15.04 Private Cloud 環境での断続的なレイテンシ(1% 超)
APIRT-707 <GenerateResponse> 要素が VerifyAccessToken ポリシーにある場合、実行時に NPE

Cloud 15.07.08

問題 ID 説明
MGMT-2381 新しいプロキシ エディタを使用してプロキシをデプロイできない
MGMT-2374 ProxyEndpoint を保存する前に、BasePath 要素のスペースをカットする必要があります。
MGMT-2355 1 つのロールが orgadmin の場合、UI で複数のロールの権限が正しく計算されない
MGMT-2324 Swagger モデルをインポートすると、間違った SmartDocs ノードが生成される
MGMT-1518 MP でデプロイが失敗しても、UI にプロキシがデプロイ済みと表示される
MGMT-1489 API プロダクトで正しいリソースが生成されない
DOC-1246 アクセス トークンに関するドキュメント内の矛盾する記述
DEVRT-1661

デベロッパーが機能料金プランを承認したときに、NextRecurringFeeDate が空になる
デベロッパーが将来の日付に開始する月間定額料金、ボリューム バンド方式、またはバンドル料金プランを承認し、開始日より前に料金プランで API 呼び出しを数回行い、その後呼び出しがブロックされた場合(想定された挙動)、料金プランが有効になったときにデベロッパーのブロックが自動的に解除されることはありません。なお、本事象はすでに解決しております。

Cloud 15.07.22

問題 ID 説明
TBD-73 Apigee へのインバウンド トラフィックの静的 IP
MGMT-2422 会社のアプリを編集できない
MGMT-2419 「ユーザー」ロールに属するユーザーがログイン時に権限エラーを受け取る
MGMT-2341 カスタム レポート フィルタでクエリが正しく作成されない
MGMT-2207 JSONThreatProtection - ArrayElementCount が、含まれている要素が非プリミティブである場合に機能しない
JSON Threat Protection ポリシーで、ArrayElementCount 要素が、配列内で使用できるアイテム数を正確に制限していませんでした。なお、本事象はすでに解決しております。
MGMT-2158 出力が型のない部分を参照している場合、WSDL をインポートできません

Cloud 15.08.05

問題 ID 説明
複数 API プロキシ エディタのいくつかの小さなバグが修正されました。

Cloud 15.09.02

問題 ID 説明
複数 API プロキシ エディタのいくつかの小さなバグが修正されました。
MGMT-2618 デプロイでよく発生する問題
MGMT-2588 デベロッパー履歴ページで HTML/コードが実行される -- XSS 永続性の脆弱性
MGMT-2543 新しいプロキシ エディタで AssignMessage ポリシーの <Payload> 内の XML が変更され、既存の API プロキシが破損する
MGMT-2521 Trace セッションがハングすることがある
MGMT-2519 環境構成 UI が機能しない
AXAPP-1814 zk キュレーターが有効になっている場合に、本番環境でカスタム変数(Statistics Collector ポリシー)が作成されない
APIRT-1927 仮想ホストが原因で、ルーターが env の構成を読み込まない
APIRT-1863 バンドルに空白があるためデプロイが失敗する
APIRT-1823 &(アンパサンド)文字を含む POST 本文を使用した API 呼び出しがハングする
APIRT-1789 メモリ不足エラーが発生している特定の組織の Message Processor
APIRT-1776 JavaScript ポリシーで「print」を呼び出すと過剰なロギングが発生する
APIRT-1766 WebSocket でのタイムアウト
APIRT-1600 ルーターの ConcurrentModificationException
ルーターのログに、定期的に複数の ConcurrentModification のインスタンスが記録されていました。これは、リーパーが古い接続を削除している間に、接続がリーパーリストに追加されていたことが原因でした。なお、本事象はすでに解決しております。
APIRT-1491 503 Service unavailable Exception
APIRT-1421 JavaCallout ポリシーの処理に断続的に時間がかかる
DEVRT-1843 Mint UI で TRP のカスタム属性の更新のサポートを改善
DEVRT-1472 デベロッパーの更新で 500 サーバーエラーが発生した

Cloud 15.09.30

問題 ID 説明
MGMT-2687 カスタム レポートで 14,000 を超えるディメンション要素でブラウザがフリーズする
MGMT-2677 収益化: 管理 UI のデベロッパー ページが数千人のデベロッパーでフリーズし、組織でページネーションが有効になっていない
MGMT-2674 ユーザーのログイン時に Edge UI がインターネットからのダウンロードを試行する
MGMT-2658 API プロキシのリビジョンのアップグレード時の OPDK バージョンに依存する Management Server UI の問題
MGMT-2616 新しい API プロキシ エディタで XML エンティティが正しく処理されない
MGMT-2541 パスワードに + を使用して sysadmin として追加された外部認証システム ID が破損している
MGMT-2510 組織に属するすべてのデベロッパーが表示されない
MGMT-2508 ポリシーの無効なリンクアイコンが不正確
MGMT-2334 2 つ目のプロキシ エンドポイントからリソースにアクセスできない
MGMT-1967 同じ表示名を持つデベロッパー アプリのアナリティクスで同じトラフィックが表示される
DEVRT-1839 収益化: 管理 UI で国選択リストが正しく並べ替えられない
AXAPP-1887 フィルタ条件がドキュメントどおりに機能していない
AXAPP-1869 組織からユーザーを削除すると、その組織からのアナリティクス メールの配信登録が解除される
AXAPP-1533 アナリティクスの Geomap で「Invalid API Call」エラーがスローされる
APIRT-2061 Message Processor が QPID にメッセージを push しない
APIRT-2052 管理ポートが応答していないために多数の CLOSE_WAIT が発生する
APIRT-2024 ロードバランサのない Nginx で X-Forwarded-For HTTP ヘッダーが正しく入力されない
APIRT-1838 Apigee-127: VerifyAPIKey は 1 つの API プロダクトのみを返す(複数のプロダクトが存在する場合)

Private Cloud 4.15.07.03

問題 ID 説明
APIRT-1600 Router ログの ConcurrentModificationException
APIRT-1734 組織/環境レベルでダウンタイムなしでリソース ファイルを更新
APIRT-1820 4.15.04 Private Cloud 環境での断続的なレイテンシ(1% 超)
APIRT-2159 ロギング接頭辞に message_id を追加する
APIRT-2160 分析データの request_processing_latency から SSL handshake を除外する
AXAPP-1882 コンシューマー ウォッチャー スレッドがアクティブ/アクティブ デプロイで誤ったキューに接続する
AXAPP-1946 UTC 以外のタイムゾーンでデータが子ファクト テーブルではなく親ファクト テーブルに移動される
MGMT-1590 セキュリティの脆弱性の修正
MGMT-1662 リリース中にデプロイが失敗する
MGMT-2361 RPCException: 呼び出しがタイムアウトしてプロキシのデプロイが失敗する
MGMT-2397 コードビューで行末文字が正しく解析されない
MGMT-2466 Message Processor に対するクラスタ チェックで、到達不能な Router が CONNECTED メンバーとして表示される
OPDK-1981 backup-cassandra.sh がシステム キースペースをバックアップしない
OPDK-1982 apigee-upgrade.sh はアップグレード前に Cassandra SSTable のバージョンをチェックする必要がある

Private Cloud 4.15.07.01

問題 ID 説明
OPDK-1927 Monetization アップグレードでテーブルが欠落している、重複するインデックスが作成される
OPDK-1878 設定時にゲートウェイ Pod 名を変更すると問題が発生する
OPDK-1886 ノードがローカル IP アドレス(192.168.x.y など)にアクセスできない
MGMT-2521 Trace セッションがハングすることがある
MGMT-2543 新しいプロキシ エディタで AssignMessage ポリシーの <Payload> 内の XML が変更され、既存の API プロキシが破損する
MGMT-2599 新しいプロキシ エディタで削除した名前空間接頭辞が復元される
MGMT-2702 FireFox と IE のクロスサイト セキュリティの脆弱性
APIRT-1074 Connection: Close ヘッダーが Content-Length ヘッダーまたは Transfer-Encoding ヘッダーなしで送信された場合、Gzip 圧縮コンテンツが正しく処理されない

既知の問題

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

問題 ID 説明
APIRT-2742 Netty ルーターに代えて Nginx サーバーが導入された Edge for Private Cloud 4.16.01 では、Edge JMX 統合を使用できません。
APIRT-2978

Router が Nginx を起動できない、または Router を起動できない

/opt/apigee/var/log/edge-router/logs/system.log ファイルに示されているように、Edge Router が Nginx の起動に失敗した場合、または起動に失敗した場合は、/opt/nginx/conf.d ディレクトリ内のすべてのファイルを削除して、ルーターを再起動します。

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
DOC-1687 既知のパッケージ依存関係の競合により、Satellite Server 6 で使用される Katello エージェントは、Qpid デーモンを実行している Apigee Edge ホストに正しくインストールされません。
PRC-1118

「apigee-service apigee-postgresql pg-data-purge」コマンドの実行中に発生するエラー

「apigee-service apigee-postgresql pg-data-purge」コマンドを実行すると、次の形式のエラーが表示されます。

エラー: リレーションのオーナーである必要があります

/opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge を編集して、次のプロパティを「apigee」に設定します。

POSTGRES_USER=apigee