在 Apigee Hybrid 中設定大型訊息酬載支援功能

總覽

Apigee Hybrid 支援最大 30 MB 的訊息酬載。預設訊息有效負載大小為 10 MB。請參閱「訊息酬載大小」。

如要在混合式安裝環境中啟用環境，以支援大型訊息酬載，您必須對執行階段設定進行下列變更：

  • 將堆積大小增加至 4Gi。
  • 將記憶體上限提高至 6Gi。
  • 將記憶體資源要求提高至 4Gi。

您可以為個別環境或安裝中的所有環境設定這些設定。

設定個別環境，支援大型訊息酬載

如果設定為支援大型訊息酬載的 Proxy 在安裝作業中只有一或多個環境的端點，您可以設定環境來支援大型酬載。這樣可避免在不需要支援大型酬載的環境中新增額外記憶體。

如要設定個別環境來支援大型訊息酬載，可以使用 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 說明文件中的「Three big concepts 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