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

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご覧ください。 info

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

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

リリースの概要

このリリースには、API の制御と保護を強化するのに役立つ次のような注目すべき機能が多数含まれています。

• 共有フローはゼロ ダウンタイム デプロイをサポートしています。
• 組織の収益化データの削除がサポートされるようになりました。
• その他の新機能については、以下をご覧ください。

非推奨の面では、Vault が非推奨になりました。

このトピックの残りの部分では、このリリースに含まれるすべての新機能、アップデート、バグの修正について詳しく説明します。

非推奨と廃止

このリリースでは、次の機能が非推奨または廃止になりました。詳しくは、Edge のサポート終了ポリシーをご覧ください。

廃止: API プロキシの [パフォーマンス] タブでのパスの追加

このリリースまでは、管理 UI で API プロキシに移動し、[Performance] タブに移動して、プロキシの [Performance] タブと [Business Transactions] ダッシュボードでグラフベースの比較を行うためのさまざまなパスを作成できました。この機能は廃止され、UI で使用できなくなりました。この機能の代替については、Apigee コミュニティの記事 Alternative to Business Transactions API をご覧ください。（EDGEUI-902）

廃止: Developer Services ポータルの buildInfo URL

以前のバージョンのポータルでは、ポータルのバージョンを確認するために、ブラウザで次の URL を開いていました。

http://yourportal.com/buildInfo

4.17.05 では、このリンクは削除されています。バージョンを確認するには、Drupal のメニューから [Reports] > [Status report] の順に開きます。表の [Install profile] という行にポータルのバージョンが示されています。

Apigee セキュアストア（Vault）の非推奨

Vault とも呼ばれる Apigee セキュアストアは非推奨となり、非推奨と廃止のページに記載されている非推奨の発表日から 1 年後に廃止されます。Key-Value ペアの暗号化されたストレージを提供する Vault は、管理 API で作成され、実行時に apigee-access Node.js モジュールの関数でアクセスされます。

セキュアストアを使用する代わりに、Key-Value マップの操作で説明されているように、暗号化された Key-Value マップ（KVM）を使用します。暗号化された KVM は Vault と同じくらい安全で、作成と取得のオプションが豊富です。（MGMT-3848）

新機能とアップデート

このリリースにおける新機能と改善点は次のとおりです。このリリースには、次の機能強化に加えて、ユーザビリティ、パフォーマンス、セキュリティ、安定性に関する複数の機能強化も含まれています。

プライベート クラウド

インストールに新しい必須の SMTP 構成パラメータを追加

Edge インストール構成ファイルで SMTPMAILFROM パラメータを使用する必要があります。このパラメータは、ユーザーがパスワードの再設定をリクエストしたときなど、Edge が自動メールを送信するときに使用されるメールアドレスを指定します。詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。

（EDGEUI-1020）

Edge UI が Edge API 管理呼び出しで使用するタイムアウトを設定できるようになりました

Edge UI が API 管理呼び出しの戻りを待機する時間を制御するために使用する API タイムアウト期間を指定できるようになりました。次のプロパティでタイムアウトを定義します。

• conf_apigee_apigee.feature.apitimeout は、UI がバックエンドへの呼び出しの戻りを待機する時間を秒単位で設定します。この時間は、UI でのアクティビティに関係なく適用されます。この時間内に呼び出しが完了しない場合、UI はタイムアウト エラーをスローします。デフォルト値は 180 秒（3 分）です。
• conf_apigee_play.ws.timeout.idle は、UI がサーバーでのアクティビティを待機する時間をミリ秒単位で設定します。conf_apigee_apigee_apitimeout と同じ値に設定することも、それより小さい値に設定することもできます。これより大きい値を設定しても効果はありません。デフォルトは 180,000 ミリ秒（3 分）です。
• conf_apigee_play.ws.timeout.connection は、UI が接続の確立を待つ時間を設定します。conf_apigee_apigee_apitimeout と同じ値に設定することも、それより小さい値に設定することもできます。これより大きい値を設定しても効果はありません。デフォルトは 120,000 ミリ秒（2 分）です。

