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

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

2016 年 5 月 31 日（火）、Apigee Edge for Private Cloud の新しいバージョンをリリースしました。

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

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

新機能と拡張機能

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

詳細と手順については、Edge for Private Cloud のドキュメントをご覧ください。

インストール ガイドとオペレーション ガイドがオンラインに移行

Edge for Private Cloud のインストールと運用ガイド（バージョン 4.18.01）にアクセスできるようになりました。

ソフトウェア アップデート

このリリースには、次のソフトウェア アップデートが含まれています。

  • Java JDK 1.8 - 最新の Java 機能を活用するため、このリリースは Java 1.8 と互換性があります。環境に Oracle JDK 1.8 または OpenJDK 8 が必要です。
    Java 8 への更新の一環として、一部の TLS 暗号が Oracle JDK 1.8 で使用できなくなりました。完全なリストについては、http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html の「Default Disabled Cipher Suites」セクションをご覧ください。
  • Cassandra 2.1.13 - Cassandra 2.0.15 から更新されました。

インストール、アップグレード、ロールバック

インストール、アップグレード、関連スクリプトの変更点は次のとおりです。使用方法については、Edge for Private Cloud のドキュメントをご覧ください。

  • 4.16.01 から更新する新しいプロセス - このリリースでは、apigee-migrate ユーティリティが update.sh ユーティリティに置き換えられ、インストールを 4.16.01 から 4.16.05 に更新します。Apigee Edge 4.16.01 から 4.16.05 への更新をご覧ください。
  • Bootstrap
    • bootstrap.sh（バージョン 4.16.01）は、4.16.05 では bootstrap_4.16.05.sh になりました。
    • bootstrap_4.16.05.sh をダウンロードするために uname:pword を指定する必要がなくなりました。
  • ロールバック - 4.16.05 へのアップデートをロールバックするには、コンポーネントの 4.16.05 バージョンをアンインストールし、以前のバージョンを再インストールします。以前の rollback.sh ユーティリティが削除されました。4.16.05 ロールバック プロセスを参照してください。
  • setup.sh と update.sh はログファイルを /tmp に書き込むことができます - デフォルトでは、setup.sh ユーティリティと update.sh ユーティリティはログ情報を /opt/apigee/var/log/apigee-setup に書き込みます。ユーティリティを実行しているユーザーにこのディレクトリへのアクセス権がない場合は、/tmp ディレクトリにログが書き込まれます。ユーザーに /tmp へのアクセス権がない場合、ユーティリティは失敗します。
  • API BaaS の更新手順 - 4.16.01 リリースでは、API BaaS を移行するために再インストールする必要がありました。新しい update.sh ユーティリティは、API BaaS のインプレース更新をサポートしています。Apigee Edge 4.16.01 から 4.16.05 への更新をご覧ください。

管理

Private Cloud の管理と構成に関する新機能は次のとおりです。

  • インストール検証 - Edge Private Cloud インストールをテストするために使用される apigee-validate ユーティリティを、管理サーバーから実行できるようになりました。以前は、スクリプトを Message Processor で実行する必要がありました。インストールをテストするをご覧ください。
  • リージョン名 - リージョンには任意の名前を使用できます。以前のリリースでは、名前は「dc-#」の形式で、# は整数値でした。
  • Gateway Pod - Gateway Pod には任意の名前を付けることができます。以前のリリースでは、Pod の名前は「gateway」にする必要がありました。
  • スクリプトベースの管理 - 新しい apigee-adminapi.sh コマンドライン ユーティリティを使用すると、Edge Management API を呼び出して実行するのと同じ Edge 構成タスクを実行できます。apigee-adminapi.sh ユーティリティの使用をご覧ください。
  • 仮想ホストの SSL サイレント構成 - 組織または環境の作成時に、仮想ホストで SSL を構成するプロパティを渡せるようになりました。組織のオンボーディングを行うをご覧ください。

API サービス

以下は、以前のクラウド バージョンのプロダクトで提供された Edge API Services の新機能です。

Syslog メッセージ ロギングの固定長接頭辞（Cloud 16.03.30）

メッセージ ロギング ポリシーの Syslog 構成に新しい <FormatMessage> 要素が追加されました。<FormatMessage>true</FormatMessage> を設定すると、Syslog メッセージは一定の文字数で始まり、Apigee が挿入したデータをフィルタで除外できます。詳細については、メッセージ ロギング ポリシーをご覧ください。（APIRT-1398）

API プロキシのベースパスのワイルドカード（Cloud 16.03.09 UI）

管理 UI では、API プロキシのベースパスで 1 つ以上の /*/ ワイルドカードを使用できます。たとえば、ベースパスを /team/*/members にすると、新しいチームをサポートするために新しいプロキシを作成する必要なく、クライアントが https://[host]/team/blue/members または https://[host]/team/green/members を使用してプロキシを呼び出すことができます。/**/ は許可されていません。（MGMT-3154）

API プロキシのチェーン接続（Cloud 16.03.02、Cloud 16.03.09 UI）

Edge はローカル API プロキシ チェーンをサポートしています。これにより、追加のネットワーク オーバーヘッドなしで、ある API プロキシから Edge 組織にデプロイされた別の API プロキシを呼び出すことができます。以前は、API プロキシのチェーンで別の API プロキシへの http(s) 呼び出しが必要でした。この呼び出しにより、ロードバランサ、ルーター、メッセージ プロセッサを介してリクエストが転送されていました。

