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

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。 詳細

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

以前の Edge for Private Cloud 四半期リリース（4.15.07.00）以降、 次の機能リリースに含まれています。

• Cloud: 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

リリースについて 番号付けを使用して、特定のクラウド リリースが 含まれている必要があります。

サポートの終了

プライベート クラウド 4.15.07.03

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

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

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

組織名の長さはオーバーライドできません （プライベート クラウド内）

以下を設定して、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 では、/&lt;install-dir&gt;/apigee4/conf ディレクトリの .properties ファイルが使用されなくなりました。 構成する必要があります4.16.01 の時点でも、Edge コンポーネントの構成には、 .properties ファイルですが、次のディレクトリに配置されています。

/opt/apigee/customer/application

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

以前のバージョンの Edge とは異なり、Edge 4 .16.01 の.properties ファイルには、すべて コンポーネントのプロパティを定義します。このリリースでの変更の 1 つは、.properties ファイルの デフォルトのプロパティ値のオーバーライドのみが含まれます。

このアーキテクチャの利点は、新しいバージョンの Edge への移行時に、 インストーラが /opt/apigee/customer/application にあるファイルを上書きすることはありません。 これにより、Edge が設定を誤って上書きする可能性がなくなります。

移行時に、Edge インストーラが既存の .properties ファイルを調べ、変更をコピーします /opt/apigee/token ディレクトリに移動します。したがって、 移行後に編集する必要はありません。

詳細については、Apigee の FTP サイトで入手できる Apigee Edge のオペレーション ガイドをご覧ください。 ftp://ftp.apigee.com/.

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

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

• Apigee ユーティリティで実行するコマンド（apigee-service、apigee-all、 apigee-setup、apiee-provision、apigee-migrate ユーティリティのいずれかを使用できます。
  たとえば、all-start.sh と all-stop.sh のスクリプトは次のように置き換えられています。 コマンド:
  &gt; /opt/apigee/apigee-service/bin/apigee-all start
  &gt;/opt/apigee/apigee-service/bin/apigee-all 停止
• Edge コンポーネントで直接実行するコマンド。たとえば以前のリリースでは chpasswd-openldap.sh スクリプトを使用して OpenLDAP パスワードを変更していました。このスクリプトには apigee-openldap コンポーネントで実行する次のコマンドに置き換えられています。
  &gt; /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 ルーター。Nginx Router は、以前のリリースで使用していた Netty Router に置き換わるものです。 4.16.01.

Nginx ルーターのハードウェアとポートの要件は Netty Router と同じであるため、 変更が必要です。

詳細については、Edge のインストールの付録 A: Nginx ルーターについて ガイド。 Apigee の FTP サイト ftp://ftp.apigee.com/ で入手できます。

BaaS ロードバランサの削除

内部ロードバランサが API BaaS ポータルから削除されました。次に、 API BaaS ポータルと 3 つの API BaaS スタックノード間の独自のロードバランサを構築します。

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

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

Apigee の FTP サイトにあるドキュメントの ZIP ファイルに「Scaling Edge for Private」が含まれるようになりました。 Cloud」Cassandra ノードと ZooKeeper ノードを追加する方法、データセンターを データセンターにデプロイできます。

組織ツールの削除

orgtool は、 組織に関する情報を取得するためのエッジ インストール。このツールは削除されました。マイページ 次に、Edge UI または API 呼び出しを使用して、組織に関する情報を取得します。

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

次の表に、4.15.07.03 でタスクを実行した方法と、この時点から実行する方法を示します。 4.16.01 では、詳細については、Apigee の FTP サイトで入手できる Edge のオペレーション ガイドをご覧ください。 ftp://ftp.apigee.com/.

アルファ版リリース Monitoring ツールとダッシュボード

このリリースに含まれているのは、新しいモニタリング ツールとダッシュボードのアルファ版です。 。このツールを使用すると、さまざまなコンポーネント（ルーター、メッセージ、 プロセッサ、ZooKeeper、Cassandra など）と、さまざまな組織と環境の HTTP エラーコード 必要があります。ダッシュボード データのスナップショットを作成して、 サポート インシデントの解決を支援する Apigee。

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

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

