1.1.0 - Apigee ハイブリッド ランタイム リリースノート

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

2020 年 1 月 27 日、Google は Apigee ハイブリッド ランタイム バージョン 1.1.0 をリリースしました。このセクションでは、バージョン 1.1.0 でリリースされた新機能と変更について説明します。

アップグレード

1.0.0 から 1.1.0 へのアップグレードはできません。また、新しいバージョンはバージョン 1.0.0 と下位互換性がありません。バージョン 1.1.0 では新規インストールが必要です。

新機能と改善点

Apigee Connect（アルファ版リリース）

Apigee Connect アルファ版を使用すると、MART エンドポイントを公開しなくても、Apigee ハイブリッド MART サービスを管理プレーンに接続できます。Apigee Connect を使用する場合は、ホスト エイリアスと承認済み DNS 証明書を使用して MART Ingress ゲートウェイを構成する必要はありません。詳細については、Apigee の担当者にお問い合わせください。

ベースパスのルーティング

ベースパス ルーティングを使用すると、Apigee ハイブリッドが API プロキシコールを特定の環境に転送する方法を構成および管理できます。詳細については、ベースパス ルーティングの構成をご覧ください。

変更点

ハイブリッド ランタイム バージョン 1.1.0 に対して以下の変更が行われました。このような変更の一部は、既述のように、バージョン 1.0.0 との下位互換性はありません。

  • apigeectl CLI により Istio が istio-system 名前空間にインストールされるようになりました。これは Istio のデフォルトの名前空間です。この変更は、ハイブリッド バージョン 1.0.0 との下位非互換性になります。
  • apigeectl CLI により CertManager が cert-manager 名前空間にインストールされるようになりました。この変更は、ハイブリッド バージョン 1.0.0 との下位非互換性になります。
  • バージョン 1.2.x のサポートが終了しているため、Apigee ハイブリッド ランタイムでデプロイされるサポート対象の Istio バージョンは、1.4.2 に移行されています。

修正済みのバグ

Apigee ハイブリッド 1.0.0 のリリースノートに一覧表示されている以下の問題が修正されました。

問題 説明
144886537 Apigee ハイブリッド v1.0.0 で、ベースパス ルーティングが動作しません。同じホスト エイリアスを持つ異なる環境にルーティングするようにオーバーライドが設定されている場合、Ingress はパスに基づいて環境にルーティングしません。
143774187 ハイブリッド UI で、アプリビューに「Company」というラベルが表示されます。

既知の問題

このリリースの既知の問題を、次の表に示します。

問題 説明
なし mart と envs の両方の構成の hostAlias プロパティに「*」を使用することはできません。mart 構成には、特定のホスト名を使用することをおすすめします。
なし Apigee Connect アルファ版では、HTTP_PROXY、HTTPS_PROXY、NO_PROXY 変数の設定はサポートされていません。
なし

無効な HTTP ヘッダーエラー: Istio Ingress はすべての受信ターゲット レスポンスを HTTP2 プロトコルに切り替えます。ハイブリッド Message Processor は HTTP1 のみをサポートしているため、API プロキシの呼び出し時に次のエラーが発生することがあります。

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,
   name: [:authority], value: [domain_name]

このエラーが表示された場合は、次のいずれかの方法で問題を解決できます。

  • ターゲット サービスを変更して、レスポンスの Host ヘッダーを省略する。
  • 必要に応じて、API プロキシの AssignMessage ポリシーを使用して Host ヘッダーを削除する。
144584813 デバッグ セッションを作成してもセッションにトランザクションがまだない場合、List Debug Sessions API でのリストにセッションは含まれません。セッションに 1 つ以上のトランザクションが含まれている場合のみ、API はレスポンスにセッションを含みます。
144436206 キャッシュ パフォーマンス ビューで、キャッシュ ヒット率の計算が間違っています。
144321491 Apigee ハイブリッドでは、パフォーマンス低下の可能性を示す「Creating missing cache」通知をログに記録します。このメッセージは想定されたもので、無視できます。
144321144 安全な 仮想ホストを含むプロキシを再読み込みできません。
144286363

env.json のデバッグマスクがレスポンス データをマスキングしません。

responseJSONPaths フィールドで env.json デバッグマスクを更新する次の API は機能しません。

PATCH /v1/organizations/org/environments/env/debugmask?replaceRepeatedFields=true
{
  "responseJSONPaths": ["$.maskedDataEnv"]
}

トレースでこの問題を回避するには、UI でトレース セッション全体を削除するか、トレース API を使用してセッション内のトランザクションを個別に削除します。
143659917

PopulateCache ポリシーの有効期限には、1～30 の間の明示的な値を設定する必要があります。例:

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
133192879

概要: API または UI を使用して組織のデプロイ ステータスを取得すると、レイテンシが非常に長くなります。このレイテンシによって、HTTP 204 (No Content) または HTTP 400 (Bad Request) レスポンスが返される場合があります。

回避策: ブラウザを更新するか、リクエストを再送信してください。