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 のバージョンに含まれているかどうかを確認するには、リリース番号についてをご覧ください。

非推奨のサービスと機能

プライベート クラウド 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 に移行するために必要なほとんどのタスクを処理します。ただし、アップグレードの一環として、移行の前にすべての仮想ホスト定義でホスト エイリアスを含むようにする必要があります。

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

構成したコード

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 ファイルには、コンポーネントのすべてのプロパティが含まれているわけではありません。このリリースでの変更点の 1 つは、.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-all stop
  • Edge コンポーネントで直接実行するコマンド。たとえば、以前のリリースでは、OpenLDAP パスワードの変更に chpasswd-openldap.sh スクリプトを使用していました。このスクリプトは、apigee-openldap コンポーネントで実行する次のコマンドに置き換えられました。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword

コマンドを使用した構成の詳細については、Apigee の ftp サイト ftp://ftp.apigee.com/ にある Apigee Edge の操作ガイドをご覧ください。

新しい Edge Router

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

Nginx ルーターのハードウェア要件とポート要件は 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 component -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

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

/<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-service comp backup

/<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 configFile

組織、環境、仮想ホストを 1 つのステップで追加

/<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 構成ファイル

環境を追加

/<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 configFile

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

このリリースには、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)

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

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

TargetEndpoint 構成の SSLInfo 変数(Cloud 16.01.20)

API プロキシ TargetEndpoint では、SSL/TLS の詳細を動的に設定し、柔軟なランタイム要件に対応できます。次の例では、SSLInfo を TargetEndpoint の構成でどのように設定するかを、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)

期限切れまたは無効な証明書がキーストアとトラストストアにアップロードされるのを防ぐため、Management 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 はデフォルトで 1 つ以上の IP アドレスを含む X-Forwarded-For HTTP リクエスト ヘッダーを削除します。新しいデフォルトの動作では、Edge が受信するクライアント IP アドレスは、最後のアクセス制御 TCP ハンドシェイクから受信した 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)