エッジ プラットフォーム

管理 UI のサイズ変更（Cloud 15.09.30）

管理 UI の複数のページのデザインが更新されました。（MGMT-2627）

API サービス

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

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

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

新しい API プロキシ ウィザードの再設計の一環として、OpenAPI から API プロキシを作成できるようになりました。 （Swagger）ドキュメントをご覧ください。API プロキシ ウィザードの最初のページで、[Use OpenAPI（Reverse Proxy を選択した場合）、Node.js App、または No Target。表示されたフィールドに、 OpenAPI ドキュメントを作成します。詳細については、シンプルな 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 Callout、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 プロキシ 構成リファレンス
• <ph type="x-smartling-placeholder"></ph> 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

詳細については、<ph type="x-smartling-placeholder"></ph>をご覧ください。 JAR ファイルをキーストアにアップロードすると 証明書をトラストストアにアップロードするをご覧ください。（SECENG-516）、（APIRT-2213）

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

プロキシ エディタから Node.js ログを表示すると、[Node.js Logs] ページが自動的に表示されます。 ログは定期的に更新されます。[自動更新を停止] をクリックしますオフにする 自動更新されます。（MGMT-1692）

X-Forwarded-For HTTP ヘッダー（Cloud 15.09.30）

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

このデフォルトの動作を変更して、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）

組織管理者は、Google Cloud コンソールまたは [管理] >組織ユーザーと 名前の横にある [削除] をクリックします。（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 の環境構成部分。

すべてのキャッシュ リソースに存在する要素の合計（デフォルトのキャッシュを含む）は、 キャッシュに割り当てられたメモリの合計です。デフォルトでは、インメモリに割り当てられた合計メモリが ある Message Processor でのキャッシングが、使用可能な全メモリの 40% を占めます。要素は次のものになります: メモリ内キャッシュから強制排除されるのは、キャッシュ・メモリが不足している場合、または要素が期限切れとなった場合のみです。 （MGMT-2413、APIRT-1140）

管理 UI のターゲット サーバー構成（Cloud 15.07.22）

API >管理 UI の [Environment Configuration] ページで、 ターゲット サーバーを削除します。

また、ページのデザインが一新され、キャッシュの作成、追加、 インラインで削除した。キャッシュのプロパティには、 Elements in Memory」は、UI で使用できなくなりました。これらのプロパティの設定は、 ランタイムキャッシュ動作への影響は ありません（MGMT-280）

syslog へのメッセージ ロギングを使用した SSL（Cloud 15.07.22）

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

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

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

管理 UI（Cloud 15.07.22）

Apigee エンジニアリングは、管理におけるさまざまな軽微なバグの修正とユーザビリティの改善を行いました UI です。

Trace の cURL（Cloud 15.09.02）

ターゲット サーバーにリクエストを行う API プロキシ呼び出しをトレースする場合、 cURL コマンドとしてターゲット サーバーに送信します。[Request sent to target server] を選択します。ステージ クリックして [Show Curl] をクリックし、[Request sent to target] の サーバー"列をクリックします。（MGMT-2589）

データ マスキングの特殊文字（Cloud 15.09.02）

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

管理 UI の Key-Value マップ（Cloud 15.09.30）

Edge 管理で環境スコープの Key-Value マップ（KVM）を作成、管理できるようになりました UI です。環境スコープの KVM には、組織内の任意の API プロキシからアクセスできる Key-Value ペアが含まれます。 環境ごとに構成する必要があります管理 UI メニューで、[API] > 環境構成 >必要な環境を選択 >Key-Value マップ タブで確認できます。詳細については、作成と編集をご覧ください 環境 Key-Value マップをご覧ください。（MGMT-1393）

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

API プロキシ エディタで PopulateCache ポリシーを追加すると、<TimeoutInSec>要素 [キャッシュの有効期限] には、3600 秒（1 時間）の値が事前入力されます。以前の 300 秒（5 分）でした。（MGMT-2622）

デベロッパー サービス

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

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

[Developer Apps] ページの [Key] 列（Cloud 15.08.05）

多数のデベロッパー アプリがある組織では、[キー] 列が表示されている [Developer Apps] ページ（アプリごとのキーの数が表示されます）に表示されると、ディスプレイのパフォーマンスが低下することがあります。宛先 このような状況でディスプレイのパフォーマンスを改善するには、Apigee サポートに連絡して、以下の設定を行ってください。 組織レベルのプロパティ: features.appsNoCredentialsEnabled = true。この プロパティによって [キー] 列が削除されます。ただし、[キー] 列を削除すると コンシューマ キーとシークレットで検索できます。（MGMT-2486）

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

管理 UI で [デベロッパーの詳細] ページが読み込まれると、そのページの [Apps] セクション アプリがまだ読み込み中の場合は進行状況スピナーが表示されます。これにより、以前の動作が アプリの読み込み中に [Apps] セクションが空欄になっていました。（MGMT-2667）

収益化

API パッケージ名を編集する（Cloud 16.01.20）

API パッケージの名前は、収益化のライフサイクル中、いつでも更新できます。 API パッケージに公開されている料金プランが含まれている場合。（DEVRT-2177）。

カスタム属性で許容される小数（Cloud 16.01.20）

「カスタム属性を含むレート表」を使用する場合メッセージ内のカスタム属性に トランザクションの乗数として使用されるヘッダーを、最大 4 の 10 進数値にできるようになりました。 あります。このタイプのプランの詳細については、以下をご覧ください。 具体的に レート表カスタム属性の詳細（DEVRT-2191）。

概要レポートの料金プランの名前と ID（Cloud 15.09.02）

Management API を使用して収益の概要レポートを生成する際は、「料金プラン」を追加できます。名前 「プラン ID」を評価します追加できますそのためには、「RATEPLAN」を追加しますgroupBy 属性として API 呼び出しを実行します。詳しくは、 レポートをご覧ください。（この機能は、収益化レポート UI ではまだ使用できません）。イン 既存の料金プランの名前と ID の列が、 他のグループ列とともに表示されます（DEVRT-1740）

分析サービス

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

アナリティクスのカスタム レポートと API 呼び出しでは、集計関数が Target Response Time、Total Response Time、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）

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

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

管理 UI ダッシュボードの [Developer Apps] 棒グラフには、デベロッパー アプリが表示ごとに一覧表示されています。 名前で識別されます。（MGMT-2853）

カスタム レポートの新しい日付/時刻ウィジェット（Cloud 16.01.20）

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

GeoMap の都市のドリルダウン（Cloud 15.07.22）

分析用の GeoMap には「都市」と米国とカナダをドリルダウンできます。ユーザーが 地図上で都道府県をクリックすると、通話の発信元の都市のリストが表示されます。 （MGMT-2282）

|Analytics カスタム レポートでの（パイプ）および = 文字（Cloud 15.09.02）

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

プロキシパス サフィックスのディメンション（Cloud 15.09.30）

アナリティクスのカスタム レポートで、新しいプロキシパス サフィックス（proxy_pathsuffix）ディメンションが利用可能に API 呼び出しですプロキシパスの接尾辞は、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 リリース以降に修正されたバグを示します。宛先 これらの修正プログラムを入手するには、手順に沿って 4.16.01 を最新バージョンにアップデートしてください。 詳細については、Apigee Edge の更新で説明されている RPM とサポート ファイル。 4.16.01.x から最新の 4.16.01 リリースへ。

クラウド 16.01.20

クラウド 15.07.08

クラウド 15.07.22

クラウド 15.08.05

クラウド 15.09.02

クラウド 15.09.30

プライベート クラウド 4.15.07.03

プライベート クラウド 4.15.07.01

既知の問題

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

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