詳細については、Edge UI が Edge API 管理呼び出しで使用するタイムアウトを設定するをご覧ください。

（EDGEUI-816）

ルーターに Message Processor の再試行タイムアウトを追加

タイムアウトを追加し、Router が Message Processor へのリクエストの再試行を停止してエラー メッセージを返すようにしました。

詳細については、Message Processor への接続を再試行するように Router を構成するをご覧ください。

（APIRT-2912）

デフォルトのシステム管理者を変更する手順を追加しました

デフォルトのシステム管理者を変更するためのドキュメントが追加されました。

詳細については、ユーザー、ロール、権限の管理をご覧ください。

（DOS-4895）

root ユーザーと root 以外のユーザーの Edge インストール タスクの分離に関するドキュメントを追加

新しいドキュメントでは、root ユーザーと root 以外のユーザーの Edge インストール タスクを分離する手順について説明します。

詳細については、Edge のインストールの概要をご覧ください。

（DOS-4573）

生成されたメールのリンクのホスト名を設定するプロパティを追加しました

Edge では、ユーザーが組織に追加されたときなど、特定のイベントが発生すると自動的にメールが送信されます。こうしたメールの多くには、リンクが記載されます。たとえば、新しいユーザーが組織に追加されると、Edge UI はそのユーザーに、次の形式のログイン URL を記載したメールを送信します。

https://domain/login

ドメインは Edge によって自動的に決定されます。通常、このように自動決定されたドメインは、組織に適切なものです。 ただし、Edge UI がロードバランサの背後にある場合、自動的に生成されたドメイン名が誤っている可能性があります。その場合は、conf_apigee_apigee.emails.hosturl プロパティを使用して、生成された URL のドメイン名の部分を明示的に設定できます。

詳細については、生成されたメールのリンクのホスト名を設定するをご覧ください。

（EDGEUI-1044）

Edge UI に表示される API プロキシのベース URL の設定

Edge UI に表示される API プロキシの URL は、プロキシがデプロイされた場所に対応する仮想ホストの設定に基づきます。この表示に仮想ホストの Router ポート番号を含めることができます。

ほとんどの場合、Edge UI に表示される URL は、プロキシへの外部リクエストを行うための正しい URL です。しかし、一部の構成では正しくない URL が表示されます。たとえば、次のいずれかの構成では、表示される URL が、プロキシへの外部リクエストに使用される実際の URL に対応しないことがあります。

• ロードバランサで SSL が終端する
• ロードバランサと Apigee Router の間でポート マッピングが行われる
• ロードバランサでパスの書き換えが構成されている

Edge for Private Cloud 4.17.05 以降では、<BaseUrl> という仮想ホストの属性がサポートされています。この属性を使用すると、Edge UI に表示される URL をオーバーライドできます。新しい <BaseURL> 属性を指定した仮想ホスト オブジェクトの例を次に示します。この例では、値「http://myCo.com」が Edge UI に表示されます。

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

<BaseUrl> を設定しない場合、Edge UI でレンダリングされるデフォルトの URL は「http://DNS_name_or_IP:9005/」として表示されますが、実際のホスト エイリアスの設定は「http://myCo.com」です。

apigee-provision ユーティリティで VHOST_BASEURL プロパティを使用して、組織の作成時にベース URL を設定することもできます。

詳細については、Private Cloud 用 API への TLS アクセスの構成をご覧ください。

（EDGEUI-5008）

デバッグ ロギングの有効化に関するドキュメントを追加しました

Edge コンポーネントのデバッグ ロギングを有効または無効にする方法を説明するドキュメントが追加されました。

詳しくは、デバッグ ロギングを有効にするをご覧ください。

（APIRT-4018）

apigee-analytics-collector ユーティリティの新しいインストーラとコマンド構文

