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）以降、次のリリースが行われています。

• クラウド: 15.07.08、15.07.22、15.08.05、Nginx の移行、15.09.02、15.09.30、16.01.20
• プライベート クラウド: 4.15.07.01、4.15.07.03

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

非推奨のサービスと機能

プライベート クラウド 4.15.07.03

curl http:// <qpid_IP>:8083/v1/servers/self/queues

アナリティクス: 複数のレポートのカスタム レポート ダッシュボード ビュー（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 の操作ガイドをご覧ください。

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

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

この機能は、次のドキュメントでカバーされています。

• API プロキシ構成リファレンス
• https://community.apigee.com/articles/21424/dynamic-sslinfo-for-targetendpoint-using-variable.html

（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 とサポート ファイルに更新します。

クラウド 16.01.20

Cloud 15.07.08

クラウド 15.07.22

Cloud 15.08.05

Cloud 15.09.02

クラウド 15.09.30

プライベート クラウド 4.15.07.03

Private Cloud 4.15.07.01

既知の問題

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

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart