Apigee hybrid supporta payload di messaggi di grandi dimensioni fino a 30 MB. La dimensione predefinita del payload del messaggio è 10 MB. Vedi Dimensioni del payload del messaggio.
Per consentire agli ambienti nell'installazione ibrida di supportare payload di messaggi di grandi dimensioni, devi apportare le seguenti modifiche alla configurazione di runtime:
Aumenta la dimensione dell'heap ad almeno 4 Gi.
Aumenta i limiti di memoria ad almeno 6 Gi.
Aumenta le richieste di risorse di memoria ad almeno 4 Gi.
Puoi configurare queste impostazioni per singoli ambienti o per tutti gli ambienti dell'installazione.
Configurare singoli ambienti per supportare payload di messaggi di grandi dimensioni
Se i proxy configurati per supportare payload di messaggi di grandi dimensioni hanno endpoint in uno o pochi ambienti dell'installazione, puoi configurare gli ambienti per supportare payload di grandi dimensioni. In questo modo si evita di aggiungere memoria aggiuntiva agli ambienti che non dovranno supportare payload di grandi dimensioni.
Per configurare singoli ambienti in modo che supportino payload di messaggi di grandi dimensioni, puoi utilizzare le proprietà envs.components.runtime. Apporta le seguenti modifiche al file overrides.yaml:
Aggiungi la seguente stanza al file overrides.yaml:
ENV_RELEASE_NAME è un nome utilizzato per tenere traccia dell'installazione e degli upgrade del grafico apigee-env. Questo nome deve essere univoco rispetto agli altri nomi delle release Helm nell'installazione.
Di solito è uguale a ENV_NAME. Tuttavia, se il tuo ambiente ha lo stesso nome
del tuo gruppo di ambienti, devi utilizzare nomi di release diversi per l'ambiente e il gruppo di ambienti,
ad esempio dev-env-release e dev-envgroup-release. Per ulteriori informazioni sulle release
in Helm, consulta Three big concepts class="external" nella
documentazione di Helm.
ENV_NAME è il nome dell'ambiente che stai eseguendo l'upgrade.
OVERRIDES_FILE è il file overrides.yaml modificato.
Configura tutti gli ambienti in modo che supportino payload di messaggi di grandi dimensioni
Le modifiche alla sezione runtime imposteranno i limiti di heap e memoria per tutti gli ambienti dell'installazione. Puoi eseguire l'override di queste impostazioni per singoli ambienti con le proprietà envs.components.runtime.
Aggiungi la seguente stanza al file overrides.yaml:
runtime:
cwcAppend:
bin_setenv_max_mem: 4096m # Increase max heap size to 4 gigs
resources:
requests:
memory: 4Gi
limits:
memory: 6Gi
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-10 UTC."],[],[],null,["# Configure large message payload support in Apigee hybrid\n\nOverview\n--------\n\n\nApigee hybrid supports large message payloads up to 30MB. The default message payload size is 10MB. See [Message payload size](/apigee/docs/api-platform/fundamentals/best-practices-api-proxy-design-and-development#size).\n\n\nTo enable environments in your hybrid installation to support large message payloads, you need to make the following changes to your runtime configuration:\n\n- Increase the heap size to at least 4Gi.\n- Increase memory limits to at least 6Gi.\n- Increase memory resource requests to at least 4Gi.\n\n| **Note:** Resources for memory depend on how much head room exists on your nodes.\n\nYou can configure these settings for individual environments or for all environments in your installation.\n\nConfigure individual environments to support large message payloads\n-------------------------------------------------------------------\n\n\nIf the proxies configured to support large message payloads have endpoints in only one or a few environments in your installation, you can configure the environments to support large payloads. This avoids adding additional memory to environments that will not need to support large payloads.\n\n\nTo configure individual environments to support large message payloads, you can use the `envs.components.runtime` properties. Make the following changes to your `overrides.yaml` file:\n\n1. Add the following stanza to your `overrides.yaml` file: \n\n ```\n envs:\n - name: ENV_NAME\n components.\n runtime:\n cwcAppend:\n bin_setenv_max_mem: 4096m # Increase max heap size to 4 gigs\n resources:\n requests:\n memory: 4Gi\n limits:\n memory: 6Gi\n ```\n | **Important:** You must set values for both [`envs.components.runtime.resources.limits.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#envs-comoponents-runtime-resources-limits-memory) and [`envs[].components.runtime.resources.requests.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#envs-comoponents-runtime-resources-requests-memory) for this environment. Setting either of the properties for this environment causes Apigee not to use the values of:\n | - [`runtime.resources.limits.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#runtime-resources-limits-memory)\n | - [`runtime.resources.requests.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#runtime-resources-requests-memory)\n\n See:\n - [`envs.components.runtime.resources.limits.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#envs-comoponents-runtime-resources-limits-memory)\n - [`envs.components.runtime.resources.requests.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#envs-comoponents-runtime-resources-requests-memory)\n2. Upgrade the `apigee-env` chart for each environment you are updating:\n\n Dry run: \n\n ```\n helm upgrade ENV_RELEASE_NAME apigee-env/ \\\n --install \\\n --namespace APIGEE_NAMESPACE \\\n --set env=ENV_NAME \\\n -f OVERRIDES_FILE \\\n --dry-run=server\n ```\n - \u003cvar translate=\"no\"\u003eENV_RELEASE_NAME\u003c/var\u003e is a name used to keep track of installation and upgrades of the `apigee-env` chart. This name must be unique from the other Helm release names in your installation. Usually this is the same as \u003cvar translate=\"no\"\u003eENV_NAME\u003c/var\u003e. However, if your environment has the same name as your environment group, you must use different release names for the environment and environment group, for example `dev-env-release` and `dev-envgroup-release`. For more information on releases in Helm, see [Three big concepts class=\"external\"](https://helm.sh/docs/intro/using_helm/#three-big-concepts) in the Helm documentation.\n - \u003cvar translate=\"no\"\u003eENV_NAME\u003c/var\u003e is the name of the environment you are upgrading.\n - \u003cvar translate=\"no\"\u003eOVERRIDES_FILE\u003c/var\u003e is your edited `overrides.yaml` file.\n3. Upgrade the chart: Dry run:\n\n ```\n helm upgrade ENV_RELEASE_NAME apigee-env/ \\\n --install \\\n --namespace APIGEE_NAMESPACE \\\n --set env=ENV_NAME \\\n -f OVERRIDES_FILE\n ```\n\nConfigure all environments to support large message payloads\n------------------------------------------------------------\n\n\nChanges to your `runtime` stanza will set the heap and memory limits for all environments in your installation. You can override these settings for individual environments with the `envs.components.runtime` properties.\n\n1. Add the following stanza to your `overrides.yaml` file: \n\n ```\n runtime:\n cwcAppend:\n bin_setenv_max_mem: 4096m # Increase max heap size to 4 gigs\n resources:\n requests:\n memory: 4Gi\n limits:\n memory: 6Gi\n ```\n\n See:\n - [`runtime.resources.limits.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#runtime-resources-limits-memory)\n - [`runtime.resources.requests.memory`](/apigee/docs/hybrid/v1.15/config-prop-ref#runtime-resources-requests-memory)\n2. Upgrade the `apigee-env` chart for each environment in your installation:\n\n Dry run: \n\n ```\n helm upgrade ENV_RELEASE_NAME apigee-env/ \\\n --install \\\n --namespace APIGEE_NAMESPACE \\\n --set env=ENV_NAME \\\n -f OVERRIDES_FILE \\\n --dry-run=server\n ```\n\n Upgrade the chart: \n\n ```\n helm upgrade ENV_RELEASE_NAME apigee-env/ \\\n --install \\\n --namespace APIGEE_NAMESPACE \\\n --set env=ENV_NAME \\\n -f OVERRIDES_FILE\n ```"]]