すべての Edge for Private Cloud のお客様は、apigee-analytics-collector コマンドライン ユーティリティのベータ版を使用して、API プロキシのトラフィックに関する統計情報を Apigee に提供していただく必要があります。このユーティリティは、API 呼び出しのボリューム レポートを Apigee に送り返します。

このリリースの Edge には、apigee-analytics-collector ユーティリティの新しいインストール手順とコマンド構文が含まれています。このリリースでは、npm の代わりに apigee-service を使用して apigee-analytics-collector ユーティリティをインストールし、スタンドアロン コマンドとしてではなく apigee-service を使用して apigee-analytics-collector ユーティリティを呼び出すようになりました。

詳細については、Apigee への API トラフィック データのアップロード - ベータ版リリースをご覧ください。

新しい 4.17.01 インストールからの Nginx/Postgres の Developer Services ポータル アップデート後の新しいデフォルト インストール ディレクトリ

Nginx/Postgres を使用する 4.17.01 の新規インストールを更新すると、ルート ディレクトリが変更されます。変更前のディレクトリは以下のとおりです。

/opt/apigee/apigee-drupal

これを、次のように変更します。

/opt/apigee/apigee-drupal/wwwroot

API サービス

エンティティの入力検証の強化

Apigee Edge 組織のすべてのエンティティで、より厳格な入力検証が適用されました。通常、使用できる文字は英字（大文字と小文字）、数字、アンダースコアです。

影響を受けるエンティティは次のとおりです。

• 組織
• 環境
• API プロキシ
• API プロキシ リビジョン
• API プロキシのポリシー名
• デバッグ トレース マスク構成 ID
• リソース名（Java コールアウト、xsl、すべてのリソース）
• キーストア
• CRLstores
• リソース参照
• ターゲット サーバー

（MGMT-3840）

共有フローのゼロ ダウンタイム デプロイ

共有フローをデプロイし、デプロイ中に拒否される受信トラフィックを最小限に抑えるには、ゼロダウンタイム デプロイ管理 API を使用します。このプロセスは、管理 API を使用した API プロキシのゼロダウンタイム デプロイとほぼ同じです。唯一の違いは、管理 API リソースです。

次の呼び出しは、URI で指定された共有フロー リビジョンをデプロイし、以前にデプロイされたリビジョンをデプロイ解除します（override=true クエリ パラメータでこれが有効になります）。

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

（MGMT-3485）

収益化

組織の収益化データを削除する

次のようなシナリオでは、組織の収益化データを削除することをおすすめします。

• 組織を削除します。この場合、組織を削除する前に収益化データを削除する必要があります。
• 再利用するテスト組織から収益化データを削除します。この場合は、収益化データを削除した後に Apigee Edge データを同期する必要があります。

詳しくは、組織から収益化データを削除するをご覧ください。（DEVRT-2581）

組織の収益化を有効にする API を追加しました

API を使用して組織の収益化を有効にできるようになりました。

詳細については、組織で収益化を有効にするをご覧ください。

（DEVRT-2383）

修正済みのバグ

このリリースでは以下のバグが修正されています。このリストは、サポート チケットの修正状況を確認するユーザーを対象としています。すべてのユーザーに詳細情報を提供することを目的としたものではありません。

Private Cloud 4.17.05

Cloud 17.04.12（UI）

Cloud 17.04.05（UI）

Cloud 17.03.29（UI）

Cloud 17.03.15.01（UI）

Cloud 17.03.15（UI）

Cloud 17.03.13.02（収益化）

Cloud 17.03.13.01（収益化）

Cloud 17.03.13（API 管理）

Cloud 17.03.1（UI）

Cloud 17.02.15（UI）

Cloud 17.02.13（API ランタイム）

Cloud 17.02.13（API 管理）

Cloud 17.01.18（UI）

Cloud 17.01.16（API 管理）

Cloud 17.01.16（収益化）