組織管理者は、管理 UI で [Admin] > [Organization Users] に移動し、名前の横にある [Remove] をクリックして、組織管理者ロールから自分自身を削除できます。(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 の [Environment Configuration] セクションにある [Create Cache UI] から削除されました。

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

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

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

さらに、新しいページではなく、インラインでキャッシュを作成、追加、削除できるようにデザインを見直しました。「キャッシュ内の最大要素数」を含むいくつかのキャッシュ プロパティは、UI では使用できなくなりました。これらのプロパティを設定しても、ランタイム キャッシュの動作に影響はないためです。(MGMT-280)

Syslog へのメッセージ ロギングを使用した SSL(Cloud 15.07.22)

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

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

詳細については、メッセージ ロギング ポリシーをご覧ください。(APIRT-942)

Management UI(Cloud 15.07.22)

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

Trace の cURL(Cloud 15.09.02)

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

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

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

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

Edge 管理 UI で、環境スコープの Key-Value マップ(KVM)を作成、管理できるようになりました。環境スコープの KVM には、テストや本番などの環境内の任意の API プロキシからアクセス可能な Key-Value ペアが含まれます。管理 UI メニューで、[API] > [環境構成] > [目的の環境を選択] > [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)

[デベロッパー アプリ] ページのキー列(Cloud 15.08.05)

デベロッパー アプリ(数千)を多数所有している組織では、[デベロッパー アプリ] ページに [キー] 列(アプリあたりのキーの数が表示されます)を表示すると、表示のパフォーマンスが低下する可能性があります。この状況での表示パフォーマンスを改善するには、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 呼び出しで、ターゲット レスポンス時間、合計レスポンス時間、end_point_response_time の「sum」集計関数を使用できるようになりました。たとえば、/stats API(http://docs.apigee.com/management/apis/get/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/stats/%7Bdimension_name%7D-0)で、?select=sum_total_response_time のクエリ パラメータを使用できるようになりました。(AXAPP-2006)

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

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

表示名で示されるダッシュボード上のデベロッパー アプリ(Cloud 16.01.20)

管理 UI ダッシュボードのデベロッパー アプリの棒グラフでは、内部名ではなく表示名別にデベロッパー アプリが一覧表示されています。(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)

修正済みのバグ

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

プライベート クラウド 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 インポート用ソープ プロキシ生成の停止/ 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

ターゲット コールアウトを行う際にターゲット URL が設定されるようになった

edge-gateway-4.16.01-0.0.538

クラウド 16.01.20

問題 ID 説明
MGMT-2964 新しいプロキシ エディタは Flows タグ内のコメントを受け入れない
MGMT-2957 新しい Pod を組織に追加すると、新しい Pod で Router のエラーとしてバンドルのデプロイ ステータスが返される
MGMT-2937 カスタムロールに十分な権限がない
MGMT-2875 WSDL SOAP に SOAP 1.2 のヘッダーが正しくありません
MGMT-2739 デベロッパー アプリ レポート。[アナリティクス] タブに異常グラフが表示されない
MGMT-2735 Node.js ログの更新が完了/停止しない
MGMT-2734 デプロイしたバンドルを保存しようとしてもエラーボタンを押しても [Save] ボタンが有効にならない
MGMT-2729 UI で TargetServer のポートを更新すると SSLInfo が消去される
MGMT-2702 Firefox と IE のクロスサイト セキュリティの脆弱性
クロスサイト リクエストを適切に許可する FireFox と IE の脆弱性が原因で発生する可能性があるセキュリティの脆弱性を修正しました。
MGMT-2681 プロキシ エディタ: 条件で正規表現を使用すると、フロー ナビゲータに動詞が表示されない
MGMT-2361 RPCException: プロキシの呼び出しがタイムアウトしてプロキシのデプロイが失敗する
MGMT-1662 Apigee Public Cloud のリリース中に API プロキシのデプロイが失敗する
開発 -2286 sync-organization Monetization API がない
Apigee Edge データを収益化と同期するために使用される API が、16.01.20 リリースの最新更新で修正されました。
開発 -2173 パッケージの名前を変更する必要があるが、有効な料金プランであるため編集できない
開発 1661 料金プランの開始日前に API リクエストを行うことができるようデベロッパーがブロックされていますが、ブロックの解除は行われていません
API デベロッパーが月単位で定額制、ボリューム バンド、バンドルレートのレートを受け付け、指定した開始日より前に API リクエストを送信した場合、API デベロッパーはそれ以降のリクエストをブロックします。料金プランの開始日に達すると、ブロックが解放されます。
開発 1643 下書きの保存後に破損した
AXAPP-1991 オプトアウトされない Apigee Analytics Summary とメールが停止しない
AXAPP-1946 アナリティクスのクリーンアップによりディスク容量が解放されない
AXAPP-1708 Analytics API では、質問の内容によって、同じ統計情報に対して異なる数値が生成されているように見える。
AXAPP-1293 アナリティクスのサマリーメールに記載されている、存在しないデベロッパー アプリ名
APIRT-2518 JavaScript ポリシーを使用した HTTPS バックエンドへの接続に関する問題
APIRT-2398 無効な認証コード、または有効期限が切れた認証コードが Apigee エラーとしてカウントされる
APIRT-2397 steps.assignmessage.SetVariableFailed が Apigee エラーとしてカウントされる
APIRT-2396 IllegalArgumentException、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 DNS 更新に準拠していないメッセージ ロギング ポリシー
APIRT-2110 ルーターによって渡される X-Forwarded-For ヘッダーが 1 つのみ
APIRT-2062 SkipCacheLookup 条件が満たされている場合、レスポンス キャッシュが正しく機能しない
APIRT-2061 Message Processor がメッセージを QPID に push しない
APIRT-2052 管理ポートが応答しないため、CLOSE_WAIT 数が多い
APIRT-2024 ロードバランサのない Nginx で X-Forwarded-For HTTP ヘッダーが正しく入力されない
150930 のリリースノートとアクセス制御ポリシーに追加された X-Forwarded-For 非推奨通知が追加されました。
APIRT-1933 プロキシ固有のクラスローダーは依然として MP クラスローダーにデリゲート
APIRT-1877 名前空間を含む XML レスポンスをマスキングできない
APIRT-1838 Apigee-127: VerifyAPIKey が複数のプロダクトが存在する場合、1 つの API プロダクトのみを返す
APIRT-1827 同時実行ストリーミングの上限が低い
APIRT-1820 4.15.04 プライベート クラウド環境での断続的なレイテンシ(1% 超)
APIRT-707 ランタイムに <GenerateResponse> 要素が VerifyAccessToken ポリシーに含まれている場合の NPE

Cloud 15.07.08

問題 ID 説明
MGMT-2381 新しいプロキシ エディタを使用してプロキシをデプロイできない
MGMT-2374 BasePath 要素のスペースをカットしてから 🛑? を作成する
MGMT-2355 1 つのロールが orgadmin の場合、UI で複数のロールの権限が正しく計算されない
MGMT-2324 Swagger モデルをインポートすると誤った SmartDocs ノードが生成される
MGMT-1518 MP にデプロイできなくても、UI にプロキシがデプロイ済みと表示される
MGMT-1489 API プロダクトが適切なリソースを生成しない
DOC-1246 アクセス トークンに関するドキュメント内の矛盾するステートメント
開発 1661

デベロッパーが機能料金プランを受け入れた場合、NextRecurringFeeDate は空になります
デベロッパーが開始日以降の月単位の定額プラン、ボリューム バンド、バンドル料金プランのいずれかを受け入れ、開始日前にいくつかの API 呼び出しを行い、その後呼び出し(ブロック)を行った場合、デベロッパーは、料金プランが有効になった時点で自動的にブロックが解除されませんでした。なお、本事象はすでに解決しております。

クラウド 15.07.22

問題 ID 説明
未定 Apigee への受信トラフィックの静的 IP
MGMT-2422 会社のアプリを編集できない
MGMT-2419 「User」ロールに属するユーザーがログイン時に権限エラーを受け取る
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/code が実行される - XSS が永続する脆弱性
MGMT-2543 新しいプロキシ エディタで AssignMessage ポリシーの <Payload> 内の XML が変更され、既存の API プロキシが破損します。
MGMT-2521 Trace セッションのハングアップ
MGMT-2519 環境構成 UI が機能しない
AXAPP-1814 zk curator が有効になっていると、本番環境にカスタム変数(Statistics Collector ポリシー)が作成されない
APIRT-1927 仮想ホストが無効な場合、ルーターが環境の構成ファイルを読み込めない
APIRT-1863 バンドルの空白が原因でデプロイが失敗する
APIRT-1823 &(アンパサンド)文字を含む POST 本文を使用した API 呼び出しがハングする
APIRT-1789 メモリ不足エラーが発生した特定の組織の Message Processor
APIRT-1776 JavaScript ポリシーで「print」を呼び出すと、過剰なロギングが発生する
APIRT-1766 WebSocket のタイムアウト
APIRT-1600 ルーターの ConcurrentModificationException
ルーターのログでは、ログに ConcurrentModification の複数のインスタンスを定期的に表示していました。これは、Reaper が古い接続を削除する間、reaper リストに接続が追加されたためです。なお、本事象はすでに解決しております。
APIRT-1491 503 サービス利用不可の例外
APIRT-1421 Java コールアウト ポリシーの処理に時間がかかる
開発 1843 ミント UI が TRP のカスタム属性の更新をより適切にサポート
開発 1472 デベロッパーの更新により 500 サーバーエラーが発生した

クラウド 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 同じ表示名のデベロッパー アプリが分析で同じトラフィックを表示する
開発 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 プロダクトのみを返す

プライベート クラウド 4.15.07.03

問題 ID 説明
APIRT-1600 Router ログの ConcurrentModificationException
APIRT-1734 組織または環境レベルでダウンタイムが発生しないリソース ファイルの更新
APIRT-1820 4.15.04 プライベート クラウド環境での断続的なレイテンシ(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 メッセージ プロセッサに対するクラスタ チェックで、接続できない Router が CONNECTED メンバーとして表示される
OPDK-1981 backup-cassandra.sh でシステム キースペースがバックアップされない
OPDK-1982 apigee-upgrade.sh ではアップグレード前に Cassandra SSTable のバージョンを確認する必要があります

Private Cloud 4.15.07.01

問題 ID 説明
OPDK-1927 収益化のアップグレード時にテーブルが見つからない、重複するインデックスが作成される
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 接続時に Gzip 形式のコンテンツが正しく処理されない: Close ヘッダーが Content-Length または Transfer-Encoding ヘッダーなしで送信される

既知の問題

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

問題 ID 説明
APIRT-2742 Edge JMX は、Netty ルーターに置き換わる Nginx サーバーの導入により、Edge for Private Cloud 4.16.01 と統合できません。
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