API プロキシの TargetEndpoint で新しい LocalTargetConnection 要素を使用できるようになりました。これにより、API プロキシ名、API プロキシ内の特定の ProxyEndpoint の名前、またはローカル API プロキシ リソース（/v1/myresource など）へのベースパスを指定できます。プロキシ エディタの UI には、TargetEndpoint を追加または更新するときにこれらのオプションも用意されています。

プロキシ チェーンは Service Callout ポリシーでも使用できます。

詳細については、チェーンによる API プロキシの接続をご覧ください。新しい LocalTargetConnection 要素は、XML スキーマ（https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd）にも記載されています。（MGMT-3049、MGMT-3050）

修正済みのバグ

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

Edge for Private Cloud 4.16.05

問題 ID 説明
PRC-770 16.01 インストーラが axgroup に Postgres スタンバイ サーバーを登録できない
PRC-758 ユーザーの役割を持つユーザーがカスタム レポートを編集できる
PRC-883 マスター / スタンバイ構成の Postgres サーバーの更新が失敗する

Cloud 16.03.30

問題 ID 説明
SECENG-584 証明書チェーン内の証明書間の改行の検証チェックにより、本番環境の一部の証明書で問題が発生する
MGMT-3217 KVMap 名が「keys」で終わる場合、管理 API 呼び出しが失敗する
MGMT-3214 JavaCallout の実行中にクラスの競合が発生し、お客様の Java コードが失敗する可能性がある
MGMT-3185 組織に組織管理者を追加する際にエラーが発生しました
EDGEUI-127 新しいプロキシ エディタで十分な権限を取得できない
EDGEUI-119 UI セッションのタイムアウトに関する問題
CORESERV-671 「No rings configured; Cannot initialize cps service」というエラーが表示される
AXAPP-2345 CPS 以外のお客様の AX カスタム レポートのリスト表示に関する問題
AXAPP-2302 Apigee Analytics の日次概要で、デベロッパーの導入数がゼロと表示される
APIRT-2750 特定の組織でトラフィック エラーが多い
APIRT-2516 JavaScript コールアウトのランタイム エラーで指定される行番号が正しくない
APIRT-2508 Vault コールバック内でエクスプレス リッスンを呼び出すとエラーで終了する
APIRT-2336 Node.js での Gzip の問題
APIRT-1975 message.content でマスク構成が機能しない

Cloud 16.03.16 UI

問題 ID 説明
MGMT-3142 エラー分析ダッシュボードでグラフが読み込まれない（修正を更新）

Cloud 16.03.09 UI

問題 ID 説明
MGMT-3158 個々のプロキシの RBAC が API を介して設定されている場合、UI で権限が不足している
MGMT-3142 Error Analysis ダッシュボードでグラフが読み込まれない
MGMT-3118 UI に「clientAuthEnabled」パラメータの SSL 仮想ホスト構成が正しく表示されない
DEVRT-2344 1 日のレポート定義で UI にトランザクションが読み込まれない

Cloud 16.03.02

問題 ID 説明
MGMT-3083 Node.js ログの自動更新でログメッセージが多すぎる
DEVRT-2275 カスタム属性の料金プランで、許可されている 10 個ではなく 5 個の属性のみが表示される
DEVRT-1275 [レートプラン] プルダウン メニューにすべてのデベロッパーが表示されない
DEVRT-1074 残高がゼロの前払いデベロッパーにクレジットが適用されると NullpointerException がスローされる

Cloud 16.02.17

問題 ID 説明
MGMT-3083 Node.js ログの自動更新でログメッセージが多すぎる
MGMT-3077 UI がデフォルトの Namespace を使用する WSDL から無効なプロキシ バンドルを生成する
MGMT-1642 カスタム ユーザーロールにデベロッパー アプリの「get」権限がない

既知の問題

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

問題 ID 説明
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
APIRT-3364

Message Processor が IPv4 と IPv6 で DNS ルックアップを行う

NSCD（ネームサービス キャッシュ デーモン）をインストールして有効にしている場合、Message Processor によって、DNS ルックアップが 2 回（IPv4 と IPv6 について 1 回ずつ）行われることがあります。

IPv6 の DNS ルックアップを無効にするには:

  1. すべての Message Processor ノードで、/etc/nscd.conf を編集します。
  2. 次のプロパティを設定します。

    enable-cache hosts no
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
DOC-1687 パッケージの依存関係の競合が原因で、Satellite Server 6 で使用される Katello エージェントは、Qpid デーモンを実行している Apigee Edge ホストに正しくインストールされません。

Assign Message、Java Callout、Raise Fault ポリシーの JSON ペイロード

Assign Message、Java Callout、Raise Fault の各ポリシーでは、<Set><Payload> 要素を使用してメッセージ コンテンツを生成できます。これらのメッセージの一部として、実行時に値が自動的に入力される変数を含めることができます。たとえば、HTTP ヘッダーから日付を出力する場合は、メッセージに {message.header.date} を挿入します。

メッセージ形式が JSON の場合、次のようになります。

{"The date is: " : "{message.header.date}"}

ただし、これは形式が正しくない JSON です。この問題を回避するには、次の 2 つの方法があります。

  • 開始の中かっこをバックスラッシュでエスケープします。
    \{"The date is: " : "{message.header.date}"}
  • ペイロード要素の構成で、variablePrefix 属性と variableSuffix 属性を使用して JSON ペイロードの変数を示します。例:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

次の Edge for Private Cloud 機能リリースでは、JSON メッセージの変数に中かっこを問題なく使用できるようになります。（APIRT-1160）

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
前へ
4.16.05.01
次へ
4.16.01.08