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

Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメントに移動します。 情報

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

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

リリースの概要

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

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

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

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

非推奨になった機能と廃止された機能

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

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

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

廃止: デベロッパー サービス ポータルの buildInfo URL

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

http://yourportal.com/buildInfo

4.17.05 でこのリンクは削除されました。バージョンを確認するには、Drupal で [Reports > Status report] メニュー エントリを開きます。ポータルのバージョンは、[インストール プロファイル] という名前の行のテーブルに表示されます。

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

Apigee セキュア ストア（「Vault」とも呼ばれます）は非推奨となり、非推奨と廃止のページに示されている非推奨の発表日から 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 タイムアウト期間を指定して、UI が 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）

Router に Message Processor の再試行タイムアウトを追加しました

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

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

（APIRT-2912）

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

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

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

（DOS-4895）

ルート ユーザーと非ルート ユーザーの間で 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）

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

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

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

• SSL 終端はロードバランサで行われます
• ポート マッピングは、ロードバランサと Apigee ルーターの間で行われます。
• パスの書き換えで構成されたロードバランサ

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

<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 Callout、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（収益化）