Apigee ハイブリッドで大規模なメッセージ ペイロードのサポートを構成する

概要

Apigee ハイブリッドでは、最大 30 MB の大規模なメッセージ ペイロードがサポートされています。デフォルトのメッセージ ペイロード サイズは 10 MB です。メッセージ ペイロードのサイズをご覧ください。

ハイブリッド インストールの環境で大規模なメッセージ ペイロードをサポートするには、ランタイム構成を次のように変更する必要があります。

  • ヒープサイズを 4 Gi に増やします。
  • メモリ上限を 6 Gi に増やします。
  • メモリリソースのリクエストを 4 Gi に増やします。

これらの設定は、個々の環境またはインストール内のすべての環境に対して構成できます。

大規模なメッセージ ペイロードをサポートするように個々の環境を構成する

大規模なメッセージ ペイロードをサポートするように構成されたプロキシのエンドポイントがインストール内の 1 つまたは少数の環境のみにある場合は、大規模なペイロードをサポートするように環境を構成できます。これにより、大規模なペイロードをサポートする必要がない環境にメモリを追加しなくて済みます。

大規模なメッセージ ペイロードをサポートするように個々の環境を構成するには、envs.components.runtime プロパティを使用します。overrides.yaml ファイルに次の変更を加えます。

  1. 次のスタンザを overrides.yaml ファイルに追加します。
    envs:
- name: ENV_NAME
  components.
    runtime:
      cwcAppend:
        bin_setenv_max_mem: 4096m   # Increase max heap size to 4 gigs
      resources:
        requests:
          memory: 4Gi
        limits:
          memory: 6Gi

    詳しくは、以下を参照してください。

  2. 更新する各環境の apigee-env チャートをアップグレードします。

    ドライランを実行します。

    helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE \
  --dry-run=server
    • ENV_RELEASE_NAME は、apigee-env チャートのインストールとアップグレードの追跡に使用する名前です。この名前は、インストール内の他の Helm リリース名と重複していない必要があります。通常、これは ENV_NAME と同じにします。ただし、環境と環境グループの名前が同じである場合は、環境と環境グループに対して異なるリリース名（dev-env-release と dev-envgroup-release など）を使用する必要があります。Helm のリリースの詳細については、Helm ドキュメントの 3 つの大きなコンセプト class="external" をご覧ください。
    • ENV_NAME はアップグレードする環境の名前です。
    • OVERRIDES_FILE は、編集した overrides.yaml ファイルです。
  3. チャートをアップグレードします。

    ドライランを実行します。

    helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE

大規模なメッセージ ペイロードをサポートするようにすべての環境を構成する

runtime スタンザを変更すると、インストール内のすべての環境にヒープとメモリの上限が設定されます。envs.components.runtime プロパティを使用して、個々の環境でこれらの設定をオーバーライドできます。

  1. 次のスタンザを overrides.yaml ファイルに追加します。
    runtime:
  cwcAppend:
    bin_setenv_max_mem: 4096m   # Increase max heap size to 4 gigs
  resources:
    requests:
      memory: 4Gi
    limits:
      memory: 6Gi

    詳しくは、以下を参照してください。

  2. インストール内の各環境の apigee-env チャートをアップグレードします。

    ドライランを実行します。

    helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE \
  --dry-run=server

    チャートをアップグレードします。

    helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace APIGEE_NAMESPACE \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE